slirpvde - Virtual Distributed Ethernet-Slirp interface

       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)

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

       slirpvde - Virtual Distributed Ethernet-Slirp interface

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

-s,--sock,--socket,--vdesock,--unixdirectory
              specify the VDE switch directory (default /var/run/vde.ctl).  The VDE switch directory can be also
              specified at the end of the command, 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:
                   dpipevde_plug=sshremote.machine.orgslirpvde-
              which is the same as:
                   dpipevde_plug=sshremote.machine.orgslirpvde-s-
              connects the default local switch to a remote slirpvde.

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

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

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

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

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

       -H,--hostaddress [  /masklen ]
              specify  the  host  address (default 10.0.2.2/24).  This option automatically defines the network.
              e.g.
                    -H192.168.55.1
              or:
                    --host10.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.
                    -H10.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,--networkaddress [  /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,--dnsaddress
              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

       -Lport: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.

       -Uport: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.

       -Xvde_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.

       -xport: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,--tftppathname
              slirpvde enables a tftp server sharing (read-only) the directory at pathname.

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

vde_switch(1), vde_plug(1), vde_plug2tap(1), dpipe(1).

slirpvdeOPTIONS [ socketdir ]