libtun 0.1.0

a cross-platform(macosx, linux) tunnel library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

/*
 * Since the rust ioctl bindings don't have all the structures and constants,
 * it's easier to just write the thing in C and link it in.
 */

#include <assert.h>
#include <stdint.h>
#include <string.h>

#include <sys/socket.h>
#include <linux/if.h>
#include <linux/if_tun.h>
#include <sys/ioctl.h>

/**
 * fd ‒ the fd to turn into TUN or TAP.
 * name ‒ the name to use. If empty, kernel will assign something by itself.
 *   Must be buffer with capacity at least 33.
 * mode ‒ 1 = TUN, 2 = TAP.
 * packet_info ‒ if packet info should be provided, if the given value is 0 it will not prepend packet info.
 */
int tuntap_setup(int fd, unsigned char *name, int mode, int packet_info) {
    struct ifreq ifr;
    memset(&ifr, 0, sizeof ifr);
    switch (mode) {
        case 1:
            ifr.ifr_flags = IFF_TUN;
            break;
        case 2:
            ifr.ifr_flags = IFF_TAP;
            break;
        default:
            assert(0);
    }

    // If no packet info needs to be provided add corresponding flag
    if (!packet_info) {
        ifr.ifr_flags |= IFF_NO_PI;
    }

    // Leave one for terminating '\0'. No idea if it is needed, didn't find
    // it in the docs, but assuming the worst.
    strncpy(ifr.ifr_name, (char *)name, IFNAMSIZ - 1);

    int ioresult = ioctl(fd, TUNSETIFF, &ifr);
    if (ioresult < 0) {
        return ioresult;
    }
    strncpy((char *)name, ifr.ifr_name, IFNAMSIZ < 32 ? IFNAMSIZ : 32);
    name[32] = '\0';
    return 0;
}