tunctl (8)

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 [email protected]

This manual page was written by Matt Zimmerman [email protected] for the Debian GNU/Linux system, based on examples from Jeff Dike.