xref: /original-bsd/old/gettable/gettable.8 (revision 3b6250d9)
1.\" Copyright (c) 1983, 1991 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)gettable.8	6.5 (Berkeley) 03/16/91
7.\"
8.Dd
9.Dt GETTABLE 8
10.Os BSD 4.2
11.Sh NAME
12.Nm gettable
13.Nd get
14.Tn NIC
15format host tables from a host
16.Sh SYNOPSIS
17.Nm gettable
18.Op Fl v
19.Ar host
20.Op Ar outfile
21.Sh DESCRIPTION
22.Nm Gettable
23is a simple program used to obtain the
24.Tn NIC
25standard
26host tables from a
27.Dq nicname
28server.  The indicated
29.Ar host
30is queried for the tables.  The tables, if retrieved,
31are placed in the file
32.Ar outfile
33or by default,
34.Pa hosts.txt .
35.Pp
36Available option:
37.Bl -tag -width Ds
38.It Fl v
39Get just the version number instead of the complete host table
40and put the output in the file
41.Ar outfile
42or by default,
43.Pa hosts.ver .
44.El
45.Pp
46.Nm Gettable
47operates by opening a
48.Tn TCP
49connection to the port indicated
50in the service specification for ``nicname''.  A request
51is then made for
52.Dq ALL
53names and the resultant information
54is placed in the output file.
55.Pp
56.Nm Gettable
57is best used in conjunction with the
58.Xr htable 8
59program which converts the
60.Tn NIC
61standard file format to
62that used by the network library lookup routines.
63.Sh SEE ALSO
64.Xr intro 3 ,
65.Xr htable 8 ,
66.Xr named 8
67.Sh BUGS
68If the name-domain system provided network name mapping well as host
69name mapping,
70.Nm gettable
71would no longer be needed.
72.Sh HISTORY
73The
74.Nm
75command appeared in
76.Bx 4.2 .
77