يُعيّن هذا الاسم بناءً على معلومات الترتيب الرقمي المقدمة من البرامج الثابتة للأجهزة المدمجة. تُستخدم أنظمة مختلفة اعتمادًا على نوع البرامج الثابتة، كما هو موصوف في الجدول أدناه.

جدول 2. أنظمة تسمية الأجهزة المدمجة

Format	الوصف
بادئةoرقم	فهرس PCI المدمج
بادئةdرقم	فهرس الاسم المستعار لشجرة الجهاز

أُضيف في الإصدار 243.

تُعيَّن هذه الخاصية استنادًا إلى التسمية النصية التي يُقدمها البرنامج الثابت للأجهزة المدمجة. هذا متاح فقط لأجهزة PCI.

أُضيف في الإصدار 243.

يتكون هذا الاسم من البادئة، والحرف x، و12 رقمًا سداسيًا عشريًا لعنوان MAC. يكون متاحًا إذا كان للجهاز عنوان MAC ثابت. نظرًا لأن هذا الاسم يعتمد على سمة من سمات البطاقة نفسها، فإنه يظل "مستقرًا" عند نقل الجهاز (حتى بين الأجهزة)، ولكنه يتغير عند استبدال العتاد.

أُضيف في الإصدار 243.

تصف هذه الخاصية موضع الفتحة. تُستخدم مخططات مختلفة اعتمادًا على نوع الناقل، كما هو موضح في الجدول أدناه. في حالة أجهزة USB وBCMA وSR-VIO، يتكون الاسم الكامل من البادئة ومعرّف فتحة PCI ومعرّف فتحة USB أو BCMA أو SR-VIO. يُشار إلى الجزأين الأولين بالرمز "..." في الجدول أدناه.

الجدول 3. مخططات تسمية الفتحات

Format	الوصف
prefix [Pdomain] sslot [ffunction] [nport_name | ddev_port]	رقم فتحة PCI
prefix vslot	رقم فتحة VIO (IBM PowerVM)
prefix Xnumber	رقم واجهة VIF (Xen)
... bnumber	رقم نواة ناقل Broadcom (BCMA)
... uport... [cconfig] [iinterface]	سلسلة أرقام منافذ USB
... vslot	رقم فتحة SR-VIO
... rslot	رقم فتحة SR-IOV
... Ssfnum	رقم الوظيفة الفرعية المساعدة (SF)

يُسبق نطاق PCI فقط عندما لا يكون 0. ستحمل جميع أجهزة PCI متعددة الوظائف رقم ffunction في اسم الجهاز، بما في ذلك جهاز الوظيفة 0. بالنسبة للأجهزة غير متعددة الوظائف، يُحذف الرقم إذا كان 0. يُستخدم اسم المنفذ port_name، أو رقم المنفذ ddev_port إذا كان الاسم غير معروف.

بالنسبة لأجهزة BCMA، يُحذف رقم النواة عندما يكون 0.

بالنسبة لأجهزة USB، تُؤلف السلسلة الكاملة لأرقام منافذ الموزعات. إذا أصبح الاسم أطول من الحد الأقصى البالغ 15 حرفًا، لا يُصدر الاسم. تُحذف القيم المعتادة لرقم تهيئة USB 1 ورقم الواجهة 0.

تُسمى الأجهزة الافتراضية SR-IOV استنادًا إلى اسم الواجهة الأم، مع لاحقة v ورقم الجهاز الافتراضي، مع إزالة أي أصفار بادئة. يُتجاهل رقم الناقل.

تُسمى ممثلات الأجهزة الافتراضية SR-IOV استنادًا إلى اسم واجهة الجهاز المادي، مع لاحقة r ورقم الجهاز الافتراضي المرتبط بالممثلة المعينة، مع إزالة أي أصفار بادئة. يُتجاهل اسم المنفذ المادي ورقم الناقل.

أجهزة الشبكة ذات الوظيفة الفرعية المساعدة (SF)، حيث يكون الأصل لجهاز الشبكة هو جهاز مساعد يعرض سمة sfnum sysfs (حاليًا mlx5_core SFs)، تُسمى استنادًا إلى وظيفة PCI الأساسية (PF، أو بالنسبة لـ VF-SF، PF خلف VF)، مع لاحقة S ورقم الوظيفة الفرعية المعرّف من قبل المستخدم من sfnum. هذا مشابه لكيفية تسمية أجهزة الوظيفة الافتراضية SR-IOV بلاحقة v.

