Custom network interface names - Revision history

Prabuanand: fixed wikilink

2025-09-16T08:21:50Z

fixed wikilink

← Older revision		Revision as of 08:21, 16 September 2025
Line 1:		Line 1:
	#REDIRECT [[~~mdev~~]]		#REDIRECT [[Mdev#Custom_network_interface_name]]

Prabuanand: moved content to mdev page

2025-09-16T04:42:21Z

moved content to mdev page

← Older revision		Revision as of 04:42, 16 September 2025
Line 1:		Line 1:
	~~{{Merge\|mdev\|This could be part of a "configuring mdev" section in the mdev article}}~~		#REDIRECT [[mdev]]

	~~This article shows how to rename/change name of a network interface.~~

	Alpine Linux uses {{pkg\|busybox}} ''mdev'' by default to manage devices in {{path\|/dev}}. ''mdev'' reads {{path\|/etc/mdev.conf}} and according to [https://git.busybox.net/busybox/plain/docs/mdev.txt mdev documentation] one can define a command to be executed per device definition. The command which is going to be used to change network interface name is ''nameif''.

	~~== {{path\|/etc/mdev.conf}} configuration ==~~
	~~{{cat\|/etc/mdev.conf\|<nowiki>-SUBSYSTEM=net;DEVPATH=./net/.;.* root:root 600 @/sbin/nameif -s</nowiki>}}~~

	~~Here we tell ''mdev'' to call ''nameif'' for devices found in {{path\|/sys/class/net/}}.~~

	{{cmd\|# ls -d -C -1 /sys/class/net/eth*
	~~/sys/class/net/eth1~~
	~~/sys/class/net/eth2~~
	~~/sys/class/net/eth3~~
	~~/sys/class/net/eth4~~
	~~/sys/class/net/eth5~~
	}}

	~~== ''nameif'' configuration ==~~

	~~''nameif'' itself reads {{path\|/etc/mactab}} by default. Example line for a network interface with following hwaddr~~

	~~{{cmd\|# cat /sys/class/net/eth0/address~~
	~~90:e2:ba:04:28:c0~~
	}}

	~~would be~~

	~~{{cmd\|# grep 90:e2:ba:04:28:c0 /etc/mactab~~
	~~dmz0 90:e2:ba:04:28:c0~~
	}}

	~~== ramdisk rebuild ==~~

	~~{{path\|/etc/mdev.conf}} is part of ramdisk~~

	~~{{cmd\|~~# ~~grep /etc/mdev.conf /etc/mkinitfs/features.d/*.files~~
	~~/etc/mkinitfs/features.d/base.files:/etc/mdev.conf~~
	}}

	~~thus we need to rebuild ramdisk~~

	~~{{cmd\|<nowiki># mkinitfs $(ls /lib/modules/)~~
	~~==> initramfs: creating /boot/initramfs-lts~~
	~~</nowiki>}}~~

	~~== finalization ==~~

	~~To use renamed network interface without reboot, just call ''nameif'' while the network interface is down.~~

	~~{{cmd\|# nameif -s}}~~

	~~And finally reboot...~~

	[[~~Category:Networking~~]]

Sertonix: add merging request

2023-09-22T12:26:54Z

add merging request

← Older revision		Revision as of 12:26, 22 September 2023
Line 1:		Line 1:
			{{Merge\|mdev\|This could be part of a "configuring mdev" section in the mdev article}}

	This article shows how to rename/change name of a network interface.		This article shows how to rename/change name of a network interface.

Sertonix: use pkg, path, cat & cmd template

2023-09-22T10:17:06Z

use pkg, path, cat & cmd template

← Older revision		Revision as of 10:17, 22 September 2023
Line 1:		Line 1:
	This article shows how to rename/change name of a network interface.		This article shows how to rename/change name of a network interface.

	Alpine Linux uses ''busybox'' ''mdev'' to manage devices in ''/dev''. ''mdev'' reads ''/etc/mdev.conf'' and according to [https://git.busybox.net/busybox/plain/docs/mdev.txt mdev documentation] one can define a command to be executed per device definition. The command which is going to be used to change network interface name is ''nameif''.		Alpine Linux uses {{pkg\|busybox}} ''mdev'' by default to manage devices in {{path\|/dev}}. ''mdev'' reads {{path\|/etc/mdev.conf}} and according to [https://git.busybox.net/busybox/plain/docs/mdev.txt mdev documentation] one can define a command to be executed per device definition. The command which is going to be used to change network interface name is ''nameif''.

	== ''/etc/mdev.conf'' configuration ==		== {{path\|/etc/mdev.conf}} configuration ==
	<~~pre~~>		{{cat\|/etc/mdev.conf\|<nowiki>-SUBSYSTEM=net;DEVPATH=./net/.;.* root:root 600 @/sbin/nameif -s</nowiki>}}
	-SUBSYSTEM=net;DEVPATH=./net/.;.* root:root 600 @/sbin/nameif -s
	</~~pre~~>

	Here we tell ''mdev'' to call ''nameif'' for devices found in ''/sys/class/net/''.		Here we tell ''mdev'' to call ''nameif'' for devices found in {{path\|/sys/class/net/}}.

	~~<pre>~~		{{cmd\|# ls -d -C -1 /sys/class/net/eth*
	# ls -d -C -1 /sys/class/net/eth*
	/sys/class/net/eth1		/sys/class/net/eth1
	/sys/class/net/eth2		/sys/class/net/eth2
Line 17:		Line 14:
	/sys/class/net/eth4		/sys/class/net/eth4
	/sys/class/net/eth5		/sys/class/net/eth5
	~~</pre>~~		}}

	== ''nameif'' configuration ==		== ''nameif'' configuration ==

	''nameif'' itself reads ''/etc/mactab'' by default. Example line for a network interface with following hwaddr		''nameif'' itself reads {{path\|/etc/mactab}} by default. Example line for a network interface with following hwaddr

	~~<pre>~~		{{cmd\|# cat /sys/class/net/eth0/address
	# cat /sys/class/net/eth0/address
	90:e2:ba:04:28:c0		90:e2:ba:04:28:c0
	~~</pre>~~		}}

	would be		would be

	~~<pre>~~		{{cmd\|# grep 90:e2:ba:04:28:c0 /etc/mactab
	# grep 90:e2:ba:04:28:c0 /etc/mactab
	dmz0 90:e2:ba:04:28:c0		dmz0 90:e2:ba:04:28:c0
	~~</pre>~~		}}

	== ramdisk rebuild ==		== ramdisk rebuild ==

	''/etc/mdev.conf'' is part of ramdisk		{{path\|/etc/mdev.conf}} is part of ramdisk

	~~<pre>~~		{{cmd\|# grep /etc/mdev.conf /etc/mkinitfs/features.d/*.files
	# grep /etc/mdev.conf /etc/mkinitfs/features.d/*.files
	/etc/mkinitfs/features.d/base.files:/etc/mdev.conf		/etc/mkinitfs/features.d/base.files:/etc/mdev.conf
	~~</pre>~~		}}

	thus we need to rebuild ramdisk		thus we need to rebuild ramdisk

	<~~pre~~>		{{cmd\|<nowiki># mkinitfs $(ls /lib/modules/)
	# mkinitfs $(ls /lib/modules/)
	==> initramfs: creating /boot/initramfs-lts		==> initramfs: creating /boot/initramfs-lts
	</~~pre~~>		</nowiki>}}

	== finalization ==		== finalization ==
Line 55:		Line 48:
	To use renamed network interface without reboot, just call ''nameif'' while the network interface is down.		To use renamed network interface without reboot, just call ''nameif'' while the network interface is down.

	~~<pre>~~		{{cmd\|# nameif -s}}
	# nameif -s
	~~</pre>~~

	And finally reboot...		And finally reboot...

	[[Category:Networking]]		[[Category:Networking]]

Oleksandr: /* /etc/mdev.conf configuration */

2020-12-05T10:11:41Z

/etc/mdev.conf configuration

← Older revision		Revision as of 10:11, 5 December 2020
Line 5:		Line 5:
	== ''/etc/mdev.conf'' configuration ==		== ''/etc/mdev.conf'' configuration ==
	<pre>		<pre>
	-net/.* root:root 600 @/sbin/nameif -s		-SUBSYSTEM=net;DEVPATH=./net/.;.* root:root 600 @/sbin/nameif -s
	</pre>		</pre>

Jirib79: Created page with "This article shows how to rename/change name of a network interface. Alpine Linux uses ''busybox'' ''mdev'' to manage devices in ''/dev''. ''mdev'' reads ''/etc/mdev.conf'' a..."

2020-05-08T19:34:34Z

Created page with "This article shows how to rename/change name of a network interface. Alpine Linux uses ''busybox'' ''mdev'' to manage devices in ''/dev''. ''mdev'' reads ''/etc/mdev.conf'' a..."

New page

This article shows how to rename/change name of a network interface.

Alpine Linux uses ''busybox'' ''mdev'' to manage devices in ''/dev''. ''mdev'' reads ''/etc/mdev.conf'' and according to [https://git.busybox.net/busybox/plain/docs/mdev.txt mdev documentation] one can define a command to be executed per device definition. The command which is going to be used to change network interface name is ''nameif''.

== ''/etc/mdev.conf'' configuration ==
<pre>
-net/.* root:root 600 @/sbin/nameif -s
</pre>

Here we tell ''mdev'' to call ''nameif'' for devices found in ''/sys/class/net/''.

<pre>
# ls -d -C -1 /sys/class/net/eth*
/sys/class/net/eth1
/sys/class/net/eth2
/sys/class/net/eth3
/sys/class/net/eth4
/sys/class/net/eth5
</pre>

== ''nameif'' configuration ==

''nameif'' itself reads ''/etc/mactab'' by default. Example line for a network interface with following hwaddr

<pre>
# cat /sys/class/net/eth0/address
90:e2:ba:04:28:c0
</pre>

would be

<pre>
# grep 90:e2:ba:04:28:c0 /etc/mactab
dmz0 90:e2:ba:04:28:c0
</pre>

== ramdisk rebuild ==

''/etc/mdev.conf'' is part of ramdisk

<pre>
# grep /etc/mdev.conf /etc/mkinitfs/features.d/*.files
/etc/mkinitfs/features.d/base.files:/etc/mdev.conf
</pre>

thus we need to rebuild ramdisk

<pre>
# mkinitfs $(ls /lib/modules/)
==> initramfs: creating /boot/initramfs-lts
</pre>

== finalization ==

To use renamed network interface without reboot, just call ''nameif'' while the network interface is down.

<pre>
# nameif -s
</pre>

And finally reboot...

[[Category:Networking]]