summaryrefslogtreecommitdiff
path: root/static/netbsd/man5/ethers.5
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
commit5cb84ec742fd33f78c8022863fadaa8d0d93e176 (patch)
tree1a81ca3665e6153923e40db7b0d988f8573ab59c /static/netbsd/man5/ethers.5
parenta59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff)
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man5/ethers.5')
-rw-r--r--static/netbsd/man5/ethers.563
1 files changed, 63 insertions, 0 deletions
diff --git a/static/netbsd/man5/ethers.5 b/static/netbsd/man5/ethers.5
new file mode 100644
index 00000000..5a04df30
--- /dev/null
+++ b/static/netbsd/man5/ethers.5
@@ -0,0 +1,63 @@
+.\" $NetBSD: ethers.5,v 1.9 2001/09/11 01:01:57 wiz Exp $
+.\"
+.\" Written by Roland McGrath <roland@frob.com>. Public domain.
+.\"
+.Dd November 7, 2000
+.Dt ETHERS 5
+.Os
+.Sh NAME
+.Nm ethers
+.Nd Ethernet host name data base
+.Sh DESCRIPTION
+The
+.Nm
+file maps Ethernet MAC addresses to host names.
+Lines consist of an address and a host name, separated by any number
+of blanks and/or tab characters.
+A
+.Sq \&#
+character indicates the beginning of a comment;
+characters up to the end of
+the line are not interpreted by routines which search the file.
+.Pp
+Each line in
+.Nm
+has the format:
+.Dl ethernet-MAC-address hostname-or-IP
+.Pp
+Ethernet MAC addresses are expressed as six hexadecimal numbers separated
+by colons, e.g. "08:00:20:00:5a:bc".
+The functions described in
+.Xr ethers 3
+and
+.Xr ether_aton 3
+can read and produce this format.
+.Pp
+The traditional use of
+.Nm
+involved using hostnames for the second argument.
+This may not be suitable for machines that don't have a common MAC
+address for all interfaces (i.e., just about every non
+.Tn Sun
+machine).
+There should be no problem in using an IP address as the second field
+if you wish to differentiate between different interfaces on a system.
+.Sh FILES
+.Bl -tag -width /etc/ethers -compact
+.It Pa /etc/ethers
+The
+.Nm
+file resides in
+.Pa /etc .
+.El
+.Sh SEE ALSO
+.Xr ethers 3
+.Sh HISTORY
+The
+.Nm ethers
+file format was adopted from
+.Tn SunOS
+and appeared in
+.Nx 1.0 .
+.Sh BUGS
+A name server should be used instead of a static file.