إذا كانت وظيفة PCI الأصل لـ SF نفسها وظيفة افتراضية SR-IOV (VF-SF)، فإن الاسم يُجذر عند PF وتُسلسل كلتا اللاحقتين، مع لاحقة v تسبق لاحقة S (مثل "enp193s0f0v0S88"). لذلك، تشكل PF وVF وSF تسلسلاً هرميًا مستقرًا بغض النظر عن ترقيم ناقل/جهاز/وظيفة PCI الأساسي لـ VF.

في بعض التهيئات، قد يرتبط جسر PCI أب لوحدة تحكم شبكة معينة بفتحة. في هذه الحالة، لا نُولّد خاصية الجهاز هذه لتجنب تعارضات التسمية المحتملة.

أُضيف في الإصدار 243.

تصف هذه الخاصية موقع تثبيت الجهاز. تُستخدم مخططات مختلفة اعتمادًا على نوع الناقل، كما هو موصوف في الجدول أدناه. لأجهزة BCMA وUSB، يجب معرفة معلومات مسار PCI، ويتكون الاسم الكامل من البادئة، ومعرف فتحة PCI، وموقع USB أو BCMA. يُشار إلى الجزأين الأولين بـ "..." في الجدول أدناه.

الجدول 4. مخططات تسمية المسار

Format	الوصف
prefix cbus_id	معرف جهاز CCW أو CCW المجمّع
prefix avendor model iinstance	أسماء مسار ACPI لأجهزة منصة ARM64
prefix iaddress nport_name	رقم جهاز Netdevsim (جهاز شبكة محاكى) واسم المنفذ
prefix [Pdomain] pbus sslot [ffunction] [nphys_port_name | ddev_port]	الموقع الجغرافي PCI
... bnumber	رقم نواة ناقل Broadcom (BCMA)
... uport... [cconfig] [iinterface]	سلسلة أرقام منافذ USB
... Ssfnum	رقم الوظيفة الفرعية المساعدة (SF)

توجد أجهزة CCW وCCW المجمّعة في الحواسيب الرئيسية IBM System Z. تُحذف أي أصفار ونقاط بادئة.

لأجهزة PCI وBCMA وUSB، تُستخدم نفس القواعد الموصوفة أعلاه لتسمية الفتحة.

أُضيف في الإصدار 243.

هذا هو مخطط التسمية الذي طُبق في systemd 238.

أُضيف في الإصدار 243.

غُيرت التسمية لواجهات الشبكة الافتراضية المنشأة باستخدام SR-IOV وNPAR وللأجهزة التي لا يحتوي فيها جهاز تحكم الشبكة PCI على رقم فتحة مرتبط.

تُسمى الأجهزة الافتراضية SR-IOV بناءً على اسم الواجهة الأم، مع لاحقة "vport"، حيث port هو رقم الجهاز الافتراضي. سابقًا، كانت تلك الأجهزة الافتراضية تُسمى كما لو كانت مستقلة تمامًا.

تُسمى الأجهزة الافتراضية NPAR التاسعة وما بعدها وفقًا للمخطط المستخدم لأقسام NPAR الثمانية الأولى. سابقًا، لم تُعاد تسمية تلك الأجهزة وكان المبدئي للنواة ("ethN") يُستخدم.

تُولد الأسماء أيضًا لأجهزة PCI حيث لا يحتوي جهاز تحكم الشبكة PCI نفسه على رقم فتحة مرتبط، ولكن أحد أجهزته الأم يمتلكه. سابقًا، لم تُعاد تسمية تلك الأجهزة وكان المبدئي للنواة يُستخدم.

أُضيف في الإصدار 243.

أُدخلت البادئة "ib" والأسماء المستقرة لأجهزة infiniband. سابقًا، لم تُعاد تسمية تلك الأجهزة.

حقل فهرس ACPI (المستخدم في ID_NET_NAME_ONBOARD=) يُستخدم الآن أيضًا عندما يكون 0.

