NAME

       libvdeplug_slirp - slirp vdeplug module

SYNOPSIS

       libvdeplug_slirp.so

DESCRIPTION

       This is the libvdeplug module to join TCP-IP networks using the slirp emulator.

       This module of libvdeplug4 can be used in any program supporting vde like vde_plug, vdens,
       kvm, qemu, user-mode-linux and virtualbox.

       The vde_plug_url syntax of this module is the following: ``` slirp://[/OPTION][/OPTION]

OPTIONS

       v4 v6  provide IPv4 or IPv6 service only. Both family of protocols are enabled if both  v4
              and v6 options are present of if neither of them have been specified.

       addr=IPv4Addr/prefix or host=IPv4addr/prefix
              Set the IPv4 address of slirp (default value 10.0.2.2/24).

       addr6=IPv6Addr/prefix or host6=IPv6addr/prefix
              Set the IPv6 address of slirp (default value fd00::2/64).

       hostname=name
              define the hostname (default value: slirp)

       tftp_server_name=name
              define the hostname of the dhcp server

       tftp_path=path
              define the path of the directory whose contents are available by the tftp service

       bootfile=path
              define the path of the bootfile (for bootp)

       dhcp=dhcpIPv4addr
              set the lowest IP address assigned by dhcp

       vnameserver=IPv4Addr
              set the address of the IPv4 DNS proxy

       vnameserver6=IPv6Addr
              set the address of the IPv6 DNS proxy

       vdnssearch=list of domains
              set the default domains for the neame resolution e.g. vdnssearch=foo.com,bar.org

       vdomainname=name
              set the domain name

       mtu=int_value
              define the MTU

       mru==int_value
              define the MRU

       disable_host_loopback
              disable loopback

       tcpfwd=[hostIP:]hostport:guestIP:guestport[,[hostIP:]hostport:guestIP:guestport]...]
              forward TCP port(s).

       udpfwd=[hostIP:]hostport:guestIP:guestport[,[hostIP:]hostport:guestIP:guestport]...]
              forward UDP port(s).

       unixfwd=[slirpIP:]slirpport:path[,[slirpIP:]slirpport:path...]
              forward  TCP port(s) (from the virtual network) to PF_UNIX socket(s) (commonly used
              to forward ports to a X server) still unsupported by libslirp.

       cmdfwd=[slirpIP:]slirpport:cmd[,[slirpIP:]slirpport:path...]
              forward TCP port(s) (from the virtual network) to external command(s).

       verbose
              print a table of slirp service configuration.

EXAMPLES

       This vde_plug_url enables both IPv4 and IPv6 (using the default configuration)

       slirp://

       Like the previous example but it prints the table of the configuration options

       slirp:///verbose

       When a program uses the following vde_plug_url:

       slirp:///tcpfwd=8080:10.0.2.15:80

       tcp connections to the host computer port 8080 (any interface) are forwarded to  10.0.2.15
       port 80

       slirp:///tcpfwd=8080:10.0.2.15:80/cmdfwd=10.0.2.5:6000:'socat                        STDIO
       UNIX:"/tmp/.X11-unix/X0"'

       like the previous one plus this uses socat to forward all X-windows requests to 10.0.2.5:0
       (port 6000) to the local server of the display :0.

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)

AUTHOR

       VirtualSquare. Project leader: Renzo Davoli