|
Packit Service |
3880ab |
.TH IP\-FOU 8 "2 Nov 2014" "iproute2" "Linux"
|
|
Packit Service |
3880ab |
.SH "NAME"
|
|
Packit Service |
3880ab |
ip-fou \- Foo-over-UDP receive port configuration
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
ip-gue \- Generic UDP Encapsulation receive port configuration
|
|
Packit Service |
3880ab |
.SH "SYNOPSIS"
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
.ad l
|
|
Packit Service |
3880ab |
.in +8
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B ip
|
|
Packit Service |
3880ab |
.RI "[ " OPTIONS " ]"
|
|
Packit Service |
3880ab |
.B fou
|
|
Packit Service |
3880ab |
.RI " { " COMMAND " | "
|
|
Packit Service |
3880ab |
.BR help " }"
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip fou add"
|
|
Packit Service |
3880ab |
.B port
|
|
Packit Service |
3880ab |
.IR PORT
|
|
Packit Service |
3880ab |
.RB "{ "
|
|
Packit Service |
3880ab |
.B gue
|
|
Packit Service |
3880ab |
.RI "|"
|
|
Packit Service |
3880ab |
.B ipproto
|
|
Packit Service |
3880ab |
.IR PROTO
|
|
Packit Service |
3880ab |
.RB " }"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B local
|
|
Packit Service |
3880ab |
.IR IFADDR
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B peer
|
|
Packit Service |
3880ab |
.IR IFADDR
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B peer_port
|
|
Packit Service |
3880ab |
.IR PORT
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR IFNAME
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip fou del"
|
|
Packit Service |
3880ab |
.B port
|
|
Packit Service |
3880ab |
.IR PORT
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B local
|
|
Packit Service |
3880ab |
.IR IFADDR
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B peer
|
|
Packit Service |
3880ab |
.IR IFADDR
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B peer_port
|
|
Packit Service |
3880ab |
.IR PORT
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B dev
|
|
Packit Service |
3880ab |
.IR IFNAME
|
|
Packit Service |
3880ab |
.RB " ]"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B ip fou show
|
|
Packit Service |
3880ab |
.SH DESCRIPTION
|
|
Packit Service |
3880ab |
The
|
|
Packit Service |
3880ab |
.B ip fou
|
|
Packit Service |
3880ab |
commands are used to create and delete receive ports for Foo-over-UDP
|
|
Packit Service |
3880ab |
(FOU) as well as Generic UDP Encapsulation (GUE).
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
Foo-over-UDP allows encapsulating packets of an IP protocol directly
|
|
Packit Service |
3880ab |
over UDP. The receiver infers the protocol of a packet received on
|
|
Packit Service |
3880ab |
a FOU UDP port to be the protocol configured for the port.
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
Generic UDP Encapsulation (GUE) encapsulates packets of an IP protocol
|
|
Packit Service |
3880ab |
within UDP and an encapsulation header. The encapsulation header contains the
|
|
Packit Service |
3880ab |
IP protocol number for the encapsulated packet.
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
When creating a FOU or GUE receive port, the port number is specified in
|
|
Packit Service |
3880ab |
.I PORT
|
|
Packit Service |
3880ab |
argument. If FOU is used, the IP protocol number associated with the port is specified in
|
|
Packit Service |
3880ab |
.I PROTO
|
|
Packit Service |
3880ab |
argument. You can bind a port to a local address/interface, by specifying the
|
|
Packit Service |
3880ab |
address in the local
|
|
Packit Service |
3880ab |
.I IFADDR
|
|
Packit Service |
3880ab |
argument or the device in the
|
|
Packit Service |
3880ab |
.I IFNAME
|
|
Packit Service |
3880ab |
argument. If you would like to connect the port, you can specify the peer
|
|
Packit Service |
3880ab |
address in the peer
|
|
Packit Service |
3880ab |
.I IFADDR
|
|
Packit Service |
3880ab |
argument and peer port in the peer_port
|
|
Packit Service |
3880ab |
.I PORT
|
|
Packit Service |
3880ab |
argument.
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
A FOU or GUE receive port is deleted by specifying
|
|
Packit Service |
3880ab |
.I PORT
|
|
Packit Service |
3880ab |
in the delete command, as well as local address/interface or peer address/port
|
|
Packit Service |
3880ab |
(if set).
|
|
Packit Service |
3880ab |
.SH EXAMPLES
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
.SS Configure a FOU receive port for GRE bound to 7777
|
|
Packit Service |
3880ab |
.nf
|
|
Packit Service |
3880ab |
# ip fou add port 7777 ipproto 47
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
.SS Configure a FOU receive port for IPIP bound to 8888
|
|
Packit Service |
3880ab |
.nf
|
|
Packit Service |
3880ab |
# ip fou add port 8888 ipproto 4
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
.SS Configure a GUE receive port bound to 9999
|
|
Packit Service |
3880ab |
.nf
|
|
Packit Service |
3880ab |
# ip fou add port 9999 gue
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
.SS Delete the GUE receive port bound to 9999
|
|
Packit Service |
3880ab |
.nf
|
|
Packit Service |
3880ab |
# ip fou del port 9999
|
|
Packit Service |
3880ab |
.SS Configure a FOU receive port for GRE bound to 1.2.3.4:7777
|
|
Packit Service |
3880ab |
.nf
|
|
Packit Service |
3880ab |
# ip fou add port 7777 ipproto 47 local 1.2.3.4
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
.SH SEE ALSO
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.BR ip (8)
|
|
Packit Service |
3880ab |
.SH AUTHOR
|
|
Packit Service |
3880ab |
Tom Herbert <therbert@google.com>
|