أُدخلت سياسة تسمية جديدة NamePolicy=keep. بهذه السياسة، إذا كان اسم جهاز الشبكة قد ضُبط مسبقًا بواسطة مساحة المستخدم، فلن يُعاد تسمية الجهاز مرة أخرى. سابقًا، كانت سياسة التسمية هذه تُطبق ضمنيًا، والآن يجب طلبها صراحةً. فعليًا، يعني هذا أن أجهزة الشبكة ستُعاد تسميتها وفقًا للتهيئة، حتى لو كانت قد أُعيدت تسميتها بالفعل، إذا لم يُحدد keep كسياسة تسمية في ملف .link. انظر systemd.link(5) لوصف NamePolicy=.

أُضيف في الإصدار 243.

وُسعت MACAddressPolicy=persistent لضبط عناوين MAC بناءً على اسم الجهاز. سابقًا، كانت العناوين تعتمد فقط على سمات ID_NET_NAME_*، مما يعني أن أسماء الواجهات لن تُولد أبدًا للأجهزة الافتراضية. الآن، سيُولد عنوان دائم لمعظم الأجهزة، بما في ذلك الجسور بشكل خاص.

ملاحظة: عندما لا تضبط مساحة المستخدم عنوان MAC لجهاز جسر، ستخصص النواة مبدئيًا عنوانًا عشوائيًا، ثم تغيره عندما يُربط أول جهاز بالجسر. مع تغيير سياسة التسمية هذا، تحصل الجسور على عنوان MAC دائم بناءً على اسم الجسر بدلاً من أول جهاز مربوط.

أُضيف في الإصدار 243.

تمت إضافة دعم إعادة تسمية أجهزة netdevsim (المحاكاة الشبكية). سابقًا، لم تكن تلك الأجهزة تُعاد تسميتها.

سابقًا، كانت بادئة نوع الواجهة المكونة من حرفين تُسبق إلى ID_NET_LABEL_ONBOARD=. لم يعد هذا يُفعل الآن.

أُضيف في الإصدار 243.

عندما يستمد systemd-nspawn(1) اسم الجانب المضيف لواجهة الشبكة المنشأة بـ --network-veth من اسم الحاوية، كان سابقًا يقطع النتيجة عند 15 حرفًا إذا كانت أطول (لأن هذا هو الحد الأقصى لأسماء واجهات الشبكة). من الآن فصاعدًا، لأي اسم واجهة سيكون أطول من 15 حرفًا، تُضبط آخر 4 أحرف على قيمة تجزئة 24 بت للاسم الكامل للواجهة. بهذه الطريقة، يجب أن تكون تصادمات أسماء واجهات الشبكة بين حاويات متعددة متشابهة التسمية (التي تختلف فقط في لاحقة اسم الحاوية) أقل احتمالًا (ولكنها لا تزال ممكنة، لأن قيمة التجزئة 24 بت صغيرة جدًا).

أُضيف في الإصدار 245.

عندما يُربط فتحة PCI بجسر PCI له وحدات تحكم شبكية فرعية متعددة، قد يُستمد نفس قيمة الخاصية ID_NET_NAME_SLOT لتلك الوحدات. هذا قد يسبب تعارضًا في التسمية إذا اختيرت الخاصية كاسم الجهاز. الآن، نكتشف هذه الحالة ولا ننتج الخاصية ID_NET_NAME_SLOT.

أُضيف في الإصدار 247.

أسماء فتحات PCI الساخنة لبرنامج تشغيل PCI s390 هي تمثيل سداسي عشري لخاصية الجهاز function_id. تُستخدم هذه الخاصية الآن لبناء ID_NET_NAME_SLOT. قبل ذلك، كانت جميع أسماء الفتحات تُحلل كأرقام عشرية، مما قد يؤدي إما إلى قيمة غير صحيحة للخاصية ID_NET_NAME_SLOT أو لا شيء على الإطلاق.

بعض تطبيقات البرامج الثابتة والمشرفين الافتراضيين تبلغ عن أرقام عالية بشكل غير معقول للفهرس المدمج. لمنع توليد أسماء واجهات مدمجة زائفة، تم تجاهل أرقام الفهرس الأكبر من 16381 (2¹⁴-1). لأجهزة PCI s390، قيم الفهرس حتى 65535 (2¹⁶-1) صالحة. لمراعاة ذلك، زيد الحد إلى 65535.

