Man page - libvdeplug_slirp(1)

Packages contains this manual

Package: libvdeplug-slirp
apt-get install libvdeplug-slirp

Manuals in package:

libvdeplug_slirp(1)

Documentations in package:

libvdeplug-slirp

Manual

LIBVDEPLUG_SLIRP

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
NOTICE
SEE ALSO
AUTHOR

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