diff options
author | Lennart Poettering <lennart@poettering.net> | 2019-03-13 16:24:59 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2019-03-14 15:13:33 +0100 |
commit | 6cc68362d529ca8b99fd6ca55b0fc7143e696aea (patch) | |
tree | eef9d39ee49371f0a799a468f4dc846117fe29fb /man/systemd-nspawn.xml | |
parent | fba10579f1abb4a0f0a27ebb822bcfda72c9b22e (diff) | |
download | systemd-6cc68362d529ca8b99fd6ca55b0fc7143e696aea.tar.gz |
man: document the network interface size limits --network-veth= enforces
Fixes: #10721
Diffstat (limited to 'man/systemd-nspawn.xml')
-rw-r--r-- | man/systemd-nspawn.xml | 22 |
1 files changed, 17 insertions, 5 deletions
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 00c14eafeb..e4373ba691 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -614,6 +614,16 @@ <para>Note that <option>--network-veth</option> is the default if the <filename>systemd-nspawn@.service</filename> template unit file is used.</para> + + <para>Note that on Linux network interface names may have a length of 15 characters at maximum, while + container names may have a length up to 64 characters. As this option derives the host-side interface + name from the container name the name is possibly truncated. Thus, care needs to be taken to ensure + that interface names remain unique in this case, or even better container names are generally not + chosen longer than 12 characters, to avoid the truncation. Alternatively, the + <option>--network-veth-extra=</option> option may be used, which allows free configuration of the + host-side interface name independently of the container name — but might require a bit more + additional configuration in case bridging in a fashion similar to <option>--network-bridge=</option> + is desired.</para> </listitem> </varlistentry> @@ -635,11 +645,13 @@ <varlistentry> <term><option>--network-bridge=</option></term> - <listitem><para>Adds the host side of the Ethernet link created with <option>--network-veth</option> to the - specified Ethernet bridge interface. Expects a valid network interface name of a bridge device as - argument. Note that <option>--network-bridge=</option> implies <option>--network-veth</option>. If this option - is used, the host side of the Ethernet link will use the <literal>vb-</literal> prefix instead of - <literal>ve-</literal>.</para></listitem> + <listitem><para>Adds the host side of the Ethernet link created with <option>--network-veth</option> + to the specified Ethernet bridge interface. Expects a valid network interface name of a bridge device + as argument. Note that <option>--network-bridge=</option> implies <option>--network-veth</option>. If + this option is used, the host side of the Ethernet link will use the <literal>vb-</literal> prefix + instead of <literal>ve-</literal>. Regardless of the used naming prefix the same network interface + name length limits imposed by Linux apply, along with the complications this creates (for details see + above).</para></listitem> </varlistentry> <varlistentry> |