vde-2/man/vde_tunctl.8

   1 .TH "VDE_TUNCTL" "8"
   2 .SH "NAME"
   3 vde_tunctl \(em create and manage persistent TUN/TAP interfaces
   4 .SH "SYNOPSIS"
   5 .PP
   6 \fBvde_tunctl\fR [\fB-f\fP \fItun-clone-device\fR]  [\fB-u\fP \fIowner\fR]  [\fB-t\fP \fIdevice-name\fR]
   7 .PP
   8 \fBvde_tunctl\fR [\fB-f\fP \fItun-clone-device\fR] \fB-d\fP \fIdevice-name\fR
   9 .SH "DESCRIPTION"
  10 .PP
  11 \fBvde_tunctl\fR allows the host sysadmin to
  12 preconfigure a TUN/TAP device for use by a particular user.  That
  13 user may open and use the device, but may not change any aspects
  14 of the host side of the interface.
  15 .PP
  16 vde_tunctl is a simple copy of \fBtunctl\fR done for practical purposes.
  17 .SH "USAGE"
  18 .PP
  19 To create an interface for use by a particular user, invoke
  20 tunctl without the \-d option:
  21 .PP
  22 .nf
  23 # \fBvde_tunctl \-u someuser\fP
  24 Set 'tap0' persistent and owned by uid 500
  25
  26 .fi
  27 .PP
  28 Then, configure the interface as normal:
  29 .PP
  30 .nf
  31 # \fBifconfig tap0 192.168.0.254 up\fP
  32 # \fBroute add \-host 192.168.0.253 dev tap0\fP
  33 # \fBbash \-c 'echo 1 > /proc/sys/net/ipv4/conf/tap0/proxy_arp'\fP
  34 # \fBarp \-Ds 192.168.0.253 eth0 pub\fP
  35 .fi
  36 .PP
  37 To delete the interface, use the \-d option:
  38 .PP
  39 .nf
  40 # \fBvde_tunctl \-d tap0\fP
  41 Set 'tap0' nonpersistent
  42
  43 .fi
  44 .SH "SEE ALSO"
  45 .PP
  46 \fBvde_switch\fP(1)
  47 \fBvde_plug2tap\fP(1)
  48 .SH "AUTHOR"
  49 .PP
  50 tunctl was written by Jeff Dike jdike@karaya.com
  51 .PP
  52 This manual page is based on tunctl manual page written by Matt Zimmerman mdz@debian.org for
  53 the \fBDebian GNU/Linux\fP system.