قاعدة udev(7) NAME= تستبدل ":" و "/" و "%" بشرطة سفلية ("_")، وترفض السلاسل التي تحتوي على أرقام فقط.

أُضيف في الإصدار 249.

أضيف مخطط تسمية لواجهات Xen netfront "vif" استنادًا إلى رقم VIF الجانب الضيف المُضبط من تكوين Xen (أو فهرس الواجهة في AWS EC2).

أُضيف في الإصدار 250.

منذ الإصدار v247، لم نعد نضبط ID_NET_NAME_SLOT إذا اكتشفنا أن جهاز PCI مرتبط بفتحة هو جسر PCI، لأن ذلك سيخلق تعارضًا في التسمية عندما تكون هناك أجهزة فرعية أكثر على ذلك الجسر. الآن، تم تخفيف هذا وسنستخدم معلومات الفتحة لتوليد الاسم استنادًا إليها ولكن فقط إذا كان جهاز PCI له وظائف متعددة. هذا آمن لأن رقم الوظيفة المميز هو جزء من اسم الجهاز للأجهزة متعددة الوظائف. ملاحظة: تم التراجع عن هذا في v255. انظر أدناه.

أُضيف في الإصدار 251.

أضيف مخطط تسمية لأجهزة المنصة مع أسماء مستعارة لشجرة الأجهزة.

أُضيف في الإصدار 252.

ضبط ID_NET_NAME_PATH لأجهزة USB غير المتصلة عبر ناقل PCI.

أُضيف في الإصدار 253.

تغيرت التسمية لممثلي الأجهزة الافتراضية SR-IOV، قابلة للضبط اختياريًا في وقت التجميع. أضيفت اللاحقة "rslot" لتمييز ممثلي الأجهزة الافتراضية SR-IOV المرفقين بواجهة جهاز مادي واحد. بسبب خطأ، كان هذا المخطط ليس المخطط المبدئي لإصدار systemd 254.

أُضيف في الإصدار 255.

تغيرت التسمية لممثلي الأجهزة الافتراضية SR-IOV لتمكين التغيير المُقدم في v254 بشكل مبدئي.

إذا اكتشفنا أن جهاز PCI مرتبط بفتحة هو جسر PCI، لم نعد نضبط ID_NET_NAME_SLOT، مع التراجع عن تغيير تم تقديمه في v251.

أُضيف في الإصدار 255.

يُقرأ رقم فتحة PCI الآن من ملف sysfs firmware_node/sun.

مُدد مخطط التسمية المستند إلى أسماء مستعارة لشجرة الأجهزة لدعم الأسماء المستعارة للواجهات الفردية لوحدات التحكم ذات المنافذ المتعددة.

أُضيف في الإصدار 257.

عندما لا يُطلب إعادة تسمية، الخاصية ID_NET_NAME تعادل الآن الخاصية INTERFACE.

أُضيف في الإصدار 258.

مُدد مخطط التسمية المستند إلى أسماء مستعارة لشجرة الأجهزة لدعم أجهزة WLAN.

أُضيف في الإصدار 259.

تُخصص الآن لواجهات MCTP أسماء دائمة، باستخدام بادئة mc.

أُضيف في الإصدار 260.

تُنشأ الآن أسماء مستقرة لأجهزة الشبكة ذات الوظيفة الفرعية المساعدة (SF) (مثل SFs "mlx5_core"). يُبنى الاسم من مسار وظيفة PCI الفعلية الأصل بلاحقة "Ssfnum"، حيث sfnum هو رقم SF المعرّف من قبل المستخدم (القيمة المُمررة إلى devlink port add ... sfnum N، التي يعرضها النواة كسمة sfnum sysfs على الجهاز المساعد). هذا مشابه للاحقة "vN" المستخدمة للوظائف الافتراضية SR-IOV؛ بالنسبة لـ SFs المستضافة على VFs SR-IOV (VF-SF)، تُسلسل اللاحقتان فوق الاسم الأساسي لـ PF.

أُضيف في الإصدار 261.

