2 * iptunnel.c "ip tuntap"
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version
7 * 2 of the License, or (at your option) any later version.
9 * Authors: David Woodhouse <David.Woodhouse@intel.com>
17 #include <sys/types.h>
18 #include <sys/socket.h>
19 #include <arpa/inet.h>
20 #include <sys/ioctl.h>
22 #include <linux/if_tun.h>
23 #include <linux/if_arp.h>
33 #include "ip_common.h"
35 static const char drv_name
[] = "tun";
37 #define TUNDEV "/dev/net/tun"
39 static void usage(void) __attribute__((noreturn
));
41 static void usage(void)
44 "Usage: ip tuntap { add | del | show | list | lst | help } [ dev PHYS_DEV ]\n"
45 " [ mode { tun | tap } ] [ user USER ] [ group GROUP ]\n"
46 " [ one_queue ] [ pi ] [ vnet_hdr ] [ multi_queue ] [ name NAME ]\n"
48 "Where: USER := { STRING | NUMBER }\n"
49 " GROUP := { STRING | NUMBER }\n");
53 static int tap_add_ioctl(struct ifreq
*ifr
, uid_t uid
, gid_t gid
)
59 ifr
->ifr_flags
|= IFF_TUN_EXCL
;
62 fd
= open(TUNDEV
, O_RDWR
);
67 if (ioctl(fd
, TUNSETIFF
, ifr
)) {
68 perror("ioctl(TUNSETIFF)");
71 if (uid
!= -1 && ioctl(fd
, TUNSETOWNER
, uid
)) {
72 perror("ioctl(TUNSETOWNER)");
75 if (gid
!= -1 && ioctl(fd
, TUNSETGROUP
, gid
)) {
76 perror("ioctl(TUNSETGROUP)");
79 if (ioctl(fd
, TUNSETPERSIST
, 1)) {
80 perror("ioctl(TUNSETPERSIST)");
89 static int tap_del_ioctl(struct ifreq
*ifr
)
91 int fd
= open(TUNDEV
, O_RDWR
);
98 if (ioctl(fd
, TUNSETIFF
, ifr
)) {
99 perror("ioctl(TUNSETIFF)");
102 if (ioctl(fd
, TUNSETPERSIST
, 0)) {
103 perror("ioctl(TUNSETPERSIST)");
112 static int parse_args(int argc
, char **argv
,
113 struct ifreq
*ifr
, uid_t
*uid
, gid_t
*gid
)
117 memset(ifr
, 0, sizeof(*ifr
));
119 ifr
->ifr_flags
|= IFF_NO_PI
;
122 if (matches(*argv
, "mode") == 0) {
124 if (matches(*argv
, "tun") == 0) {
125 if (ifr
->ifr_flags
& IFF_TAP
) {
126 fprintf(stderr
, "You managed to ask for more than one tunnel mode.\n");
129 ifr
->ifr_flags
|= IFF_TUN
;
130 } else if (matches(*argv
, "tap") == 0) {
131 if (ifr
->ifr_flags
& IFF_TUN
) {
132 fprintf(stderr
, "You managed to ask for more than one tunnel mode.\n");
135 ifr
->ifr_flags
|= IFF_TAP
;
137 fprintf(stderr
, "Unknown tunnel mode \"%s\"\n", *argv
);
140 } else if (uid
&& matches(*argv
, "user") == 0) {
145 if (**argv
&& ((user
= strtol(*argv
, &end
, 10)), !*end
))
148 struct passwd
*pw
= getpwnam(*argv
);
151 fprintf(stderr
, "invalid user \"%s\"\n", *argv
);
156 } else if (gid
&& matches(*argv
, "group") == 0) {
162 if (**argv
&& ((group
= strtol(*argv
, &end
, 10)), !*end
))
165 struct group
*gr
= getgrnam(*argv
);
168 fprintf(stderr
, "invalid group \"%s\"\n", *argv
);
173 } else if (matches(*argv
, "pi") == 0) {
174 ifr
->ifr_flags
&= ~IFF_NO_PI
;
175 } else if (matches(*argv
, "one_queue") == 0) {
176 ifr
->ifr_flags
|= IFF_ONE_QUEUE
;
177 } else if (matches(*argv
, "vnet_hdr") == 0) {
178 ifr
->ifr_flags
|= IFF_VNET_HDR
;
179 } else if (matches(*argv
, "multi_queue") == 0) {
180 ifr
->ifr_flags
|= IFF_MULTI_QUEUE
;
181 } else if (matches(*argv
, "dev") == 0) {
183 if (get_ifname(ifr
->ifr_name
, *argv
))
184 invarg("\"dev\" not a valid ifname", *argv
);
186 if (matches(*argv
, "name") == 0) {
188 } else if (matches(*argv
, "help") == 0)
190 if (ifr
->ifr_name
[0])
191 duparg2("name", *argv
);
192 if (get_ifname(ifr
->ifr_name
, *argv
))
193 invarg("\"name\" not a valid ifname", *argv
);
199 if (!(ifr
->ifr_flags
& TUN_TYPE_MASK
)) {
200 fprintf(stderr
, "You failed to specify a tunnel mode\n");
208 static int do_add(int argc
, char **argv
)
214 if (parse_args(argc
, argv
, &ifr
, &uid
, &gid
) < 0)
217 return tap_add_ioctl(&ifr
, uid
, gid
);
220 static int do_del(int argc
, char **argv
)
224 if (parse_args(argc
, argv
, &ifr
, NULL
, NULL
) < 0)
227 return tap_del_ioctl(&ifr
);
230 static void print_flags(long flags
)
232 open_json_array(PRINT_JSON
, "flags");
235 print_string(PRINT_ANY
, NULL
, " %s", "tun");
238 print_string(PRINT_ANY
, NULL
, " %s", "tap");
240 if (!(flags
& IFF_NO_PI
))
241 print_string(PRINT_ANY
, NULL
, " %s", "pi");
243 if (flags
& IFF_ONE_QUEUE
)
244 print_string(PRINT_ANY
, NULL
, " %s", "one_queue");
246 if (flags
& IFF_VNET_HDR
)
247 print_string(PRINT_ANY
, NULL
, " %s", "vnet_hdr");
249 if (flags
& IFF_PERSIST
)
250 print_string(PRINT_ANY
, NULL
, " %s", "persist");
252 if (!(flags
& IFF_NOFILTER
))
253 print_string(PRINT_ANY
, NULL
, " %s", "filter");
255 flags
&= ~(IFF_TUN
| IFF_TAP
| IFF_NO_PI
| IFF_ONE_QUEUE
|
256 IFF_VNET_HDR
| IFF_PERSIST
| IFF_NOFILTER
);
258 print_0xhex(PRINT_ANY
, NULL
, "%#llx", flags
);
260 close_json_array(PRINT_JSON
, NULL
);
263 static char *pid_name(pid_t pid
)
269 err
= asprintf(&comm
, "/proc/%d/comm", pid
);
273 f
= fopen(comm
, "r");
280 if (fscanf(f
, "%ms\n", &comm
) != 1) {
292 static void show_processes(const char *name
)
294 glob_t globbuf
= { };
298 err
= glob("/proc/[0-9]*/fd/[0-9]*", GLOB_NOSORT
,
303 open_json_array(PRINT_JSON
, "processes");
305 fd_path
= globbuf
.gl_pathv
;
307 const char *dev_net_tun
= "/dev/net/tun";
308 const size_t linkbuf_len
= strlen(dev_net_tun
) + 2;
309 char linkbuf
[linkbuf_len
], *fdinfo
;
313 if (sscanf(*fd_path
, "/proc/%d/fd/%d", &pid
, &fd
) != 2)
319 err
= readlink(*fd_path
, linkbuf
, linkbuf_len
- 1);
325 if (strcmp(dev_net_tun
, linkbuf
))
328 if (asprintf(&fdinfo
, "/proc/%d/fdinfo/%d", pid
, fd
) < 0)
331 f
= fopen(fdinfo
, "r");
339 char *key
= NULL
, *value
= NULL
;
341 err
= fscanf(f
, "%m[^:]: %ms\n", &key
, &value
);
346 } else if (err
== 2 &&
347 !strcmp("iff", key
) &&
348 !strcmp(name
, value
)) {
349 char *pname
= pid_name(pid
);
351 print_string(PRINT_ANY
, "name",
352 "%s", pname
? : "<NULL>");
354 print_uint(PRINT_ANY
, "pid",
368 close_json_array(PRINT_JSON
, NULL
);
373 static int tuntap_filter_req(struct nlmsghdr
*nlh
, int reqlen
)
375 struct rtattr
*linkinfo
;
378 linkinfo
= addattr_nest(nlh
, reqlen
, IFLA_LINKINFO
);
380 err
= addattr_l(nlh
, reqlen
, IFLA_INFO_KIND
,
381 drv_name
, sizeof(drv_name
) - 1);
385 addattr_nest_end(nlh
, linkinfo
);
390 static int print_tuntap(struct nlmsghdr
*n
, void *arg
)
392 struct ifinfomsg
*ifi
= NLMSG_DATA(n
);
393 struct rtattr
*tb
[IFLA_MAX
+1];
394 struct rtattr
*linkinfo
[IFLA_INFO_MAX
+1];
395 const char *name
, *kind
;
396 long flags
, owner
= -1, group
= -1;
398 if (n
->nlmsg_type
!= RTM_NEWLINK
&& n
->nlmsg_type
!= RTM_DELLINK
)
401 if (n
->nlmsg_len
< NLMSG_LENGTH(sizeof(*ifi
)))
404 switch (ifi
->ifi_type
) {
412 parse_rtattr(tb
, IFLA_MAX
, IFLA_RTA(ifi
), IFLA_PAYLOAD(n
));
414 if (!tb
[IFLA_IFNAME
])
417 if (!tb
[IFLA_LINKINFO
])
420 parse_rtattr_nested(linkinfo
, IFLA_INFO_MAX
, tb
[IFLA_LINKINFO
]);
422 if (!linkinfo
[IFLA_INFO_KIND
])
425 kind
= rta_getattr_str(linkinfo
[IFLA_INFO_KIND
]);
426 if (strcmp(kind
, drv_name
))
429 name
= rta_getattr_str(tb
[IFLA_IFNAME
]);
431 if (read_prop(name
, "tun_flags", &flags
))
433 if (read_prop(name
, "owner", &owner
))
435 if (read_prop(name
, "group", &group
))
438 open_json_object(NULL
);
439 print_color_string(PRINT_ANY
, COLOR_IFNAME
,
440 "ifname", "%s:", name
);
443 print_u64(PRINT_ANY
, "user",
446 print_u64(PRINT_ANY
, "group",
447 " group %ld", group
);
450 print_string(PRINT_FP
, NULL
,
451 "%s\tAttached to processes:", _SL_
);
452 show_processes(name
);
455 print_string(PRINT_FP
, NULL
, "%s", "\n");
460 static int do_show(int argc
, char **argv
)
462 if (rtnl_linkdump_req_filter_fn(&rth
, AF_UNSPEC
,
463 tuntap_filter_req
) < 0) {
464 perror("Cannot send dump request\n");
470 if (rtnl_dump_filter(&rth
, print_tuntap
, NULL
) < 0) {
471 fprintf(stderr
, "Dump terminated\n");
481 int do_iptuntap(int argc
, char **argv
)
484 if (matches(*argv
, "add") == 0)
485 return do_add(argc
-1, argv
+1);
486 if (matches(*argv
, "delete") == 0)
487 return do_del(argc
-1, argv
+1);
488 if (matches(*argv
, "show") == 0 ||
489 matches(*argv
, "lst") == 0 ||
490 matches(*argv
, "list") == 0)
491 return do_show(argc
-1, argv
+1);
492 if (matches(*argv
, "help") == 0)
495 return do_show(0, NULL
);
497 fprintf(stderr
, "Command \"%s\" is unknown, try \"ip tuntap help\".\n",
502 static void print_owner(FILE *f
, uid_t uid
)
504 struct passwd
*pw
= getpwuid(uid
);
507 print_string(PRINT_ANY
, "user", "user %s ", pw
->pw_name
);
509 print_uint(PRINT_ANY
, "user", "user %u ", uid
);
512 static void print_group(FILE *f
, gid_t gid
)
514 struct group
*group
= getgrgid(gid
);
517 print_string(PRINT_ANY
, "group", "group %s ", group
->gr_name
);
519 print_uint(PRINT_ANY
, "group", "group %u ", gid
);
522 static void print_mq(FILE *f
, struct rtattr
*tb
[])
524 if (!tb
[IFLA_TUN_MULTI_QUEUE
] ||
525 !rta_getattr_u8(tb
[IFLA_TUN_MULTI_QUEUE
])) {
526 if (is_json_context())
527 print_bool(PRINT_JSON
, "multi_queue", NULL
, false);
531 print_bool(PRINT_ANY
, "multi_queue", "multi_queue ", true);
533 if (tb
[IFLA_TUN_NUM_QUEUES
]) {
534 print_uint(PRINT_ANY
, "numqueues", "numqueues %u ",
535 rta_getattr_u32(tb
[IFLA_TUN_NUM_QUEUES
]));
538 if (tb
[IFLA_TUN_NUM_DISABLED_QUEUES
]) {
539 print_uint(PRINT_ANY
, "numdisabled", "numdisabled %u ",
540 rta_getattr_u32(tb
[IFLA_TUN_NUM_DISABLED_QUEUES
]));
544 static void print_type(FILE *f
, __u8 type
)
547 const char *str
= buf
;
551 else if (type
== IFF_TAP
)
554 snprintf(buf
, sizeof(buf
), "UNKNOWN:%hhu", type
);
556 print_string(PRINT_ANY
, "type", "type %s ", str
);
559 static void tun_print_opt(struct link_util
*lu
, FILE *f
, struct rtattr
*tb
[])
564 if (tb
[IFLA_TUN_TYPE
])
565 print_type(f
, rta_getattr_u8(tb
[IFLA_TUN_TYPE
]));
568 print_on_off(PRINT_ANY
, "pi", "pi %s ",
569 rta_getattr_u8(tb
[IFLA_TUN_PI
]));
571 if (tb
[IFLA_TUN_VNET_HDR
]) {
572 print_on_off(PRINT_ANY
, "vnet_hdr", "vnet_hdr %s ",
573 rta_getattr_u8(tb
[IFLA_TUN_VNET_HDR
]));
578 if (tb
[IFLA_TUN_PERSIST
])
579 print_on_off(PRINT_ANY
, "persist", "persist %s ",
580 rta_getattr_u8(tb
[IFLA_TUN_PERSIST
]));
582 if (tb
[IFLA_TUN_OWNER
])
583 print_owner(f
, rta_getattr_u32(tb
[IFLA_TUN_OWNER
]));
585 if (tb
[IFLA_TUN_GROUP
])
586 print_group(f
, rta_getattr_u32(tb
[IFLA_TUN_GROUP
]));
589 struct link_util tun_link_util
= {
591 .maxattr
= IFLA_TUN_MAX
,
592 .print_opt
= tun_print_opt
,