Provided by: uml-utilities_20070815-1.1ubuntu2_i386 bug

NAME

       tunctl — create and manage persistent TUN/TAP interfaces

SYNOPSIS

       tunctl [-f tun-clone-device]  [-u owner]  [-t device-name]

       tunctl [-f tun-clone-device]  -d device-name

DESCRIPTION

       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.

USAGE

       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 -cecho 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

SEE ALSO

       The    UserModeLinux-HOWTO    (link    to     URL     http://user-mode-
       linux.sourceforge.net/UserModeLinux-HOWTO.html)

AUTHOR

       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.

                                                                     TUNCTL(8)