summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Breunig <christian@breunig.cc>2026-09-16 04:50:29 +0000
committerChristian Breunig <christian@breunig.cc>2026-09-16 04:50:29 +0000
commit2823be3beaf38a938da1cb2c2cf811dd0c18f094 (patch)
tree1acdd99ae0a4dc56cf414d08fe610ed4b2e79e75
parentf1fef3e17f62c143bd2a98a2750bd54d8b7b19a1 (diff)
downloadvyos-documentation-T3871-ifname-store.tar.gz
vyos-documentation-T3871-ifname-store.zip
docs: T3871: drop hw-id from the example outputT3871-ifname-store
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.
-rw-r--r--docs/automation/vyos-api.md3
-rw-r--r--docs/cli.md14
-rw-r--r--docs/configexamples/inter-vrf-routing-vrf-lite.md1
-rw-r--r--docs/configexamples/zone-policy.md1
-rw-r--r--docs/configuration/interfaces/wireless.md2
-rw-r--r--docs/contributing/testing.md6
6 files changed, 3 insertions, 24 deletions
diff --git a/docs/automation/vyos-api.md b/docs/automation/vyos-api.md
index 224107f5..a2bd81ee 100644
--- a/docs/automation/vyos-api.md
+++ b/docs/automation/vyos-api.md
@@ -172,12 +172,10 @@ response (shortened)
"eth0": {
"address": "dhcp",
"duplex": "auto",
- "hw-id": "50:00:00:01:00:00",
"speed": "auto"
},
"eth1": {
"duplex": "auto",
- "hw-id": "50:00:00:01:00:01",
"speed": "auto"
...
},
@@ -416,7 +414,6 @@ response (shortened):
{
"success": true,
"data": "set interfaces ethernet eth0 address 'dhcp'\n
- set interfaces ethernet eth0 hw-id '50:00:00:01:00:00'\n
set system host-name 'vyos'\n
...",
"error": null
diff --git a/docs/cli.md b/docs/cli.md
index 0931c9d6..9a01bc64 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -218,7 +218,6 @@ vyos@vyos:~$ show configuration
interfaces {
ethernet eth0 {
address dhcp
- hw-id 00:53:00:00:aa:01
}
loopback lo {
}
@@ -279,7 +278,6 @@ Get a collection of all the set commands required which led to the running confi
:::{code-block} none
vyos@vyos:~$ show configuration commands
set interfaces ethernet eth0 address 'dhcp'
-set interfaces ethernet eth0 hw-id '00:53:dd:44:3b:0f'
set interfaces loopback 'lo'
set service ssh port '22'
set system config-management commit-revisions '20'
@@ -308,7 +306,7 @@ Use the `show configuration commands | strip-private` command when you want to h
View the current active configuration in JSON format.
:::{code-block} none
-{"interfaces": {"ethernet": {"eth0": {"address": ["192.0.2.11/24", "192.0.2.35/24"], "hw-id": "52:54:00:48:a0:c6"}, "eth1": {"address": ["203.0.113.1/24"], "hw-id": "52:54:00:fc:50:0b"}}, "loopback": {"lo": {}}}, "protocols": {"static": {"route": {"0.0.0.0/0": {"next-hop": {"192.0.2.254": {}}}}}}, "service": {"ssh": {"disable-host-validation": {}}}, "system": {"config-management": {"commit-revisions": "100"}, "console": {"device": {"ttyS0": {"speed": "115200"}}}, "host-name": "r11-vyos", "login": {"user": {"vyos": {"authentication": {"encrypted-password": "$6$Vt68...F0", "plaintext-password": "", "public-keys": {"vyos@vyos": {"key": "AAAAxxx=", "type": "ssh-rsa"}}}}}}, "name-server": ["203.0.113.254"], "ntp": {"server": {"time1.vyos.net": {}, "time2.vyos.net": {}, "time3.vyos.net": {}}}, "syslog": {"global": {"facility": {"all": {"level": "info"}, "protocols": {"level": "debug"}}}}, "time-zone": "America/New_York"}}
+{"interfaces": {"ethernet": {"eth0": {"address": ["192.0.2.11/24", "192.0.2.35/24"]}, "eth1": {"address": ["203.0.113.1/24"]}}, "loopback": {"lo": {}}}, "protocols": {"static": {"route": {"0.0.0.0/0": {"next-hop": {"192.0.2.254": {}}}}}}, "service": {"ssh": {"disable-host-validation": {}}}, "system": {"config-management": {"commit-revisions": "100"}, "console": {"device": {"ttyS0": {"speed": "115200"}}}, "host-name": "r11-vyos", "login": {"user": {"vyos": {"authentication": {"encrypted-password": "$6$Vt68...F0", "plaintext-password": "", "public-keys": {"vyos@vyos": {"key": "AAAAxxx=", "type": "ssh-rsa"}}}}}}, "name-server": ["203.0.113.254"], "ntp": {"server": {"time1.vyos.net": {}, "time2.vyos.net": {}, "time3.vyos.net": {}}}, "syslog": {"global": {"facility": {"all": {"level": "info"}, "protocols": {"level": "debug"}}}}, "time-zone": "America/New_York"}}
:::
```
@@ -324,14 +322,12 @@ View the current active configuration in readable JSON format.
"address": [
"192.0.2.11/24",
"192.0.2.35/24"
- ],
- "hw-id": "52:54:00:48:a0:c6"
+ ]
},
"eth1": {
"address": [
"203.0.113.1/24"
- ],
- "hw-id": "52:54:00:fc:50:0b"
+ ]
}
},
"loopback": {
@@ -461,7 +457,6 @@ vyos@vyos# show interfaces
ethernet eth0 {
description MY_OLD_DESCRIPTION
disable
- hw-id 00:53:dd:44:3b:03
}
loopback lo {
}
@@ -477,7 +472,6 @@ vyos@vyos# show interfaces
+ address dhcp
> description MY_NEW_DESCRIPTION
- disable
- hw-id 00:53:dd:44:3b:03
}
loopback lo {
}
@@ -489,7 +483,6 @@ mode using {cfgcmd}`show | commands`
``` none
vyos@vyos# show interfaces ethernet eth0 | commands
set address dhcp
-set hw-id 00:53:ad:44:3b:03
```
These commands are also relative to the level you are inside and only relevant
@@ -499,7 +492,6 @@ configuration blocks will be displayed when entering a sub-level.
[edit interfaces ethernet eth0]
vyos@vyos# show
address dhcp
- hw-id 00:53:ad:44:3b:03
```
Exiting from the configuration mode is done via the {cfgcmd}`exit` command from
diff --git a/docs/configexamples/inter-vrf-routing-vrf-lite.md b/docs/configexamples/inter-vrf-routing-vrf-lite.md
index 2ac36904..31854b5d 100644
--- a/docs/configexamples/inter-vrf-routing-vrf-lite.md
+++ b/docs/configexamples/inter-vrf-routing-vrf-lite.md
@@ -670,7 +670,6 @@ set protocols static route6 ::/0 next-hop 2001:db8::1
```none
set interfaces dummy dum0 address '172.16.0.1/24'
set interfaces dummy dum0 address '2001:db8:0:2::1/64'
-set interfaces ethernet eth0 hw-id '50:00:00:03:00:00'
set interfaces ethernet eth1 address '172.16.2.2/30'
set interfaces ethernet eth1 address '2001:db8::3/127'
set protocols static route 0.0.0.0/0 next-hop 172.16.2.1
diff --git a/docs/configexamples/zone-policy.md b/docs/configexamples/zone-policy.md
index 2cd773a9..3f899927 100644
--- a/docs/configexamples/zone-policy.md
+++ b/docs/configexamples/zone-policy.md
@@ -54,7 +54,6 @@ It will look something like this:
interfaces {
ethernet eth0 {
duplex auto
- hw-id 00:53:ed:6e:2a:92
smp_affinity auto
speed auto
vif 10 {
diff --git a/docs/configuration/interfaces/wireless.md b/docs/configuration/interfaces/wireless.md
index 9e6b7c99..057ff9e1 100644
--- a/docs/configuration/interfaces/wireless.md
+++ b/docs/configuration/interfaces/wireless.md
@@ -803,7 +803,6 @@ interfaces {
}
channel 11
description "802.11ax 2.4GHz"
- hw-id [...]
mode ax
physical-device phy0
security {
@@ -884,7 +883,6 @@ interfaces {
channel 5
description "802.11ax 6GHz"
enable-bf-protection
- hw-id [...]
mgmt-frame-protection required
mode ax
physical-device phy0
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
-}