Commit | Line | Data |
---|---|---|
6a22fdb8 KB |
1 | .\" Copyright (c) 1983 The Regents of the University of California. |
2 | .\" All rights reserved. | |
4ee2fd4d | 3 | .\" |
6a22fdb8 KB |
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) %G% | |
4ee2fd4d | 17 | .\" |
bfd81b5b | 18 | .TH HTABLE 8 "" |
4ee2fd4d KM |
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 | |
0479c228 | 45 | file may be used by the |
a96bccf5 | 46 | .IR gethostbyname (3N) |
0479c228 MK |
47 | routines in mapping host names to addresses |
48 | if the nameserver, | |
49 | .IR named (8), | |
50 | is not used. | |
4ee2fd4d KM |
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 | |
0479c228 | 58 | file may be used by the routing daemon |
4ee2fd4d KM |
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 | |
0479c228 MK |
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 | |
4ee2fd4d KM |
83 | .B \-c |
84 | flag. | |
85 | The networks, separated by commas, | |
0479c228 | 86 | may be given by name or in Internet-standard dot notation, |
4ee2fd4d KM |
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 | |
6a22fdb8 | 108 | .IR gettable (8) |
4ee2fd4d KM |
109 | program which retrieves the NIC database from a host. |
110 | .SH "SEE ALSO" | |
6a22fdb8 | 111 | netintro(4), gettable(8), named(8) |
0479c228 MK |
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. |