LIBVDEPLUG_SWITCH

Section: User Commands (1)
Updated: April 30, 2017
Index Return to Main Contents

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").

This document was created by man2html, using the manual pages.
Time: 17:58:36 GMT, April 27, 2024