Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VDEQ(1)			    General Commands Manual		       VDEQ(1)

NAME
       vdeq  -	Virtual	 Distributed Ethernet wrapper for QEMU/KVM virtual ma-
       chines

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=sock-
       etpath][,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 parame-
       ters.  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 allocatable
       port  is	assigned.  The following command run a qemu VM with two	ether-
       net 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 con-
       nected 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 stan-
       dard 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  ETH-
       ERNET   MULTICAST   ADDRESSES  section  in  http://www.iana.org/assign-
       ments/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	 Tech-
       nologies").

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)

NAME | SYNOPSIS | OLD SYNOPSIS | DESCRIPTION | OPTIONS | NOTE | NOTICE | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=vdeq&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help