NAME

       libvdeplug_switch - multiplexing vdeplug module: switch

SYNOPSIS

       libvdeplug_switch.so

DESCRIPTION

       This is a libvdeplug multiplex module implementing a vde switch.

       This  module  of libvdeplug4 can be used in any program supporting vde like vde_plug, kvm,
       qemu, user-mode-linux and virtualbox.

       The vde_plug_url syntax of this module is the following:
              switch://[path]
              switch://[path][[OPTION][/OPTION][/OPTION]...]

       If  path  is  omitted  the  path   of   the   switch   is   /tmp/vdenode_$USERNAME   (e.g.
       /tmp/vdenode_john if the username is john).

       This  switch  supports 801.1Q vlan as a trunk switch, i.e. all the VLAN tagged packets are
       forwarded as such. The forwarding table uses a key including both the MAC address  and  th
       VLAN id.

OPTIONS

       hashsize=NUM
              set the size of the forwarding hash table. (default value 256)

       expiretime=SECONDS
              set the expire time of the forwarding table entries. (default value 120)

       hashseed=NUM
              set a hash seed, in case the hash function generates too many collisions.

       mode=MODE
              define  the  permissions  for the switch (see chmod). MODE is an octal number.  The
              standard permission mask is: 0600 (only processes owning to the same user can  join
              the network).

       dirmode=DIRMODE
              define  the  permissions  for  the  switch control directory(see chmod). MODE is an
              octal number.  If omitted, is computed from mode.

       grp=GROUP
              define the group ownership of the switch.

EXAMPLES

       switch:///tmp/switch
       Other  virtual  machines,  namespaces   or   vde_plug   can   join   this   switch   using
       vde:///tmp/switch or simply /tmp/switch
       switch:///tmp/switch[mode=0666/hashsize=1024]
       It  is  the  same switch, but everybody is allowed to connect their processes and the hash
       table has 1024 entries.
       The null plug can be used to create a stand-alone vde switch:
       vde_plug null:// switch:///tmp/myswitch
       The following command creates a switch connected to a tap virtual interface
       vde_plug tap://mytap switch:///tmp/myswitch

NOTICE

       Virtual Distributed Ethernet is not related in any  way  with  www.vde.com  ("Verband  der
       Elektrotechnik,  Elektronik  und  Informationstechnik"  i.e.  the  German "Association for
       Electrical, Electronic & Information Technologies").

SEE ALSO

       vde_plug(1),