.TH "TUNCTL" "8" 
.SH "NAME" 
tunctl \(em create and manage persistent TUN/TAP interfaces 
.SH "SYNOPSIS" 
.PP 
\fBtunctl\fR [\fB-f\fP \fItun-clone-device\fR]  [\fB-u\fP \fIowner\fR]  [\fB-t\fP \fIdevice-name\fR]  
.PP 
\fBtunctl\fR [\fB-f\fP \fItun-clone-device\fR]  \fB-d\fP \fIdevice-name\fR 
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBtunctl\fR command. 
.PP 
This manual page was written for the \fBDebian GNU/Linux\fP distribution 
because the original program does not have a manual page. 
Instead, it has documentation in HTML format; see below. 
.PP 
\fBtunctl\fR 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. 
.SH "USAGE" 
.PP 
To create an interface for use by a particular user, invoke 
tunctl without the \-d option: 
.PP 
.nf 
#  
.ft B 
tunctl \-u someuser 
.ft  
Set 'tap0' persistent and owned by 'someuser' 
 
.fi 
.PP 
Then, configure the interface as normal: 
.PP 
.nf 
#  
.ft B 
ifconfig tap0 192.168.0.254 up 
.ft  
#  
.ft B 
route add \-host 192.168.0.253 dev tap0 
.ft  
#  
.ft B 
bash \-c 'echo 1 > /proc/sys/net/ipv4/conf/tap0/proxy_arp' 
.ft  
#  
.ft B 
arp \-Ds 192.168.0.253 eth0 pub 
.ft        
.fi 
.PP 
To delete the interface, use the \-d option: 
.PP 
.nf 
#  
.ft B 
tunctl \-d tap0 
.ft  
Set 'tap0' nonpersistent 
 
.fi 
.SH "SEE ALSO" 
.PP 
The \fIUserModeLinux-HOWTO (link to URL http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO.html) \fR 
.SH "AUTHOR" 
.PP 
tunctl was written by Jeff Dike 
jdike@karaya.com 
.PP 
This manual page was written by Matt Zimmerman mdz@debian.org for 
the \fBDebian GNU/Linux\fP system, based on examples from Jeff Dike. 
.\" created by instant / docbook-to-man