[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: New network interface names (Was: Re: Installing chapter in the release notes)



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: pgpdEXNczIQ0v.pgp
Description: OpenPGP digital signature


Reply to: