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),

Virtual Distributed Ethernet                     April 30, 2017                             LIBVDEPLUG_SWITCH(1)