dwww Home | Manual pages | Find package

LIBVDEPLUG_SWITCH(1)        General Commands Manual       LIBVDEPLUG_SWITCH(1)

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  pro-
              cesses 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 us-
       ing 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  pro-
       cesses 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 in-
       terface
       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  Tech-
       nologies").

SEE ALSO
       vde_plug(1),

Virtual Distributed Ethernet    April 30, 2017            LIBVDEPLUG_SWITCH(1)

Generated by dwww version 1.15 on Wed Jun 26 01:29:21 CEST 2024.