share/man/man5/ethers.5

   1 .\"     $NetBSD: ethers.5,v 1.8 2001/06/19 12:34:27 wiz Exp $
   2 .\"
   3 .\"     Written by Roland McGrath <roland@frob.com>.  Public domain.
   4 .\"
   5 .Dd November 7, 2000
   6 .Dt ETHERS 5
   7 .Os
   8 .Sh NAME
   9 .Nm ethers
  10 .Nd Ethernet host name data base
  11 .Sh DESCRIPTION
  12 The
  13 .Nm
  14 file maps Ethernet MAC addresses to host names.
  15 Lines consist of an address and a host name, separated by any number
  16 of blanks and/or tab characters.
  17 A
  18 .Sq \&#
  19 character indicates the beginning of a comment;
  20 characters up to the end of
  21 the line are not interpreted by routines which search the file.
  22 .Pp
  23 Each line in
  24 .Nm
  25 has the format:
  26 .Dl ethernet-MAC-address hostname-or-IP
  27 .Pp
  28 Ethernet MAC addresses are expressed as six hexadecimal numbers separated
  29 by colons, e.g. "08:00:20:00:5a:bc".
  30 The functions described in
  31 .Xr ethers 3
  32 and
  33 .Xr ether_aton 3
  34 can read and produce this format.
  35 .Pp
  36 The traditional use of
  37 .Nm
  38 involved using hostnames for the second argument.
  39 This may not be suitable for machines that don't have a common MAC
  40 address for all interfaces (i.e., just about every non
  41 .Tn Sun
  42 machine).
  43 There should be no problem in using an IP address as the second field
  44 if you wish to differentiate between different interfaces on a system.
  45 .Sh FILES
  46 .Bl -tag -width /etc/ethers -compact
  47 .It Pa /etc/ethers
  48 The
  49 .Nm
  50 file resides in
  51 .Pa /etc .
  52 .El
  53 .Sh SEE ALSO
  54 .Xr ethers 3
  55 .Sh HISTORY
  56 The
  57 .Nm ethers
  58 file format was adopted from
  59 .Tn SunOS
  60 and appeared in
  61 .Nx 1.0 .
  62 .Sh BUGS
  63 A name server should be used instead of a static file.