LIBVDEPLUG_SLIRP

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