From: Tom Gundersen Date: Tue, 1 Jul 2014 19:38:08 +0000 (+0200) Subject: man: bring systemd.netdev(5) up-to-date X-Git-Tag: v215~57 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=b35a29096045f2b820d343bfa24a35eb033930a2 man: bring systemd.netdev(5) up-to-date Based on a diff by the mysterious 'poma'. --- diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml index bf1d24e0a..48c6e726d 100644 --- a/man/systemd.netdev.xml +++ b/man/systemd.netdev.xml @@ -141,6 +141,13 @@ keys: + + Description= + + A free-form description of the netdev. + + + Name= @@ -152,13 +159,34 @@ Kind= The netdev kind. Currently, bridge, - bond, vlan and - macvlan are supported. This option + bond, vlan, + macvlan, vxlan, + ipip, gre, + sit, vti, + veth are supported. This option is compulsory. + + MTUBytes= + + The maximum transmission unit in bytes to + set for the device. The usual suffixes K, M, G, + are supported and are understood to the base of + 1024. + + + + MACAddress= + + The MAC address to use for the device. + If none is given, one is generated based on + the interface name and the + machine-id5. + + + - @@ -198,7 +226,119 @@ + + [VXLAN] Section Options + The [VXLAN] section only applies for netdevs of kind + vxlan, and accepts the following key: + + + Id= + + The VXLAN ID to use. + + + + Group= + + An assigned multicast group IP address. + + + + TOS= + + The Type Of Service byte value for a vxlan interface. + + + + TTL= + + A fixed Time To Live N on Virtual eXtensible Local Area Network packets. + N is a number in the range 1-255. 0 is a special value meaning that packets + inherit the TTL value. + + + + MacLearning= + + A boolean. When true, enables dynamic MAC learning + to discover remote MAC addresses. + + + + + + [Tunnel] Section Options + + The [Tunnel] section only applies for netdevs of kind + ipip, sit, gre and + vti and accepts the following keys: + + + + Local= + + A static local address for tunneled packets. + It must be an address on another interface of this host. + + + + Remote= + + The remote endpoint of the tunnel. + + + + TOS= + + The Type Of Service byte value for a tunnel interface. + For details about the TOS see the + + Type of Service in the Internet Protocol Suite + document. + + + + + TTL= + + A fixed Time To Live N on tunneled packets. + N is a number in the range 1-255. 0 is a special value meaning that packets + inherit the TTL value. The default value for IPv4 tunnels is: inherit. + The default value for IPv6 tunnels is: 64. + + + + DiscoverPathMTU= + + A boolean. When true, enables Path MTU Discovery on the tunnel. + + + + + + [Peer] Section Options + + The [Peer] section only applies for netdevs of kind veth + and accepts the following key: + + + + Name= + + The interface name used when creating the netdev. + This option is compulsory. + + + + MACAddress= + + The peer MACAddress, if not set it is generated in the same + way as the MAC address of the main interface. + + + + Example @@ -222,9 +362,67 @@ Kind=vlan [VLAN] Id=1 + + /etc/systemd/network/ipip.netdev + [NetDev] +Name=ipip-tun +Kind=ipip +MTUBytes=1480 + +[Tunnel] +Local=192.168.223.238 +Remote=192.169.224.239 +TTL=64 + - + + /etc/systemd/network/sit.netdev + [NetDev] +Name=sit-tun +Kind=sit +MTUBytes=1480 + +[Tunnel] +Local=10.65.223.238 +Remote=10.65.223.239 + + + /etc/systemd/network/gre.netdev + [NetDev] +Name=gre-tun +Kind=gre +MTUBytes=1480 + +[Tunnel] +Local=10.65.223.238 +Remote=10.65.223.239 + + + + /etc/systemd/network/vti.netdev + + [NetDev] +Name=vti-tun +Kind=vti +MTUBytes=1480 + +[Tunnel] +Local=10.65.223.238 +Remote=10.65.223.239 + + + + /etc/systemd/network/veth.netdev + [NetDev] +Name=veth-test +Kind=veth + +[Peer] +Name=veth-peer + + + See Also