هذه الخاصية udev تضبط سياسة احتياطية لقراءة خاصية sysfs. إذا ضبطت على 0، لن يقرأ udev أي خاصية sysfs بشكل مبدئي، ما لم تكن مدرجة صراحة في القائمة المسموح بها، انظر أدناه. إذا ضبطت على 1، يمكن لـ udev استخدام أي خاصية sysfs ما لم تكن ممنوعة صراحة. القيمة المبدئية هي 1.

أُضيف في الإصدار 256.

هذه الخاصية udev تذكر صراحة ما إذا كان على udev استخدام sysfsattr المحدد، عند تكوين اسم الجهاز.

أُضيف في الإصدار 256.

$ udevadm test-builtin net_id /sys/class/net/enp0s31f6
...
Using default interface naming scheme 'v243'.
ID_NET_NAMING_SCHEME=v243
ID_NET_NAME_MAC=enx54ee75cb1dc0
ID_OUI_FROM_DATABASE=Wistron InfoComm(Kunshan)Co.,Ltd.
ID_NET_NAME_PATH=enp0s31f6
...

ID_NET_NAME_ONBOARD=eno1
ID_NET_NAME_ONBOARD_LABEL=Ethernet Port 1

# /sys/devices/pci0000:00/0000:00:1c.3/0000:05:00.0/net/ens1
ID_NET_NAME_MAC=enx000000000466
ID_NET_NAME_PATH=enp5s0
ID_NET_NAME_SLOT=ens1

# /sys/devices/pci0000:00/0000:00:1c.0/0000:02:00.0/net/enp2s0f0
ID_NET_NAME_MAC=enx78e7d1ea46da
ID_NET_NAME_PATH=enp2s0f0
# /sys/devices/pci0000:00/0000:00:1c.0/0000:02:00.1/net/enp2s0f1
ID_NET_NAME_MAC=enx78e7d1ea46dc
ID_NET_NAME_PATH=enp2s0f1

# /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlp3s0
ID_NET_NAME_MAC=wlx0024d7e31130
ID_NET_NAME_PATH=wlp3s0

# /sys/devices/pci0000:00/0000:00:03.0/0000:15:00.0/net/ibp21s0f0
ID_NET_NAME_PATH=ibp21s0f0
# /sys/devices/pci0000:00/0000:00:03.0/0000:15:00.1/net/ibp21s0f1
ID_NET_NAME_PATH=ibp21s0f1

# /sys/devices/pci0000:00/0000:00:1d.0/usb2/2-1/2-1.4/2-1.4:1.6/net/wwp0s29u1u4i6
ID_NET_NAME_MAC=wwx028037ec0200
ID_NET_NAME_PATH=wwp0s29u1u4i6

# /sys/devices/pci0000:00/0000:00:1d.0/usb2/2-1/2-1.2/2-1.2:1.0/net/enp0s29u1u2
ID_NET_NAME_MAC=enxd626b3450fb5
ID_NET_NAME_PATH=enp0s29u1u2

# /sys/devices/css0/0.0.0007/0.0.f5f0/group_device/net/encf5f0
ID_NET_NAME_MAC=enx026d3c00000a
ID_NET_NAME_PATH=encf5f0

/etc/udev/hwdb.d/50-net-naming-allowlist.hwdb
net:naming:drvirtio_net:*


  ID_NET_NAME_ALLOW=0


  ID_NET_NAME_ALLOW_ACPI_INDEX=1


  ID_NET_NAME_ALLOW_ADDR_ASSIGN_TYPE=1


  ID_NET_NAME_ALLOW_ADDRESS=1


  ID_NET_NAME_ALLOW_ARI_ENABLED=1


  ID_NET_NAME_ALLOW_DEV_PORT=1


  ID_NET_NAME_ALLOW_FUNCTION_ID=1


  ID_NET_NAME_ALLOW_IFLINK=1


  ID_NET_NAME_ALLOW_INDEX=1


  ID_NET_NAME_ALLOW_LABEL=1


  ID_NET_NAME_ALLOW_PHYS_PORT_NAME=1


  ID_NET_NAME_ALLOW_TYPE=1

/etc/udev/hwdb.d/50-net-naming-denylist.hwdb
net:naming:drvirtio_net:*


  ID_NET_NAME_ALLOW=1


  ID_NET_NAME_ALLOW_DEV_PORT=0


  ID_NET_NAME_ALLOW_PHYS_PORT_NAME=0