SLIRPVDE(1)						      General Commands Manual						       SLIRPVDE(1)

NAME

       slirpvde - Virtual Distributed Ethernet-Slirp interface

SYNOPSIS

       slirpvde OPTIONS [ socketdir ]

DESCRIPTION

       slirpvde is a slirp interface for a VDE network.

       Slirpvde  connects  all	the  units (virtual or real machines) to the network of the host where slirpvde runs as it were a NAT/Masquerading
       router.	The default route is the node 2 (10.0.2.2 in the default network configuration) and DNS is re-mapped in node 3 (10.0.2.3).

       Slirpvde runs using standard user privileges (no need for root access): all the connections are re-generated by slirpvde itself.

       IPv4 only. IPv6 is still unsupported (will be supported when slirpvde will be rewritten using the LWIPv6 network stack).

OPTIONS

       -s, --sock, --socket, --vdesock, --unix directory
	      specify the VDE switch directory (default /var/run/vde.ctl).  The VDE switch directory can be also specified at the end of the  com-
	      mand,  as  illustrated  by  the  optional  parameter socketdir in the synopsis section, above.  When '-' is used in place of the VDE
	      switch directory, slirpvde works as a plug (see vde_plug(1)).  The command:
		   dpipe vde_plug = ssh remote.machine.org slirpvde -
	      which is the same as:
		   dpipe vde_plug = ssh remote.machine.org slirpvde -s -
	      connects the default local switch to a remote slirpvde.

       -p, --pidfile filename
	      specify the name of the file which contains the PID of slirpvde.

       -g, --group group
	      specify the UNIX group for the VDE communication socket.

       -m, --mod mode
	      specify the octal UNIX permissions for the VDE communication socket.

       -P, --port port
	      specify the port of the vde switch whern slirpvde must be connected.

       -d, --daemon
	      detach from terminal and run slirpvde in background.

       -H, --host address [  /	masklen ]
	      specify the host address (default 10.0.2.2/24).  This option automatically defines the network.  e.g.
		    -H 192.168.55.1
	      or:
		    --host 10.1.2.3/16
	      The default value for masklen is 24.  If the host part of the address is zero this option defines only the network. The default host
	      addr is addr 2, the default dns proxy is 3.  e.g.
		    -H 10.1.0.0/16
	      defines the network only. The host address is 10.1.0.2 and the DNS proxy 10.1.0.3.

       -n, --network address [	/  masklen ]
	      specify  the network address (default 10.0.2.0/24).  Deprecated, it has been included for back compatibility only. It is an alias of
	      -H, --host.

       -N, --dns address
	      Specify the address of the dns server. If this is an address inside the slirp network, slirvde acts as a dns proxy on that  address.
	      The slirpvde dhcp server sends this dns address to the clients.  By default this is the host number 3 in the slirpvde network. Using
	      the default network it is 10.0.2.3.  Warning: do not use the same address for host and dns.

       -D, --dhcp
	      turn on the DHCP server for the network autoconfiguration of all the units connected to the VDE.	It  is	possible  to  specify  the
	      start address assigned by the DHCP server as follows:
		    --dhcp=10.1.1.44
	      DHCP assign addresses starting at host number 15 by default. Using the default network it starts from 10.0.2.15

       -L port:vde_host:vde_hostport
	      specifyes  a  TCP  port  redirection.   All  the TCP packets received by the host running slirpvde at port port will be forwarded to
	      vde_host at port vde_hostport.

       -U port:vde_host:vde_hostport
	      specifyes a UDP port redirection.  All the UDP packets received by the host running slirpvde at  port  port  will  be  forwarded	to
	      vde_host at port vde_hostport.

       -X vde_host[:display.[screen]]i
	      redirect a X window screen of a virtual machine. Slirpvde gets the first unused X display on the host running slirpvde and redirects
	      all the requests to vde_host.  display and screen] must be specified when different from :0.0.

       -x port:unix_socket_path]
	      redirect a port of the virtual router (usually 10.0.2.2) to a unix stream socket.  It is used for example to redirect a X display of
	      the  hosting  computer on the virtual network. e.g. -x6000:/tmp/.X11-unix/X0. (A suitable xhost configuration is needed (e.g. 'xhost
	      local:').

       -t, --tftp pathname
	      slirpvde enables a tftp server sharing (read-only) the directory at pathname.

       -q, --quiet
	      Quiet;   do   not  write	anything  to  standard	output.

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>.	This tool includes software developed by Danny Gasparovski: Slirp code is by Danny
       Gasparovsky.  Bootp/DHCP code is by Fabrice Bellard.

Virtual Distributed Ethernet					   June 15, 2008						       SLIRPVDE(1)