Man page - libvdeplug_switch(1)

Packages contains this manual

Package: vdeplug
apt-get install vdeplug

Manuals in package:

Documentations in package:

vdeplug

Manual

LIBVDEPLUG_SWITCH

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
NOTICE
SEE ALSO

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