1IP-FOU(8)                            Linux                           IP-FOU(8)
2
3
4

NAME

6       ip-fou - Foo-over-UDP receive port configuration
7
8       ip-gue - Generic UDP Encapsulation receive port configuration
9

SYNOPSIS

11       ip [ OPTIONS ] fou  { COMMAND | help }
12
13       ip fou add port PORT { gue | ipproto PROTO  } [ local IFADDR  ] [ peer
14               IFADDR  ] [ peer_port PORT  ] [ dev IFNAME  ]
15       ip fou del port PORT [ local IFADDR  ] [ peer IFADDR  ] [ peer_port
16               PORT  ] [ dev IFNAME  ]
17       ip fou show
18

DESCRIPTION

20       The ip fou commands are used to create and delete receive ports for
21       Foo-over-UDP (FOU) as well as Generic UDP Encapsulation (GUE).
22
23       Foo-over-UDP allows encapsulating packets of an IP protocol directly
24       over UDP. The receiver infers the protocol of a packet received on a
25       FOU UDP port to be the protocol configured for the port.
26
27       Generic UDP Encapsulation (GUE) encapsulates packets of an IP protocol
28       within UDP and an encapsulation header. The encapsulation header con‐
29       tains the IP protocol number for the encapsulated packet.
30
31       When creating a FOU or GUE receive port, the port number is specified
32       in PORT argument. If FOU is used, the IP protocol number associated
33       with the port is specified in PROTO argument. You can bind a port to a
34       local address/interface, by specifying the address in the local IFADDR
35       argument or the device in the IFNAME argument. If you would like to
36       connect the port, you can specify the peer address in the peer IFADDR
37       argument and peer port in the peer_port PORT argument.
38
39       A FOU or GUE receive port is deleted by specifying PORT in the delete
40       command, as well as local address/interface or peer address/port (if
41       set).
42

EXAMPLES

44   Configure a FOU receive port for GRE bound to 7777
45       # ip fou add port 7777 ipproto 47
46
47   Configure a FOU receive port for IPIP bound to 8888
48       # ip fou add port 8888 ipproto 4
49
50   Configure a GUE receive port bound to 9999
51       # ip fou add port 9999 gue
52
53   Delete the GUE receive port bound to 9999
54       # ip fou del port 9999
55
56   Configure a FOU receive port for GRE bound to 1.2.3.4:7777
57       # ip fou add port 7777 ipproto 47 local 1.2.3.4
58

SEE ALSO

60       ip(8)
61

AUTHOR

63       Tom Herbert <therbert@google.com>
64
65
66
67iproute2                          2 Nov 2014                         IP-FOU(8)
Impressum