xref: /openbsd-src/share/man/man5/myname.5 (revision db3296cf5c1dd9058ceecc3a29fe4aaa0bd26000)
1.\"	$OpenBSD: myname.5,v 1.1 2003/07/26 07:07:08 jmc Exp $
2.\"
3.\" Copyright (c) 2003 Jason McIntyre <jmc@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd July 24, 2003
18.Dt MYNAME 5
19.Os
20.Sh NAME
21.Nm myname , mygate
22.Nd default hostname and gateway
23.Sh SYNOPSIS
24.Nm /etc/myname
25.Nm /etc/mygate
26.Sh DESCRIPTION
27The
28.Nm myname
29and
30.Nm mygate
31files are read by
32.Xr netstart 8
33at system startup time.
34.Pp
35.Pa /etc/myname
36contains the symbolic name of the host machine.
37The file should contain a single line specifying the
38fully qualified domain name
39.Pq FQDN
40of the system
41.Pq e.g. host.example.com .
42The name must be resolvable, either by matching a hostname specified in
43.Pa /etc/hosts
44(see
45.Xr hosts 5 )
46or through DNS
47(see
48.Xr resolv.conf 5 ) .
49The hostname is set via the
50.Xr hostname 1
51utility at boot time.
52See
53.Xr hostname 7
54for a description of hostname resolution.
55.Pp
56.Pa /etc/mygate
57contains the address of the gateway host, if it exists.
58The gateway is added to the routing tables by the
59.Xr route 8
60utility.
61If
62.Pa /etc/mygate
63does not exist, no default gateway is added to the routing tables.
64The file should contain a single line specifying the gateway address,
65in dotted quad notation
66.Pq e.g. 192.0.2.0 .
67.Pa /etc/mygate
68is processed after all interfaces have been configured.
69It will therefore override any DHCP-supplied default route information.
70.Pp
71Neither file may contain comments.
72.Sh FILES
73.Bl -tag -width "/etc/myname" -compact
74.It Pa /etc/myname
75Default hostname.
76.It Pa /etc/mygate
77Default gateway address.
78.El
79.Sh SEE ALSO
80.Xr hostname 1 ,
81.Xr hosts 5 ,
82.Xr resolv.conf 5 ,
83.Xr hostname 7 ,
84.Xr netstart 8 ,
85.Xr route 8
86.Sh HISTORY
87This manual page first appeared in
88.Ox 3.4 .
89