Debian Codegraph @

upstream/fedora-44/man8/nameif.8

raw
1 .TH NAMEIF 8 "2008\-10\-03" "net\-tools" "Linux System Administrator's Manual"
2 .SH NAME
3 nameif \- name network interfaces based on MAC addresses
4 .SH SYNOPSIS
5 .B "nameif [\-c configfile] [\-s]"
6 .br
7 .B "nameif [\-c configfile] [\-s] {interface macaddress}"
8
9 .SH NOTE
10 .P
11 This program is obsolete. For replacement check \fBip link\fR.
12 This functionality is also much better provided by udev methods.
13
14 .SH DESCRIPTION
15 .B nameif
16 renames network interfaces based on mac addresses. When no arguments are
17 given
18 .I /etc/mactab
19 is read. Each line of it contains an interface name and a Ethernet MAC
20 address. Comments are allowed starting with #.
21 Otherwise the interfaces specified on the command line are processed.
22 .I nameif
23 looks for the interface with the given MAC address and renames it to the
24 name given.
25
26 When the
27 .I \-s
28 argument is given all error messages go to the syslog.
29
30 When the
31 .I \-c
32 argument is given with a file name that file is read instead of /etc/mactab.
33
34 .SH NOTES
35 .I nameif
36 should be run before the interface is up, otherwise it'll fail.
37
38 .SH FILES
39 /etc/mactab
40
41 .SH SEE ALSO
42 .BR ip(8),
43 .BR udev(7)
44
45 .SH BUGS
46 Only works for Ethernet currently.