X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.netdev.xml;h=03b0940716dfb1731778b5773ab339aeb17cca59;hp=857221fdb0bb71e160d9298bcd1d360a58df1f76;hb=25b47f96d9601ff566257b2a31bfb5f4bd25d661;hpb=54f601debc07addbed803fb847cd5bd3e91e021e
diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml
index 857221fdb..03b094071 100644
--- a/man/systemd.netdev.xml
+++ b/man/systemd.netdev.xml
@@ -60,7 +60,10 @@
Virtual Network Device files must have the extension
.netdev; other extensions are ignored. Virtual
- network devices are created as soon as networkd is started.
+ network devices are created as soon as networkd is started. If a netdev
+ with the specified name already exists, networkd will use that as-is
+ rather than create its own. Note that the settings of the pre-existing
+ netdev will not be changed by networkd.
The .netdev files are read from the files located in the
system network directory /usr/lib/systemd/network,
@@ -160,7 +163,8 @@
The netdev kind. Currently, bridge,
bond, vlan,
- macvlan, vxlan,
+ macvlan,
+ ipvlan, vxlan,
ipip, gre,
sit, vti,
veth, tun,
@@ -174,7 +178,9 @@
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.
+ 1024. This key is not currently suported for
+ tun or tap devices.
+
@@ -184,6 +190,7 @@
If none is given, one is generated based on
the interface name and the
machine-id5.
+ This key is not currently suported for tun or tap devices.
@@ -227,6 +234,26 @@
+
+
+ [IPVLAN] Section Options
+
+ The [IPVLAN] section only applies for netdevs of kind
+ ipvlan, and accepts the following key:
+
+
+
+ Mode=
+
+ The IPVLAN mode to use. The supported options are
+ L2 and L3.
+
+
+
+
+
+
+
[VXLAN] Section Options
The [VXLAN] section only applies for netdevs of kind
@@ -266,6 +293,36 @@
to discover remote MAC addresses.
+
+ FDBAgeingSec=
+
+ The lifetime of Forwarding Database entry learnt by the kernel in seconds.
+
+
+
+ ARPProxy=
+
+ A boolean. When true, enables ARP proxy.
+
+
+
+ L2MissNotification=
+
+ A boolean. When true, enables netlink LLADDR miss notifications.
+
+
+
+ L3MissNotification=
+
+ A boolean. When true, enables netlink IP ADDR miss notifications.
+
+
+
+ RouteShortCircuit=
+
+ A boolean. When true route short circuit is turned on.
+
+
@@ -395,6 +452,87 @@
[Tun] section.
+
+ [Bond] Section Options
+
+ The [Bond] section accepts the following
+ key:
+
+
+
+ Mode=
+
+ Specifies one of the bonding policies. The default is
+ balance-rr (round robin). Possible values are
+ balance-rr,
+ active-backup,
+ balance-xor,
+ broadcast,
+ 802.3ad,
+ balance-tlb, and
+ balance-alb.
+
+
+
+
+
+ TransmitHashPolicy=
+
+ Selects the transmit hash policy to use for slave selection in
+ balance-xor, 802.3ad, and tlb modes. Possible values are
+ layer2,
+ layer3+4,
+ layer2+3,
+ encap2+3,
+ 802.3ad, and
+ encap3+4.
+
+
+
+
+
+ LACPTransmitRate=
+
+ Specifies the rate with which link partner
+ transmits Link Aggregation Control Protocol Data Unit packets
+ in 802.3ad mode. Possible values are
+ slow, which requests partner to transmit LACPDUs every 30 seconds, and
+ fast, which requests partner to transmit LACPDUs every second.
+ The default value is slow.
+
+
+
+
+ MIIMonitorSec=
+
+ Specifies the frequency that Media Independent Interface link
+ monitoring will occur. A value of zero disables MII link monitoring.
+ This values is rounded down to the nearest millisecond. The default
+ value is 0.
+
+
+
+
+ UpDelaySec=
+
+ Specifies the delay before a link is enabled after a link up
+ status has been detected. This value is rounded down to a multiple of
+ MIIMonitorSec. The default value is 0.
+
+
+
+
+ DownDelaySec=
+
+ Specifies the delay before a link is disabled after a link down
+ status has been detected. This value is rounded down to a multiple of
+ MIIMonitorSec. The default value is 0.
+
+
+
+
+
+
Example
@@ -501,6 +639,7 @@ MACAddress=12:34:56:78:9a:bc
systemd1,
systemd-networkd8,
+ systemd.link5,
systemd.network5