summaryrefslogtreecommitdiff
path: root/docs
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 /docs
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.
Diffstat (limited to 'docs')
-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
-}