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

set the size of the forwarding hash table. (default value 256)
set the expire time of the forwarding table entries. (default value 120)
set a hash seed, in case the hash function generates too many collisions.
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).
define the permissions for the switch control directory(see chmod). MODE is an octal number. If omitted, is computed from mode.
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