nameif(8)

nameif8

Name network interfaces based on mac addresses

Usage

nameif [-c configfile] [-s]

nameif [-c configfile] [-s] interface macaddress

Overview

nameif renames network interfaces based on mac addresses. When no arguments are given /etc/mactab is read. Each line of it contains an interface name and a Ethernet MAC address. Comments are allowed starting with #. Otherwise the interfaces specified on the command line are processed. nameif looks for the interface with the given MAC address and renames it to the name given.

When the -s argument is given all error messages go to the syslog.

When the -c argument is given with a file name that file is read instead of /etc/mactab.

Notes

nameif should be run before the interface is up, otherwise it'll fail.

Files

/etc/mactab

Releases

13 releases since Debian 3.0 (Woody); the text changed 2 times.

  1. 3.0–4.0
  2. 5.0–8
  3. 9–Arch

Bugs

Only works for Ethernet currently.

From net-tools 2.10-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.