Hello all, (This is a kind ping for systemd maintainers.) Before finalising the wording for the release notes, we would like to know if we understood correctly this new network interface naming method. I would like to add a quick note about it in the "installing" chapter, and a full explanation in "whats-new". Below are the questions from last month, and atttached is an updated patch for the release notes. Thanks for your work, and your answers. Dixit Baptiste Jammet, le 25/03/2017 : >Hello systemd maintainers, > >We [1] are trying to find good words to put in the release notes about >the new network interfaces naming scheme. >See the proposed text below, with 3 associated questions: > >Dixit Vincent McIntyre, le 22/03/2017 : > >>+<!-- new in Stretch--> >>+<varlistentry> >>+<term>New method for naming network interfaces</term> >>+<listitem> >>+<para> >>+The installer and newly installed systems will use a different >>+naming scheme for network interfaces instead of eth0, eth1 etc. >>+The old naming method suffered from enumeration race conditions >>+that made it possible for interface names to change unexpectedly >>+and is incompatible with mounting the root filesystem read-only. >>+The new enumeration method relies on more sources of information, >>+to produce a more repeatable outcome. It uses the firmware/BIOS >>+provided index numbers and then tries PCI card slot numbers, >>+producing names line ens0 or enp1s1 (ethernet) or wlp3s0 (wlan). >>+USB devices, which can be added to the system at any time, >>+will have names based upon their ethernet MAC addresses. >>+</para> >>+<para> >>+This change does not apply to upgrades of jessie systems, >>+the naming will continue to be enforced by >>+/etc/udev/rules.d/70-persistent-net.rules. >>+For more information, see /usr/share/doc/udev/README.Debian.gz >>+</para> >>+</listitem> >>+</varlistentry> >> >> >>My suggested text above is far from the final word here >>and I have questions: >> * Is it even accurate? >> * How are the firmware/BIOS and PCI slot methods that were discussed >> related to the NamePolicy methods in the udev file: >> NamePolicy=kernel database onboard mac >> * Is biosdevname still out of the picture? > >Thanks for your answer. > >Baptiste >[1]https://lists.debian.org/msgid-search/20170319173153.1eda2037.baptiste@mailoo.org >
Index: en/installing.dbk
===================================================================
--- en/installing.dbk (révision 11441)
+++ en/installing.dbk (copie de travail)
@@ -185,6 +185,21 @@
</listitem>
</varlistentry>
+<!-- new in Stretch-->
+<varlistentry>
+<term>New method for naming network interfaces</term>
+<listitem>
+<para>
+The installer and the installed systems use a different
+naming scheme for network interfaces.
+<literal>ens0</literal> or <literal>enp1s1</literal> (ethernet)
+or <literal>wlp3s0</literal> (wlan) will replace the
+legacy <literal>eth0</literal>, <literal>eth1</literal> etc.
+See <xref linkend="new-interface-names"/> for more informations.
+</para>
+</listitem>
+</varlistentry>
+
</variablelist>
</section>
Index: en/whats-new.dbk
===================================================================
--- en/whats-new.dbk (révision 11441)
+++ en/whats-new.dbk (copie de travail)
@@ -505,5 +505,33 @@
package in the main archive instead of the new dbgsym.
</para>
</section>
+
+<section id="new-interface-names">
+<!--Jessie to Stretch-->
+<title>New method for naming network interfaces</title>
+<para>
+The installer and newly installed systems will use a different
+naming scheme for network interfaces instead of <literal>eth0</literal>,
+<literal>eth1</literal> etc.
+The old naming method suffered from enumeration race conditions
+that made it possible for interface names to change unexpectedly
+and is incompatible with mounting the root filesystem read-only.
+The new enumeration method relies on more sources of information,
+to produce a more repeatable outcome. It uses the firmware/BIOS
+provided index numbers and then tries PCI card slot numbers,
+producing names like <literal>ens0</literal> or <literal>enp1s1</literal>
+(ethernet) or <literal>wlp3s0</literal> (wlan).
+USB devices, which can be added to the system at any time,
+will have names based upon their ethernet MAC addresses.
+</para>
+<para>
+This change does not apply to upgrades of jessie systems,
+the naming will continue to be enforced by
+<filename>/etc/udev/rules.d/70-persistent-net.rules</filename>.
+For more information, see
+<filename>/usr/share/doc/udev/README.Debian.gz</filename>
+</para>
</section>
+
+</section>
</chapter>
Attachment:
pgpI2kPsbhZFE.pgp
Description: OpenPGP digital signature