NAME

       libvdeplug_bonding - multiplexing vdeplug module: bonding links

SYNOPSIS

       libvdeplug_bonding.so

DESCRIPTION

       This is a libvdeplug multiplex module implementing the bonding of multiple links.

       The  common  usage of this module is to support multiple links between virtual machines or
       switches.  This module transmit packets on  all  the  available  links  in  a  round-robin
       manner.   If  the  links  use  several paths and channels it is possible to reach a higher
       bandwidth.

       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:
              bonding://[path]
              bonding://[path][[OPTION][/OPTION][/OPTION]...]

       If   path   is   omitted   the   path  of  the  bonding  is  /tmp/vdenode_$USERNAME  (e.g.
       /tmp/vdenode_john if the username is john).

OPTIONS

       mode=MODE
              define the permissions for the bonding node (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 bonding node control directory(see chmod).  MODE  is
              an octal number.  If omitted, is computed from mode.

       grp=GROUP
              define the group ownership of the bonding node.

EXAMPLES

       bonding:///tmp/bonding
       Other   virtual   machines,  namespaces  or  vde_plug  can  join  this  bondinglink  using
       vde:///tmp/hub or simply /tmp/hub
       Given two virtual machines using bonding:///tmp/vm1 and  bonding:///tmp/vm2  respectively,
       it  is  possible  to  connect them using vde_plug /tmp/vm1 /tmp/vm2. If the second virtual
       machine is running on a remote hosts; ip1.vm2.domain.org and ip2.vm2.domain.org are two ip
       addresses  permitting  to  reach  that  remote  host  using  different paths, the commands
       vde_plug /tmp/vm1 = ssh ip1.vm2.domain.org vde_plug /tmp/vm2 and vde_plug /tmp/vm1  =  ssh
       ip2.vm2.domain.org vde_plug /tmp/vm2 create two channels between the two virtual machines.
       Packets are sent in turns on one or the other link.
       bonding:///tmp/bonding[mode=0666]
       It is the same bondinglink, but everybody is allowed to connect their processes.

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),