man page for myname(5)/mygate(5);

feedback and advice from nick@ henning@ and many others;

ok nick@ henning@

2 files changed, 94 insertions, 5 deletions

diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile
index d556c0d0cef..02961a78b1d 100644
--- a/share/man/man5/Makefile
+++ b/share/man/man5/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.32 2003/04/13 12:01:13 jmc Exp $
+#	$OpenBSD: Makefile,v 1.33 2003/07/26 07:07:08 jmc Exp $
 #	$NetBSD: Makefile,v 1.14 1995/05/11 23:13:15 cgd Exp $
 
 # missing: dump.5 plot.5
@@ -6,14 +6,15 @@
 MAN=	a.out.5 acct.5 bsd.port.mk.5 bsd.regress.mk.5 core.5 dir.5 disktab.5 \
 	elf.5 ethers.5 fbtab.5 files.conf.5 forward.5 fs.5 fstab.5 \
 	genassym.cf.5 group.5 hostname.if.5 hosts.equiv.5 hosts.5 intro.5 \
-	link.5 login.conf.5 mk.conf.5 moduli.5 motd.5 netgroup.5 networks.5 \
-	passwd.5 passwd.conf.5 pf.conf.5 phones.5 printcap.5 protocols.5 \
-	remote.5 resolv.conf.5 rpc.5 services.5 shells.5 stab.5 spamd.conf.5 \
-	sysctl.conf.5 types.5 utmp.5 wsconsctl.conf.5
+	link.5 login.conf.5 mk.conf.5 moduli.5 motd.5 myname.5 netgroup.5 \
+	networks.5 passwd.5 passwd.conf.5 pf.conf.5 phones.5 printcap.5 \
+	protocols.5 remote.5 resolv.conf.5 rpc.5 services.5 shells.5 stab.5 \
+	spamd.conf.5 sysctl.conf.5 types.5 utmp.5 wsconsctl.conf.5
 MLINKS= dir.5 dirent.5 fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5
 MLINKS+= hosts.equiv.5 .rhosts.5
 MLINKS+= resolv.conf.5 resolver.5
 MLINKS+= hostname.if.5 bridgename.if.5
 MLINKS+= passwd.5 master.passwd.5
+MLINKS+= myname.5 mygate.5
 
 .include <bsd.prog.mk>
diff --git a/share/man/man5/myname.5 b/share/man/man5/myname.5
new file mode 100644
index 00000000000..76cd248af6b
--- /dev/null
+++ b/share/man/man5/myname.5
@@ -0,0 +1,88 @@
+.\"	$OpenBSD: myname.5,v 1.1 2003/07/26 07:07:08 jmc Exp $
+.\"
+.\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd July 24, 2003
+.Dt MYNAME 5
+.Os
+.Sh NAME
+.Nm myname , mygate
+.Nd default hostname and gateway
+.Sh SYNOPSIS
+.Nm /etc/myname
+.Nm /etc/mygate
+.Sh DESCRIPTION
+The
+.Nm myname
+and
+.Nm mygate
+files are read by
+.Xr netstart 8
+at system startup time.
+.Pp
+.Pa /etc/myname
+contains the symbolic name of the host machine.
+The file should contain a single line specifying the
+fully qualified domain name
+.Pq FQDN
+of the system
+.Pq e.g. host.example.com .
+The name must be resolvable, either by matching a hostname specified in
+.Pa /etc/hosts
+(see
+.Xr hosts 5 )
+or through DNS
+(see
+.Xr resolv.conf 5 ) .
+The hostname is set via the
+.Xr hostname 1
+utility at boot time.
+See
+.Xr hostname 7
+for a description of hostname resolution.
+.Pp
+.Pa /etc/mygate
+contains the address of the gateway host, if it exists.
+The gateway is added to the routing tables by the
+.Xr route 8
+utility.
+If
+.Pa /etc/mygate
+does not exist, no default gateway is added to the routing tables.
+The file should contain a single line specifying the gateway address,
+in dotted quad notation
+.Pq e.g. 192.0.2.0 .
+.Pa /etc/mygate
+is processed after all interfaces have been configured.
+It will therefore override any DHCP-supplied default route information.
+.Pp
+Neither file may contain comments.
+.Sh FILES
+.Bl -tag -width "/etc/myname" -compact
+.It Pa /etc/myname
+Default hostname.
+.It Pa /etc/mygate
+Default gateway address.
+.El
+.Sh SEE ALSO
+.Xr hostname 1 ,
+.Xr hosts 5 ,
+.Xr resolv.conf 5 ,
+.Xr hostname 7 ,
+.Xr netstart 8 ,
+.Xr route 8
+.Sh HISTORY
+This manual page first appeared in
+.Ox 3.4 .