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

AUTHOR

VirtualSquare. Project leader: Renzo Davoli