From 10848a3a836c0c3be067937f092aced4dcd50608 Mon Sep 17 00:00:00 2001 From: James Adams Date: Mon, 26 Oct 2026 20:23:58 +0000 Subject: [PATCH 1/2] alt-name: Improve wording Signed-off-by: James Adams --- features/alt-name.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/features/alt-name.md b/features/alt-name.md index a41a30a..51fa6ea 100644 --- a/features/alt-name.md +++ b/features/alt-name.md @@ -3,13 +3,13 @@ New feature in nmstate 2.2.51. Interface alternative name is a kernel property of network interface which is -treat equally as interface kernel name in netlink protocol. +treated equally to the interface kernel name by the netlink protocol. -Unlike kernel interface name limitation on 15 characters, alternative name -length limitation is 255(might change in the future by kernel team). +Unlike the kernel interface name limitation of 15 characters, interface alternative names +are limited to 255 characters (although this could be changed in the future by the kernel team). Like kernel interface name, alternative name should unique among all interface -names and all alternative names. Nmstate will raise error otherwise. +names and all alternative names. Nmstate will raise an error otherwise. Nmstate does not override existing alternative names, you can only append and remove explicitly. From a01d5df8caaed4f5fef1d5b4bb48af7f842866b0 Mon Sep 17 00:00:00 2001 From: James Adams Date: Mon, 26 Oct 2026 20:24:30 +0000 Subject: [PATCH 2/2] alt-name: Correct length limitation to 127 chars The 127 character limit comes from ALTIFNAMSIZ in include/uapi/linux/if.h in the linux kernel headers, it has not changed since it was first added (2019-10-01). Note that the length limit for interface aliases (IFALIASZ) is 255 characters, this may have been a source of confusion. Signed-off-by: James Adams --- features/alt-name.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/features/alt-name.md b/features/alt-name.md index 51fa6ea..9e33b04 100644 --- a/features/alt-name.md +++ b/features/alt-name.md @@ -6,7 +6,7 @@ Interface alternative name is a kernel property of network interface which is treated equally to the interface kernel name by the netlink protocol. Unlike the kernel interface name limitation of 15 characters, interface alternative names -are limited to 255 characters (although this could be changed in the future by the kernel team). +are limited to 127 characters (although this could be changed in the future by the kernel team). Like kernel interface name, alternative name should unique among all interface names and all alternative names. Nmstate will raise an error otherwise.