proxmox-mirrors/pve-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pve-docs synced 2025-04-29 01:17:59 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

fix #5429: network: override device names: include Type=ether

Browse Source 
Mention that the systemd link file should contain `Type=ether` in most
setup, to make sure it only applies to Ethernet devices and does not
ever apply to e.g. bridges or bonds which inherit the MAC address of
the Ethernet device. Mention that some setups may require other
options.

Reported in the forum [0] and in #5429 [1].

[0] https://forum.proxmox.com/threads/144557/post-656188
[1] https://bugzilla.proxmox.com/show_bug.cgi?id=5429

Fixes: 96c0261 ("fix #4847: network: extend section on interface naming scheme")
Signed-off-by: Friedrich Weber <f.weber@proxmox.com>
This commit is contained in:
Friedrich Weber 2024-04-29 09:49:22 +02:00 committed by Thomas Lamprecht
parent 73c340dea7
commit 11a062af1b
1 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
pve-network.adoc
View File

@ -173,16 +173,25 @@ configured, including their naming.
To assign a name to a particular network device, you need a way to uniquely and
permanently identify that device in the `[Match]` section. One possibility is
to match the device's MAC address using the `MACAddress` option, as it is
unlikely to change. Then, you can assign a name using the `Name` option in the
`[Link]` section.
unlikely to change.
For example, to assign the name `enwan0` to the device with MAC address
`aa:bb:cc:dd:ee:ff`, create a file `/etc/systemd/network/10-enwan0.link` with
the following contents:
The `[Match]` section should also contain a `Type` option to make sure it only
matches the expected physical interface, and not bridge/bond/VLAN interfaces
with the same MAC address. In most setups, `Type` should be set to `ether` to
match only Ethernet devices, but some setups may require other choices. See the
https://manpages.debian.org/stable/udev/systemd.link.5.en.html[systemd.link(5)
manpage] for more details.
Then, you can assign a name using the `Name` option in the `[Link]` section.
For example, to assign the name `enwan0` to the Ethernet device with MAC
address `aa:bb:cc:dd:ee:ff`, create a file
`/etc/systemd/network/10-enwan0.link` with the following contents:
----
[Match]
MACAddress=aa:bb:cc:dd:ee:ff
Type=ether
[Link]
Name=enwan0