Scroll to navigation

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 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),
April 30, 2017 Virtual Distributed Ethernet