|
|
1.1 root 1: .\" Copyright (c) 1983 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted
5: .\" provided that the above copyright notice and this paragraph are
6: .\" duplicated in all such forms and that any documentation,
7: .\" advertising materials, and other materials related to such
8: .\" distribution and use acknowledge that the software was developed
9: .\" by the University of California, Berkeley. The name of the
10: .\" University may not be used to endorse or promote products derived
11: .\" from this software without specific prior written permission.
12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14: .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15: .\"
16: .\" @(#)htable.8 6.4 (Berkeley) 9/20/88
17: .\"
18: .TH HTABLE 8 "September 20, 1988"
19: .UC 5
20: .SH NAME
21: htable \- convert NIC standard format host tables
22: .SH SYNOPSIS
23: .B /etc/htable
24: [
25: .B \-c
26: .I connected-nets
27: ] [
28: .B \-l
29: .I local-nets
30: ]
31: .I file
32: .SH DESCRIPTION
33: .I Htable
34: is used to convert host files in the format specified
35: in Internet RFC 810 to the format used by the network
36: library routines. Three files are created as a result
37: of running
38: .IR htable :
39: .IR hosts ,
40: .IR networks ,
41: and
42: .IR gateways .
43: The
44: .I hosts
45: file may be used by the
46: .IR gethostbyname (3N)
47: routines in mapping host names to addresses
48: if the nameserver,
49: .IR named (8),
50: is not used.
51: The
52: .I networks
53: file is used by the
54: .IR getnetent (3N)
55: routines in mapping network names to numbers.
56: The
57: .I gateways
58: file may be used by the routing daemon
59: in identifying ``passive'' Internet gateways;
60: see
61: .IR routed (8C)
62: for an explanation.
63: .PP
64: If any of the files
65: .IR localhosts ,
66: .IR localnetworks ,
67: or
68: .I localgateways
69: are present in the current directory,
70: the file's contents is prepended to the
71: output file.
72: Of these, only the gateways file is interpreted.
73: This allows sites to maintain local aliases and
74: entries which are not normally present in the
75: master database.
76: Only one gateway to each network will be placed in the gateways file;
77: a gateway listed in the localgateways file will override any in the
78: input file.
79: .PP
80: If the gateways file is to be used,
81: a list of networks to which the host is directly connected
82: is specified with the
83: .B \-c
84: flag.
85: The networks, separated by commas,
86: may be given by name or in Internet-standard dot notation,
87: e.g.
88: .B \-c
89: arpanet,128.32,local-ether-net.
90: .I Htable
91: only includes gateways
92: which are directly connected to one of the networks specified,
93: or which can be reached from another gateway on a connected net.
94: .PP
95: If the
96: .B \-l
97: option is given with a list of networks (in the same format as for
98: .BR \-c ),
99: these networks will be treated as ``local,''
100: and information about hosts on local networks is
101: taken only from the localhosts file.
102: Entries for local hosts from the main database will be omitted.
103: This allows the localhosts file to completely override
104: any entries in the input file.
105: .PP
106: .I Htable
107: is best used in conjunction with the
108: .IR gettable (8)
109: program which retrieves the NIC database from a host.
110: .SH "SEE ALSO"
111: netintro(4), gettable(8), named(8)
112: .SH BUGS
113: If the name-domain system provided network name mapping well as host
114: name mapping,
115: .I htable
116: would no longer be needed.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.