Slirp license issue fixed.
[vde.git] / vde-2 / man / vde_l3.1
blobe9917984ac04f837a478334451ca4e629e37cd7d
1 .TH VDE_L3 1 "May 7, 2007" "Virtual Distributed Ethernet"
2 .SH NAME
3 vde_l3 \- Virtual Distributed Ethernet 'Layer 3' Switch.
4 .SH SYNOPSIS
5 .B vde_l3
6 \fB\-v\fI vde_plug:ipaddress/netmask\fR
7 [\fB\-v\fI...]
8 [\fB\-r\fI target_network/netmask:gateway\fR]
9 [\fB\-G\fI default_gw\fR]
10 [\fB\-M\fI mgmt_socket\fR]
11 .br
12 .SH DESCRIPTION
14 \fBvde_l3\fP 
15 connects to one or more vde_switches, performing ip forwarding among its virtual
16 interfaces. A new interface is created at startup for each \fB-v\fP option given at
17 command line. Static routes to target networks can be defined using the \fB-r\fP option.
20 vde_l3 -v /var/run/s1.ctl:192.168.0.1/24
22 connects to the vde sock at /var/run/s1.ctl with its virtual interface ve0, having
23 the address 192.168.0.1 and netmask 255.255.255.0.
26 vde_l3 \\ 
29 -v /var/run/s1.ctl:192.168.0.1/24 \\ 
32 -v /var/run/s2.ctl:10.0.0.254/255.255.0.0 
34 connects to the two vde socks, with its virtual interfaces ve0 and ve1, having addressess 192.168.1.0 and 10.0.0.254 respectively. Hosts in each network can specify the 
35 \fBvde_l3\fP as their gateway to reach the other one.
37 .SH OPTIONS
38 .TP
39 .B -v\fI vde_plug:ipaddress/netmask\fR
40 Creates a virtual network interfaces on the \fBvde_l3\fP box, with address \fIipaddress\fP and netmask \fInetmask\fP. Please note that the netmask can be specified either in 
41 the 'classic' A.B.C.D mode, or just by giving the number of leading bits (f.e., /17 for 255.255.128.0).
42 One can define as many interfaces as she wants.
44 .TP
45 .B -r \fItarget_network/netmask:gateway\fR
46 Specify a static route through \fIgateway\fP to reach hosts in \fItarget_network\fP with netmask \fInetmask\fP.
47 One can define as many routes as she wants.
49 .TP
50 .B -G \fIdefault_gw
51 Specify a default gateway, to be used whenever no static route 
52 is defined for a target host.
54 .TP
55 .B -M \fImgmt_socket
56 the unix socket where the parameters (interfaces addresses, routes, etc.) can be checked and
57 changed runtime. \fBunixterm\fP(1) can be used as a remote terminal for wirefilter.
60 .SH NOTICE
61 Virtual Distributed Ethernet is not related in any way with
62 www.vde.com ("Verband der Elektrotechnik, Elektronik und Informationstechnik"
63 i.e. the German "Association for Electrical, Electronic & Information
64 Technologies").
66 .SH SEE ALSO
67 \fBvde_switch\fP(1),
68 \fBvdeq\fP(1),
69 \fBunixterm\fP(1),
70 \fBvde_cryptcab\fP(1),
71 \fBwirefilter\fP(1).
72 .br
73 .SH AUTHORS
74 VDE_L3 is a tool by Daniele Lacamera <root@danielinux.net> 
76 VDE is a project by Renzo Davoli <renzo@cs.unibo.it>