BSD 4_3_Reno release
[unix-history] / usr / src / usr.sbin / mkhosts / mkhosts.8
CommitLineData
2d8a17cc
KB
1.\" Copyright (c) 1985 The Regents of the University of California.
2.\" All rights reserved.
55270cae 3.\"
1c15e888
C
4.\" Redistribution and use in source and binary forms are permitted provided
5.\" that: (1) source distributions retain this entire copyright notice and
6.\" comment, and (2) distributions including binaries display the following
7.\" acknowledgement: ``This product includes software developed by the
8.\" University of California, Berkeley and its contributors'' in the
9.\" documentation or other materials provided with the distribution and in
10.\" all advertising materials mentioning features or use of this software.
11.\" Neither the name of the University nor the names of its contributors may
12.\" be used to endorse or promote products derived from this software without
13.\" specific prior written permission.
14.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
2d8a17cc 17.\"
1c15e888 18.\" @(#)mkhosts.8 6.5 (Berkeley) 6/24/90
55270cae 19.\"
1c15e888 20.TH MKHOSTS 8 "June 24, 1990"
55270cae
KM
21.UC 6
22.SH NAME
56e2d6be 23mkhosts \- generate hashed host table
55270cae 24.SH SYNOPSIS
f2e9c085 25.B mkhosts
55270cae
KM
26[
27.B \-v
28]
29hostfile
30.SH DESCRIPTION
31.I Mkhosts
6a841d1b 32is used to generated the hashed host database used by one version of the
55270cae
KM
33library routines
34.B gethostbyaddr()
35and
36.BR gethostbyname() .
6a841d1b
MK
37It is not used if host name translation is performed by
38.IR named (8).
55270cae
KM
39If the
40.B \-v
41option is supplied, each host will be listed as it is added.
42The file
43.I hostfile
44is usually /etc/hosts, and in any case
45must be in the format of /etc/hosts (see hosts(5)).
46.I Mkhosts
47will generate database files named
48.I hostfile.pag
49and
50.I hostfile.dir.
51The new database is build in a set of temporary files and
52only replaces the real database if the new one is built
53without errors.
54.I Mkhosts
55will exit with a non-zero exit code if any errors are detected.
56.SH FILES
57.ta \w'hostfile.new.dir 'u
58\fIhostfile\fR.pag - real database filenames
59.br
60\fIhostfile\fR.dir
61.br
62\fIhostfile\fR.new.pag - temporary database filenames
63.br
64\fIhostfile\fR.new.dir
65.SH SEE ALSO
6a841d1b 66gethostbyname(3), gettable(8), hosts(5), htable(8), named(8)