mirror of
https://git.proxmox.com/git/mirror_iproute2
synced 2025-10-31 15:31:19 +00:00
112112b8eb
This patch adds support for binding FOU ports using iproute2.
Kernel-support was added in 1713cb37bf67 ("fou: Support binding FoU
socket").
The parse function now handles new arguments for setting the
binding-related attributes, while the print function writes the new
attributes if they are set. Also, the man page has been updated.
v2->v3:
* Remove redundant ll_init_map()-calls (thanks David Ahern).
v1->v2 (all changes suggested by David Ahern):
* Fix reverse Christmas tree ordering.
* Remove redundant peer_port_set-variable, it is enough to check
peer_port.
* Add proper error handling of invalid local/peer addresses.
* Use interface name and not index.
* Remove updating fou-header file, it is already done.
Signed-off-by: Kristian Evensen <kristian.evensen@gmail.com>
Signed-off-by: David Ahern <dsahern@gmail.com>
127 lines
2.5 KiB
Groff
127 lines
2.5 KiB
Groff
.TH IP\-FOU 8 "2 Nov 2014" "iproute2" "Linux"
|
|
.SH "NAME"
|
|
ip-fou \- Foo-over-UDP receive port configuration
|
|
.P
|
|
ip-gue \- Generic UDP Encapsulation receive port configuration
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
.ad l
|
|
.in +8
|
|
.ti -8
|
|
.B ip
|
|
.RI "[ " OPTIONS " ]"
|
|
.B fou
|
|
.RI " { " COMMAND " | "
|
|
.BR help " }"
|
|
.sp
|
|
.ti -8
|
|
.BR "ip fou add"
|
|
.B port
|
|
.IR PORT
|
|
.RB "{ "
|
|
.B gue
|
|
.RI "|"
|
|
.B ipproto
|
|
.IR PROTO
|
|
.RB " }"
|
|
.RB "[ "
|
|
.B local
|
|
.IR IFADDR
|
|
.RB " ]"
|
|
.RB "[ "
|
|
.B peer
|
|
.IR IFADDR
|
|
.RB " ]"
|
|
.RB "[ "
|
|
.B peer_port
|
|
.IR PORT
|
|
.RB " ]"
|
|
.RB "[ "
|
|
.B dev
|
|
.IR IFNAME
|
|
.RB " ]"
|
|
.br
|
|
.ti -8
|
|
.BR "ip fou del"
|
|
.B port
|
|
.IR PORT
|
|
.RB "[ "
|
|
.B local
|
|
.IR IFADDR
|
|
.RB " ]"
|
|
.RB "[ "
|
|
.B peer
|
|
.IR IFADDR
|
|
.RB " ]"
|
|
.RB "[ "
|
|
.B peer_port
|
|
.IR PORT
|
|
.RB " ]"
|
|
.RB "[ "
|
|
.B dev
|
|
.IR IFNAME
|
|
.RB " ]"
|
|
.br
|
|
.ti -8
|
|
.B ip fou show
|
|
.SH DESCRIPTION
|
|
The
|
|
.B ip fou
|
|
commands are used to create and delete receive ports for Foo-over-UDP
|
|
(FOU) as well as Generic UDP Encapsulation (GUE).
|
|
.PP
|
|
Foo-over-UDP allows encapsulating packets of an IP protocol directly
|
|
over UDP. The receiver infers the protocol of a packet received on
|
|
a FOU UDP port to be the protocol configured for the port.
|
|
.PP
|
|
Generic UDP Encapsulation (GUE) encapsulates packets of an IP protocol
|
|
within UDP and an encapsulation header. The encapsulation header contains the
|
|
IP protocol number for the encapsulated packet.
|
|
.PP
|
|
When creating a FOU or GUE receive port, the port number is specified in
|
|
.I PORT
|
|
argument. If FOU is used, the IP protocol number associated with the port is specified in
|
|
.I PROTO
|
|
argument. You can bind a port to a local address/interface, by specifying the
|
|
address in the local
|
|
.I IFADDR
|
|
argument or the device in the
|
|
.I IFNAME
|
|
argument. If you would like to connect the port, you can specify the peer
|
|
address in the peer
|
|
.I IFADDR
|
|
argument and peer port in the peer_port
|
|
.I PORT
|
|
argument.
|
|
.PP
|
|
A FOU or GUE receive port is deleted by specifying
|
|
.I PORT
|
|
in the delete command, as well as local address/interface or peer address/port
|
|
(if set).
|
|
.SH EXAMPLES
|
|
.PP
|
|
.SS Configure a FOU receive port for GRE bound to 7777
|
|
.nf
|
|
# ip fou add port 7777 ipproto 47
|
|
.PP
|
|
.SS Configure a FOU receive port for IPIP bound to 8888
|
|
.nf
|
|
# ip fou add port 8888 ipproto 4
|
|
.PP
|
|
.SS Configure a GUE receive port bound to 9999
|
|
.nf
|
|
# ip fou add port 9999 gue
|
|
.PP
|
|
.SS Delete the GUE receive port bound to 9999
|
|
.nf
|
|
# ip fou del port 9999
|
|
.SS Configure a FOU receive port for GRE bound to 1.2.3.4:7777
|
|
.nf
|
|
# ip fou add port 7777 ipproto 47 local 1.2.3.4
|
|
.PP
|
|
.SH SEE ALSO
|
|
.br
|
|
.BR ip (8)
|
|
.SH AUTHOR
|
|
Tom Herbert <therbert@google.com>
|