From f939f4eb05f55e7e4c81e1b5dc954c3fc06d2389 Mon Sep 17 00:00:00 2001 From: Christian Breunig Date: Sat, 31 Oct 2026 11:53:23 +0100 Subject: T3871: bind interface names to hardware slots instead of hw-id (#2246) * docs: T3871: describe how interface names are assigned Names are no longer derived from the hw-id node. They are bound to the slot the hardware occupies and recorded in a mapping file, so document what decides a name, what happens when a card is replaced or added, and how to rename an interface. The troubleshooting page said to pin a MAC with hw-id when interfaces were renamed after a VM migration or a clone. That node no longer exists and the situation it describes no longer arises, so replace it with a pointer to the new section and a note on where to look when an interface really is missing. * docs: T3871: drop hw-id from the example output The node is gone from the CLI, so example configuration dumps which still show it no longer match what a reader sees on their own system. Remove it from the shown output only; no prose changes. The comparison shown on the testing page is rewritten rather than trimmed, as deleting the lines would have left an edit level behind with nothing under it. --- docs/contributing/testing.md | 6 ------ 1 file changed, 6 deletions(-) (limited to 'docs/contributing/testing.md') diff --git a/docs/contributing/testing.md b/docs/contributing/testing.md index b68cad1b..46e6a881 100644 --- a/docs/contributing/testing.md +++ b/docs/contributing/testing.md @@ -178,16 +178,10 @@ Loading configuration from '/usr/libexec/vyos/tests/config/ospf-small' Load complete. Use 'commit' to make changes effective. [edit] vyos@vyos# compare -[edit interfaces ethernet eth0] --hw-id 00:50:56:bf:c5:6d [edit interfaces ethernet eth1] +duplex auto --hw-id 00:50:56:b3:38:c5 +speed auto [edit interfaces] --ethernet eth2 { -- hw-id 00:50:56:b3:9c:1d --} -vti vti1 { - address 192.0.2.1/30 -} -- cgit v1.2.3