vde_l3(1) [debian man page]

VDE_L3(1)						      General Commands Manual							 VDE_L3(1)

NAME

       vde_l3 - Virtual Distributed Ethernet 'Layer 3' Switch.

SYNOPSIS

       vde_l3 -v vde_plug:ipaddress/netmask [-v...]  [-r target_network/netmask:gateway] [-G default_gw] [-M mgmt_socket]

DESCRIPTION

       A vde_l3 connects to one or more vde_switches, performing ip forwarding among its virtual interfaces. A new interface is created at startup
       for each -v option given at command line. Static routes to target networks can be defined using the -r option.

       vde_l3 -v /var/run/s1.ctl:192.168.0.1/24

       connects to the vde sock at /var/run/s1.ctl with its virtual interface ve0, having the address 192.168.0.1 and netmask 255.255.255.0.

       vde_l3 

       -v /var/run/s1.ctl:192.168.0.1/24 

       -v /var/run/s2.ctl:10.0.0.254/255.255.0.0

       connects to the two vde socks, with its virtual interfaces ve0 and ve1, having addressess 192.168.1.0 and 10.0.0.254 respectively. Hosts in
       each network can specify the vde_l3 as their gateway to reach the other one.

OPTIONS

       -v vde_plug:ipaddress/netmask
	      Creates a virtual network interfaces on the vde_l3 box, with address ipaddress and netmask netmask. Please note that the netmask can
	      be specified either in the 'classic' A.B.C.D mode, or just by giving the number of leading bits (f.e., /17 for 255.255.128.0).   One
	      can define as many interfaces as she wants.

       -r target_network/netmask:gateway
	      Specify  a static route through gateway to reach hosts in target_network with netmask netmask.  One can define as many routes as she
	      wants.

       -G default_gw
	      Specify a default gateway, to be used whenever no static route is defined for a target host.

       -M mgmt_socket
	      the unix socket where the parameters (interfaces addresses, routes, etc.) can be checked and changed  runtime.  unixterm(1)  can	be
	      used as a remote terminal for wirefilter.

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_switch(1), vdeq(1), unixterm(1), vde_cryptcab(1), wirefilter(1).

AUTHORS

       VDE_L3 is a tool by Daniele Lacamera <root@danielinux.net>

       VDE is a project by Renzo Davoli <renzo@cs.unibo.it>

Virtual Distributed Ethernet					    May 7, 2007 							 VDE_L3(1)

VDEQ(1) 						      General Commands Manual							   VDEQ(1)

NAME

       vdeq - Virtual Distributed Ethernet wrapper for QEMU/KVM virtual machines

SYNOPSIS

       vdeq qemu [ --mod octalmode ] QEMU_OPTIONS -net vde[,vlan=n][,sock=socketpath][,port=n] QEMU_OPTIONS
       vdeq kvm [ --mod octalmode ] KVM_OPTIONS -net vde[,vlan=n][,sock=socketpath][,port=n] KVM_OPTIONS
       vde{qemu_name} [ --mod octalmode ] QEMU_OPTIONS -net vde[,vlan=n][,sock=socketpath][,port=n] QEMU_OPTIONS

OLD SYNOPSIS

       vdeq qemu [ --mod octalmode ] [ -sock socketpath [ ,socketpath [ ,...  ] ] ] [ qemu_args ]
       vde{qemu_name} [ -sock socketpath [ ,socketpath [ ,...  ] ] ] [ qemu_args ]

DESCRIPTION

       vdeq  is  a wrapper to start a QEMU/KVM virtual machine connected to a VDE network.  It uses the qemu/kvm  -tun-fd  parameter to set up the
       connection with a vde_switch.

       The command
	      vdeq qemu -b c -hda=sampledisk
       starts a qemu machine which boots from the sampledisk image and has a ne2000 ethernet interface connected to the standard vde_switch.   The
       command
	      vdeq kvm -b c -hda=sampledisk
       starts a kvm machine which boots from the sampledisk image and has a ne2000 ethernet interface connected to the standard vde_switch.

       It  is also possible to create symbolic links to the vdeq executable to have a simpler command. If the link has a name that begins with vde
       the remaining part of the name is taken as the qemu command. For example if vdeq is linked to vdeqemu:
	      vdeqemu -b c -hda=sampledisk
       starts qemu as above. If vdeq is linked to vdekvm:
	      vdekvm -b c -hda=sampledisk
       starts kvm with the same parameters.

       The new syntax is consistent with the new Qemu 0.8.0 network parameters.  Using vdeq is possible to specify a vde interface in the same way
       as  user,tap  or socket interfaces.  The sock= parameter can be used to use a specific socket.  Please note that what qemu names as vlan is
       not related to the 802.1q VLAN managed by the vde_switch.  port= can be used to specify the port of the switch, otherwise the  first  allo-
       catable	port  is  assigned.   The  following command run a qemu VM with two ethernet interface connected to the standard switch and to the
       switch with local socket "/tmp/my.ctl", port 10, respectively
	      vde qemu -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10
	      vdeqemu -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10
       The following command run a kvm VM with two ethernet interface connected to the standard  switch  and  to  the  switch  with  local  socket
       "/tmp/my.ctl", port 10, respectively
	      vde kvm -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10
	      vdekvm -net nic,vlan=0 -net nic,vlan=1 -net vde,vlan=0 -net vde,vlan=1,sock=/tmp/my.ctl,port=10

       The old syntax can be used with Qemu 0.8.0 but all the vde interfaces are assigned to vlan 0.
	      vdeq qemu -sock /tmp/vde.ctl,/tmp/my.ctl -b c -hda=sampledisk
	      vdeqemu -sock /tmp/vde.ctl,/tmp/my.ctl -b c -hda=sampledisk
       both start qemu with one ethernet interface connected both to the standard switch and to the switch with local socket "/tmp/my.ctl".

OPTIONS

       --mod  octalmode, specify the mode for comm socket.

       -sock  socketpath,  specify  the  UNIX  socket to be used by local programs for joining the VDE.  The default value is "/tmp/vde.ctl" It is
	      also possible to indicate several socketpath (comma separated, no blanks): in this case several interfaces are  defined.	The  first
	      socketpath is connected to the first ne2k interface and so on.

       -h, -help, --help
	      print a Usage help.

NOTE

       Qemu  has  changed its syntax for networking (cvs Nov.15 2005).	As a temporary solution use vdeoq and vdeoqemu instead of vdeq and vdeqemu
       if you are running a qemu with the old syntax.
       By default qemu uses the same MAC address for every virtual machine, so if you plan to use several instances of qemu be sure to	explicitly
       set  a  different  MAC address for each virtual machine. While generating your address beware to not use broadcast/multicast reserved MACs,
       ethernet rules say: the multicast bit is the low-order bit of the first	byte,  which  is  "the	first  bit  on	the  wire".   For  example
       34:12:de:ad:be:ef  is  an  unicast  address,  35:12:de:ad:be:ef	is  a  multicast  address  (see  ETHERNET  MULTICAST  ADDRESSES section in
       http://www.iana.org/assignments/ethernet-numbers for more informations).

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_switch(1), vde_plug(1), vde_plug2tap(1), dpipe(1).

AUTHOR

       VDE is a project by Renzo Davoli <renzo@cs.unibo.it>

Virtual Distributed Ethernet					 December 6, 2006							   VDEQ(1)