rework the text describing interface name;
authorjmc <jmc@openbsd.org>
Thu, 15 Dec 2022 06:39:05 +0000 (06:39 +0000)
committerjmc <jmc@openbsd.org>
Thu, 15 Dec 2022 06:39:05 +0000 (06:39 +0000)
feedback deraadt afresh kn

share/man/man5/hostname.if.5

index 452d562..a999ff4 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: hostname.if.5,v 1.80 2022/12/05 20:12:00 afresh1 Exp $
+.\"    $OpenBSD: hostname.if.5,v 1.81 2022/12/15 06:39:05 jmc Exp $
 .\"    $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)hosts.5    8.2 (Berkeley) 12/11/93
 .\"
-.Dd $Mdocdate: December 5 2022 $
+.Dd $Mdocdate: December 15 2022 $
 .Dt HOSTNAME.IF 5
 .Os
 .Sh NAME
 The
 .Nm hostname.*\&
 files contain information regarding the configuration of each network interface.
-The interface can be referenced by name or lladdr, such as
-.Pa hostname.fxp0 ,
-.Pa hostname.00:00:5e:00:53:af ,
-or
-.Pa hostname.bridge0 .
-One file should exist for each interface that is to be configured,
-with priority given to configuration by interface name over lladdr.
+Interfaces are referenced by name and unit,
+such as
+.Dq hostname.fxp0 .
+For some machines,
+autoconfiguration makes this system inconsistent,
+so interfaces can alternatively be referenced by
+their link layer address (lladdr),
+such as
+.Dq hostname.00:00:5e:00:53:af .
+Priority is given to configuration by interface name/unit over lladdr.
 A configuration file is not needed for lo0.
 .Pp
 The configuration information is expressed in a line-by-line packed format