From de57d5974c7853b545fd245020a9e3b51686ae53 Mon Sep 17 00:00:00 2001 From: Jason McIntyre Date: Sat, 26 Jul 2003 07:07:09 +0000 Subject: man page for myname(5)/mygate(5); feedback and advice from nick@ henning@ and many others; ok nick@ henning@ --- share/man/man5/Makefile | 11 ++++--- share/man/man5/myname.5 | 88 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 94 insertions(+), 5 deletions(-) create mode 100644 share/man/man5/myname.5 (limited to 'share/man/man5') 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 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 +.\" +.\" 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 . -- cgit v1.2.3