X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.netdev.xml;h=acd845498c0cef29dfdf07309948e2aeb57ef3cb;hp=48c6e726d3d1ee93b3d6a7dd56d9169473c0ba2e;hb=1836bf9e1d70240c8079e4db4312309f4f1f91fd;hpb=b35a29096045f2b820d343bfa24a35eb033930a2
diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml
index 48c6e726d..acd845498 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,
@@ -163,8 +166,9 @@
macvlan, vxlan,
ipip, gre,
sit, vti,
- veth are supported. This option
- is compulsory.
+ veth, tun,
+ tap and dummy
+ are supported. This option is compulsory.
@@ -339,6 +343,142 @@
+
+ [Tun] Section Options
+
+ The [Tun] section only applies for netdevs of kind
+ tun, and accepts the following keys:
+
+
+
+ OneQueue=
+ Takes a boolean argument. Configures whether
+ all packets are queued at the device (enabled), or a fixed number
+ of packets are queued at the device and the rest at the
+ qdisc. Defaults to no.
+
+
+
+ MultiQueue=
+ Takes a boolean argument. Configures whether to
+ use multiple file descriptors (queues) to parallelize packets
+ sending and receiving. Defaults to no.
+
+
+
+ PacketInfo=
+ Takes a boolean argument. Configures whether packets
+ should be prepened with four extra bytes (two flag bytes and two
+ protocol bytes). If disabled it indicates that the packets will be
+ pure IP packets. Defaults to no.
+
+
+
+ User=
+ User to grant access to the /dev/net/tun
+ device.
+
+
+
+ Group=
+ Group to grant access to the /dev/net/tun
+ device.
+
+
+
+
+
+
+
+
+ [Tap] Section Options
+
+ The [Tap] section only applies for netdevs of kind
+ tap, and accepts the same keys as the
+ [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
@@ -374,6 +514,15 @@ Local=192.168.223.238
Remote=192.169.224.239
TTL=64
+
+ /etc/systemd/network/tap.netdev
+ [NetDev]
+Name=tap-test
+Kind=tap
+
+[Tap]
+MultiQueue=true
+PacketInfo=true
/etc/systemd/network/sit.netdev
@@ -422,6 +571,14 @@ Kind=veth
Name=veth-peer
+
+ /etc/systemd/network/dummy.netdev
+ [NetDev]
+Name=dummy-test
+Kind=dummy
+MACAddress=12:34:56:78:9a:bc
+
+
See Also