share/man/man5/ethers.5

   1 .\"     $OpenBSD: ethers.5,v 1.18 2007/05/31 19:19:58 jmc Exp $
   2 .\"     $NetBSD: ethers.5,v 1.2 1994/11/30 19:31:16 jtc Exp $
   3 .\"
   4 .\"     Written by Roland McGrath <roland@frob.com>.  Public domain.
   5 .\"
   6 .Dd $Mdocdate: May 31 2007 $
   7 .Dt ETHERS 5
   8 .Os
   9 .Sh NAME
  10 .Nm ethers
  11 .Nd Ethernet host name database
  12 .Sh DESCRIPTION
  13 The
  14 .Nm
  15 file maps Ethernet addresses to host names.
  16 Lines consist of an address and a host name, separated by any number
  17 of blanks and/or tab characters.
  18 A
  19 .Ql #
  20 indicates the beginning of a comment; characters up to the end of
  21 the line are not interpreted by routines which search the file.
  22 .Pp
  23 Ethernet addresses are expressed as six hexadecimal numbers separated by
  24 colons.
  25 The functions described in
  26 .Xr ethers 3
  27 can read and produce this format.
  28 .Pp
  29 The
  30 .Nm
  31 file has support for YP functionality,
  32 which is enabled by specifying a
  33 .Ql +
  34 alone on a line.
  35 .Sh FILES
  36 .Bl -tag -width /etc/ethers -compact
  37 .It Pa /etc/ethers
  38 .El
  39 .Sh SEE ALSO
  40 .Xr ethers 3 ,
  41 .Xr diskless 8
  42 .Sh HISTORY
  43 The
  44 .Nm
  45 file format was adopted from SunOS and appeared in
  46 .Nx
  47 0.9b.
  48 .Sh BUGS
  49 A name server should be used instead of a static file.
  50 .Pp
  51 Lines in
  52 .Pa /etc/ethers
  53 are limited to
  54 .Dv BUFSIZ
  55 characters
  56 .Pq currently 1024 .
  57 Longer lines will be ignored.