systemd/network/99-default.link

# SPDX-License-Identifier: MIT-0
#
# This config file is installed as part of systemd.
# It may be freely copied and edited (following the MIT No Attribution license).
#
# To make local modifications, use "networkctl edit". See networkctl(1) for details.
# This file should not be edited in place, because it'll be overwritten on upgrades.

[Match]
OriginalName=*

[Link]
NamePolicy=keep kernel database onboard slot path
AlternativeNamesPolicy=database onboard slot path mac
MACAddressPolicy=persistent
network: change license of examples to MIT-0 Arguably, CC0 is just fine for examples since they are not code. But it's easier to be consistent and just use MIT-0 for all "documentation". Thus, the license is changed similarly code examples under man/. Based on 'git shortlog -ns network/*' and 'git log -p', the following folks should ack this: Zbigniew Jędrzejewski-Szmek Lennart Poettering Tom Gundersen Yu Watanabe Daan De Meyer Marc-André Lureau 2022-10-26 06:34:13 +00:00			`# SPDX-License-Identifier: MIT-0`
Add SPDX license headers to various assorted files 2017-11-18 17:18:16 +00:00			`#`
network: license all config files as CC0 Same justification as the previous commit. $ for i in network/-; do git blame $i;done \| less shows that those files were written by Tom Gundersen, Lennart Poettering, Yu Watanabe, me, and Marc-André Lureau. 2022-01-11 16:52:35 +00:00			`# This config file is installed as part of systemd.`
network: change license of examples to MIT-0 Arguably, CC0 is just fine for examples since they are not code. But it's easier to be consistent and just use MIT-0 for all "documentation". Thus, the license is changed similarly code examples under man/. Based on 'git shortlog -ns network/*' and 'git log -p', the following folks should ack this: Zbigniew Jędrzejewski-Szmek Lennart Poettering Tom Gundersen Yu Watanabe Daan De Meyer Marc-André Lureau 2022-10-26 06:34:13 +00:00			`# It may be freely copied and edited (following the MIT No Attribution license).`
Add SPDX license headers to various assorted files 2017-11-18 17:18:16 +00:00			`#`
network: suggest using "networkctl edit" instead of copying manually 2024-04-23 11:51:07 +00:00			`# To make local modifications, use "networkctl edit". See networkctl(1) for details.`
network: license all config files as CC0 Same justification as the previous commit. $ for i in network/-; do git blame $i;done \| less shows that those files were written by Tom Gundersen, Lennart Poettering, Yu Watanabe, me, and Marc-André Lureau. 2022-01-11 16:52:35 +00:00			`# This file should not be edited in place, because it'll be overwritten on upgrades.`
Add SPDX license headers to various assorted files 2017-11-18 17:18:16 +00:00
udev,network: warn when .link or .network file has no [Match] section Closes #12098. 2019-04-20 12:40:24 +00:00			`[Match]`
			`OriginalName=*`

udev: link-config - move naming policy from udev rules This introduces a new key NamePolicy, which takes an ordered list of naming policies. The first successful one is applide. If all fail the value of Name (if any) is used. The possible policies are 'onboard', 'slot', 'path' and 'mac'. This patch introduces a default link file, which replaces the equivalent udev rule. 2013-10-27 23:19:59 +00:00			`[Link]`
link-config: add "keep" policy and use it by default If "keep" policy is specified, and the interface has a name that is NET_NAME_USER or NET_NAME_RENAMED, we stop processing rules. "keep" should probably be specified either first or last depending on the preference. This partially reimplements 55b6530baacf4658a183b15b010a8cf3483fde08, in the sense that if the "keep" policy is not specified, and if the interface has a NamingPolicy, it will be renamed, even if it had a name previously. So this breaks backwards compatibility in this case, but that's more in line with what users expect. Closes #9006. 2019-01-16 13:26:29 +00:00			`NamePolicy=keep kernel database onboard slot path`
Reapply "network: add "mac" to alternatives name policy by default" This reverts commit 152c8946b3a93bb2c086568832d614cb54f11e13. The kernel patch https://lore.kernel.org/linux-usb/20240605153340.25694-1-gmazyland@gmail.com/ is now in net-next branch, and will be hopefully merged soon. Note that Debian's 73-usb-net-by-mac.link now also supports the kernel patch: https://salsa.debian.org/systemd-team/systemd/-/commit/c1afbb2dc295929085be86072c7942c8517ec598 So, hopefully, the change is ready. Let's reapply it. 2024-06-11 18:53:12 +00:00			`AlternativeNamesPolicy=database onboard slot path mac`
udev: link-config - add mac address policy This introduces a new key MACAddressPolicy. The possible policies are 'persistent' and 'random'. 'persistent' will do nothing if the current address is the hardware address, but if the hardware does not have an address (or another address is set for whatever reason), we will generate an address which will be random, but persistent between boots (based on machineid and persistent netif name). 'random' will do nothing if the kernel already set a random address, otherwise it will generate a random one and use that instead. This patch sets MACAddressPolicy=persistent in the default .link file. 2013-10-27 23:19:59 +00:00			`MACAddressPolicy=persistent`