libvdeplug_switch - multiplexing vdeplug module: switch
Contents
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.
Examples
switch:///tmp/switch
Other virtual machines, namespaces or vde_plug can join this switch using vde:///tmp/switch or simply
/tmp/switchswitch:///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_plugnull://switch:///tmp/myswitch
The following command creates a switch connected to a tap virtual interface
vde_plugtap://mytapswitch:///tmp/myswitchName
libvdeplug_switch - multiplexing vdeplug module: switch
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").
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.
See Also
vde_plug(1), Virtual Distributed Ethernet April 30, 2017 LIBVDEPLUG_SWITCH(1)
Synopsis
libvdeplug_switch.so
