docs/grml-addtun.8.txt

   1 GRML-ADDTUN(8)
   2 ==============
   3 Michael Gebetsroither <michael.geb@gmx.at>
   4
   5
   6 NAME
   7 ----
   8 grml-addtun - creates persistent tun/tap devices with bridge handling
   9
  10
  11 SYNOPSIS
  12 --------
  13 *grml-addtun* [OPTIONS] <tun1> <tun2> ...
  14
  15
  16 DESCRIPTION
  17 -----------
  18 This manual page documents briefly the *grml-addtun* command.
  19
  20 *grml-addtun* is a script to create persistent tun/tap devices with integrated
  21 bridge handling.
  22
  23
  24 OPTIONS
  25 -------
  26 *-d*::
  27 Delete the given tun/tap devices and remove them from the bridge (if given with -b).
  28
  29 *-u <user>*::
  30 Make tun devices useable from <user> without special permissions.
  31
  32 *-g <group>*::
  33 Make tun devices useable from <group> without special permissions.
  34
  35 *-b <bridge>*::
  36 Remove/delete given tun devices from <bridge>.
  37
  38 *-a*::
  39 Automatic bridge handling, eg. create bridge if not existing and delete it if
  40 no more devices are part of it after removing the given tun/tap devices.
  41
  42 *-h*::
  43 Show the help message.
  44
  45
  46 EXAMPLES
  47 --------
  48 Config sampe for /etc/network/interfaces with bridge and tun/tap devices.
  49 This creates tap0..tap3 which are part of bridge vnet.
  50
  51 -------------
  52     auto vnet
  53     iface vnet inet static
  54         post-up  /root/bin/grml-addtun -u einstein -b vnet tap{0..3}
  55         pre-down /root/bin/grml-addtun -u einstein -b vnet -d tap{0..3}
  56         bridge_ports none
  57         address 192.168.10.1
  58         netmask 255.255.255.0
  59 -------------
  60
  61
  62 SEE ALSO
  63 --------
  64 grml-ap(8), grml-bridge(8), grml-router(8)
  65
  66
  67 AUTHOR
  68 ------
  69 grml-addtun was written by Michael Gebetsroither <gebi@grml.org>
  70
  71 This manual page was written by Michael Gebetsroither <gebi@grml.org>