| TUNCTL(8) | System Manager's Manual | TUNCTL(8) |
tunctl — create and manage persistent TUN/TAP interfaces
tunctl [-f tun-clone-device] [-u owner] [-t device-name]
tunctl [-f tun-clone-device] -d device-name
This manual page documents briefly the tunctl command.
This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. Instead, it has documentation in HTML format; see below.
tunctl allows the host sysadmin to preconfigure a TUN/TAP device for use by a particular user. That user may open and use the device, but may not change any aspects of the host side of the interface.
To create an interface for use by a particular user, invoke tunctl without the -d option:
# tunctl -u someuser Set 'tap0' persistent and owned by 'someuser'
Then, configure the interface as normal:
# ifconfig tap0 192.168.0.254 up # route add -host 192.168.0.253 dev tap0 # bash -c 'echo 1 > /proc/sys/net/ipv4/conf/tap0/proxy_arp' # arp -Ds 192.168.0.253 eth0 pub
To delete the interface, use the -d option:
# tunctl -d tap0 Set 'tap0' nonpersistent
The UserModeLinux-HOWTO (link to URL http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO.html)
tunctl was written by Jeff Dike jdike@karaya.com
This manual page was written by Matt Zimmerman mdz@debian.org for the Debian GNU/Linux system, based on examples from Jeff Dike.