]> git.proxmox.com Git - mirror_iproute2.git/blame - man/man8/ip-fou.8
update kernel headers based on net-next 3.21
[mirror_iproute2.git] / man / man8 / ip-fou.8
CommitLineData
e4fc7e26
TH
1.TH IP\-FOU 8 "2 Nov 2014" "iproute2" "Linux"
2.SH "NAME"
3ip-fou \- Foo-over-UDP receive port configuration
4.P
5ip-gue \- Generic UDP Encapsulation receive port configuration
6.SH "SYNOPSIS"
7.sp
8.ad l
9.in +8
10.ti -8
11.B ip
12.RI "[ " OPTIONS " ]"
13.B fou
14.RI " { " COMMAND " | "
15.BR help " }"
16.sp
17.ti -8
18.BR "ip fou add"
19.B port
20.IR PORT
21.RB "{ "
22.B gue
23.RI "|"
24.B ipproto
25.IR PROTO
26.RB " }"
27.br
28.ti -8
29.BR "ip fou del"
30.B port
31.IR PORT
32.SH DESCRIPTION
33The
34.B ip fou
35commands are used to create and delete receive ports for Foo-over-UDP
36(FOU) as well as Generic UDP Encapsulation (GUE).
37.PP
38Foo-over-UDP allows encapsulating packets of an IP protocol directly
39over UDP. The receiver infers the protocol of a packet received on
40a FOU UDP port to be the protocol configured for the port.
41.PP
42Generic UDP Encapsulation (GUE) encapsulates packets of an IP protocol
43within UDP and an encapsulation header. The encapsulation header contains the
44IP protocol number for the encapsulated packet.
45.PP
46When creating a FOU or GUE receive port, the port number is specified in
47.I PORT
48argument. If FOU is used, the IP protocol number associated with the port is specified in
49.I PROTO
50argument.
51.PP
52A FOU or GUE receive port is deleted by specifying
53.I PORT
54in the delete command.
55.SH EXAMPLES
56.PP
57.SS Configure a FOU receive port for GRE bound to 7777
58.nf
59# ip fou add port 8888 ipproto 47
60.PP
61.SS Configure a FOU receive port for IPIP bound to 8888
62.nf
63# ip fou add port 8888 ipproto 4
64.PP
65.SS Configure a GUE receive port bound to 9999
66.nf
67# ip fou add port 9999 gue
68.PP
69.SS Delete the GUE receive port bound to 9999
70.nf
71# ip fou del port 9999
72.SH SEE ALSO
73.br
74.BR ip (8)
75.SH AUTHOR
76Tom Herbert <therbert@google.com>