hesiod/hesinfo.1

   1 .\" $Id: hesinfo.1,v 1.9 1996/11/07 01:57:12 ghudson Exp $
   2 .\"
   3 .\" Copyright 1987, 1996 by the Massachusetts Institute of Technology.
   4 .\"
   5 .\" Permission to use, copy, modify, and distribute this
   6 .\" software and its documentation for any purpose and without
   7 .\" fee is hereby granted, provided that the above copyright
   8 .\" notice appear in all copies and that both that copyright
   9 .\" notice and this permission notice appear in supporting
  10 .\" documentation, and that the name of M.I.T. not be used in
  11 .\" advertising or publicity pertaining to distribution of the
  12 .\" software without specific, written prior permission.
  13 .\" M.I.T. makes no representations about the suitability of
  14 .\" this software for any purpose.  It is provided "as is"
  15 .\" without express or implied warranty.
  16 .TH HESINFO 1 "27 October 1996"
  17 .FM mit
  18 .SH NAME
  19 hesinfo \- find out what is stored in the Hesiod database
  20 .SH SYNOPSIS
  21 .nf
  22 hesinfo \fI[\-bl]\fR \fIHesiodName\fR \fIHesiodNameType\fR
  23 .SH DESCRIPTION
  24 .I hesinfo
  25 takes two arguments, a name to be resolved and a string, known
  26 as a HesiodNameType.  It then prints the information returned by
  27 the Hesiod nameserver.
  28 .PP
  29 The value returned by
  30 .B hesinfo
  31 is of the type
  32 .I HesiodNameType.
  33 .PP
  34 .I hesinfo
  35 understands the following options:
  36 .TP
  37 .B \-l
  38 Selects long format.
  39 .TP
  40 .B \-b
  41 Prints the fully-qualified string passed to the nameserver.
  42
  43 .PP
  44 .SS VALID Hesiod_Names
  45 The following types of identifiers may be used in the
  46 .I HesiodName
  47 argument to
  48 .B hesinfo.
  49 These values will be resolved by accessing the
  50 .B hesiod
  51 database.
  52
  53 .TP
  54 .B \<username>
  55 the 8-character-or-less string used to identify users or classes
  56 (e.g. joeuser, root, 1.00, etc).
  57 Used with the
  58 .I Hesiod_Name_Types
  59 .BR passwd,
  60 .BR pobox,
  61 and
  62 .BR filsys.
  63
  64
  65 .TP
  66 .B \<uid>
  67 the id number assigned to a user.
  68
  69 .TP
  70 .B \<groupid>
  71 the id number assigned to a group.
  72
  73 .TP
  74 .B \<groupname>
  75 a name identifying a unique group.
  76
  77 .TP
  78 .B \<file-system-name>
  79 the name of an athena file system.
  80
  81 .TP
  82 .B \<rvd server>:<pack>
  83 the name of an rvd's server and pack  seperated by a colon.
  84
  85 .TP
  86 .B \<nfs server>:<partition>
  87 the name of an nfs server and its partition seperated by a colon.
  88
  89 .TP
  90 .B \<workstation-name>
  91 the machine name of an Athena workstation (e.g. E40-343-3).
  92
  93 .TP
  94 .B \<service-name>
  95 name of an Athena service (e.g. Zephyr).
  96
  97 .TP
  98 .B \<service-type>
  99 name of Unix service (valid entries are defined in /etc/services).
 100
 101 .TP
 102 .B \<printer-name>
 103 name of a printer.
 104
 105 .TP
 106 .B \<printer-cluster-name>
 107 name of an Athena print cluster.
 108
 109 .TP
 110 .B \<foo>
 111 some
 112 .B hesinfo
 113 calls (e.g.
 114 .B prclusterlist
 115 ) do not require a specific
 116 .I HesiodName
 117 argument.  However, you must include a dummy string (e.g. 'foo') for
 118 .B hesinfo
 119  to work properly.
 120
 121
 122
 123
 124 .PP
 125 .SS VALID Hesiod_Name_Types
 126 The following symbols are valid substitutions for the
 127 .I HesiodNameType
 128 argument to
 129 .B hesinfo.
 130
 131 .TP
 132 .B \ passwd
 133 returns string suitable for inclusion in
 134 .I /etc/passwd,
 135 searching with
 136 .B <username>.
 137
 138 .TP
 139 .B \ pobox
 140 returns information on the pobox assigned to the user specified by
 141 .I HesiodName,
 142 searching with
 143 .B <username>.
 144
 145
 146 .TP
 147 .B \ uid
 148 returns string suitable for inclusion in
 149 .I /etc/passwd,
 150 searching with
 151 .B <uid>.
 152
 153 .TP
 154 .B \ gid
 155 returns string suitable for inclusion in
 156 .I /etc/group,
 157 searching with
 158 .B <groupid>.
 159
 160 .TP
 161 .B \ group
 162 returns string suitable for inclusion in
 163 .I /etc/group,
 164 searching with
 165 .B <groupname>.
 166
 167 .TP
 168 .B \ grplist
 169 returns subgroups included in superset
 170 defined by
 171 .B <groupname>.
 172
 173 .TP
 174 .B \ filsys
 175 returns file system type, export point, server, mount mode, and import point
 176 for the following valid
 177 .I HesiodNames
 178 (see above)
 179 .B \- <file system name>, <username>, <rvd server>:<pack>,
 180 .B and <nfs server>:<partition>
 181
 182 .TP
 183 .B \ cluster
 184 returns information about the local cluster the workstation, specified by
 185 .B <workstation name>.
 186 Included is information about the local file and print servers.  This
 187 information is accesses by
 188 .B clusterinfo
 189 at boot time.
 190
 191 .TP
 192 .B \ sloc
 193 returns network name of service host for
 194 .B <service-name>.
 195
 196 .TP
 197 .B \ service
 198 returns Internet protocol type and protocol service port for
 199 .B <service-type>.
 200
 201 .TP
 202 .B \ pcap
 203 returns a valid entry for /etc/printcap for
 204 .B <printer-name>.
 205
 206 .TP
 207 .B \ prcluserlist
 208 returns a list of print clusters.
 209
 210 .TP
 211 .B \ prcluster
 212 returns a list of printers in a cluster specified by
 213 .B <printer-cluster-name>.
 214
 215 .SH FILES
 216 /etc/hesiod.conf
 217 .SH "SEE ALSO"
 218 `Hesiod - Project Athena Technical Plan -- Name Service', named(8), hesiod(3)
 219 .SH AUTHOR
 220 Steve Dyer, IBM/Project Athena
 221 .br
 222 Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology.
 223 .br