|
|
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 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.
17: .\"
18: .\" @(#)htable.8 6.5 (Berkeley) 6/24/90
19: .\"
20: .TH HTABLE 8 "June 24, 1990"
21: .UC 5
22: .SH NAME
23: htable \- convert NIC standard format host tables
24: .SH SYNOPSIS
25: .B htable
26: [
27: .B \-c
28: .I connected-nets
29: ] [
30: .B \-l
31: .I local-nets
32: ]
33: .I file
34: .SH DESCRIPTION
35: .I Htable
36: is used to convert host files in the format specified
37: in Internet RFC 810 to the format used by the network
38: library routines. Three files are created as a result
39: of running
40: .IR htable :
41: .IR hosts ,
42: .IR networks ,
43: and
44: .IR gateways .
45: The
46: .I hosts
47: file may be used by the
48: .IR gethostbyname (3N)
49: routines in mapping host names to addresses
50: if the nameserver,
51: .IR named (8),
52: is not used.
53: The
54: .I networks
55: file is used by the
56: .IR getnetent (3N)
57: routines in mapping network names to numbers.
58: The
59: .I gateways
60: file may be used by the routing daemon
61: in identifying ``passive'' Internet gateways;
62: see
63: .IR routed (8C)
64: for an explanation.
65: .PP
66: If any of the files
67: .IR localhosts ,
68: .IR localnetworks ,
69: or
70: .I localgateways
71: are present in the current directory,
72: the file's contents is prepended to the
73: output file.
74: Of these, only the gateways file is interpreted.
75: This allows sites to maintain local aliases and
76: entries which are not normally present in the
77: master database.
78: Only one gateway to each network will be placed in the gateways file;
79: a gateway listed in the localgateways file will override any in the
80: input file.
81: .PP
82: If the gateways file is to be used,
83: a list of networks to which the host is directly connected
84: is specified with the
85: .B \-c
86: flag.
87: The networks, separated by commas,
88: may be given by name or in Internet-standard dot notation,
89: e.g.
90: .B \-c
91: arpanet,128.32,local-ether-net.
92: .I Htable
93: only includes gateways
94: which are directly connected to one of the networks specified,
95: or which can be reached from another gateway on a connected net.
96: .PP
97: If the
98: .B \-l
99: option is given with a list of networks (in the same format as for
100: .BR \-c ),
101: these networks will be treated as ``local,''
102: and information about hosts on local networks is
103: taken only from the localhosts file.
104: Entries for local hosts from the main database will be omitted.
105: This allows the localhosts file to completely override
106: any entries in the input file.
107: .PP
108: .I Htable
109: is best used in conjunction with the
110: .IR gettable (8)
111: program which retrieves the NIC database from a host.
112: .SH "SEE ALSO"
113: netintro(4), gettable(8), named(8)
114: .SH BUGS
115: If the name-domain system provided network name mapping well as host
116: name mapping,
117: .I htable
118: would no longer be needed.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.