File: hesinfo.1

package info (click to toggle)
hesiod 3.2.1-3
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, stretch
  • size: 1,876 kB
  • ctags: 238
  • sloc: sh: 11,368; ansic: 1,228; makefile: 58
file content (235 lines) | stat: -rw-r--r-- 5,288 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
.\" $Id: hesinfo.1,v 1.1 1998-09-03 01:12:49 ghudson Exp $
.\"
.\" Copyright 1987, 1996 by the Massachusetts Institute of Technology.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\"
.\" * Redistributions of source code must retain the above copyright
.\"   notice, this list of conditions and the following disclaimer.
.\"
.\" * Redistributions in binary form must reproduce the above copyright
.\"   notice, this list of conditions and the following disclaimer in
.\"   the documentation and/or other materials provided with the
.\"   distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
.\" COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.TH HESINFO 1 "27 October 1996"
.SH NAME
hesinfo \- find out what is stored in the Hesiod database
.SH SYNOPSIS
.nf
hesinfo \fI[-bl]\fR \fIHesiodName\fR \fIHesiodNameType\fR
.SH DESCRIPTION
.I hesinfo
takes two arguments, a name to be resolved and a string, known
as a HesiodNameType.  It then prints the information returned by
the Hesiod nameserver.
.PP
The value returned by
.B hesinfo
is of the type
.I HesiodNameType.
.PP
.I hesinfo
understands the following options:
.TP
.B -l
Selects long format.
.TP
.B -b
Prints the fully-qualified string passed to the nameserver.

.PP
.SS VALID Hesiod_Names
The following types of identifiers may be used in the
.I HesiodName
argument to
.B hesinfo.
These values will be resolved by accessing the
.B hesiod
database.

.TP
.B \<username>
the 8-character-or-less string used to identify users or classes
(e.g. joeuser, root, 1.00, etc).
Used with the
.I Hesiod_Name_Types
.BR passwd,
.BR pobox,
and
.BR filsys.


.TP
.B \<uid>
the id number assigned to a user.

.TP
.B \<groupid>
the id number assigned to a group.

.TP
.B \<groupname>
a name identifying a unique group.

.TP 
.B \<file-system-name>
the name of an athena file system.

.TP
.B \<rvd server>:<pack>
the name of an rvd's server and pack  seperated by a colon.

.TP
.B \<nfs server>:<partition>
the name of an nfs server and its partition seperated by a colon.

.TP
.B \<workstation-name>
the machine name of an Athena workstation (e.g. E40-343-3).

.TP 
.B \<service-name>
name of an Athena service (e.g. Zephyr).

.TP
.B \<service-type>
name of Unix service (valid entries are defined in /etc/services).

.TP
.B \<printer-name>
name of a printer.

.TP
.B \<printer-cluster-name>
name of an Athena print cluster.

.TP
.B \<foo>
some
.B hesinfo
calls (e.g. 
.B prclusterlist
) do not require a specific
.I HesiodName
argument.  However, you must include a dummy string (e.g. 'foo') for
.B hesinfo
 to work properly.




.PP
.SS VALID Hesiod_Name_Types
The following symbols are valid substitutions for the
.I HesiodNameType
argument to
.B hesinfo.

.TP
.B \ passwd
returns string suitable for inclusion in
.I /etc/passwd,
searching with
.B <username>.

.TP
.B \ pobox
returns information on the pobox assigned to the user specified by
.I HesiodName,
searching with
.B <username>.


.TP
.B \ uid   
returns string suitable for inclusion in
.I /etc/passwd,
searching with
.B <uid>.

.TP
.B \ gid   
returns string suitable for inclusion in
.I /etc/group,
searching with
.B <groupid>.

.TP
.B \ group
returns string suitable for inclusion in
.I /etc/group,
searching with
.B <groupname>.

.TP
.B \ grplist
returns subgroups included in superset
defined by 
.B <groupname>.

.TP
.B \ filsys
returns file system type, export point, server, mount mode, and import point
for the following valid
.I HesiodNames
(see above)
.B - <file system name>, <username>, <rvd server>:<pack>, 
.B and <nfs server>:<partition>

.TP
.B \ cluster
returns information about the local cluster the workstation, specified by
.B <workstation name>.
Included is information about the local file and print servers.  This
information is accesses by 
.B clusterinfo 
at boot time.

.TP
.B \ sloc
returns network name of service host for
.B <service-name>.

.TP
.B \ service
returns Internet protocol type and protocol service port for
.B <service-type>.

.TP
.B \ pcap
returns a valid entry for /etc/printcap for
.B <printer-name>.

.TP 
.B \ prcluserlist
returns a list of print clusters.

.TP 
.B \ prcluster
returns a list of printers in a cluster specified by
.B <printer-cluster-name>.

.SH FILES
/etc/athena/hesiod.conf
.SH "SEE ALSO"
`Hesiod - Project Athena Technical Plan -- Name Service', named(8), hesiod(3)
.SH AUTHOR
Steve Dyer, IBM/Project Athena
.br
Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology.
.br