$NetBSD: hesinfo.1,v 1.4 2002/02/08 01:36:24 ross Exp $

from: #Id: hesinfo.1,v 1.9 1996/11/07 01:57:12 ghudson Exp #

Copyright 1987, 1996 by the Massachusetts Institute of Technology.

Permission to use, copy, modify, and distribute this
software and its documentation for any purpose and without
fee is hereby granted, provided that the above copyright
notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting
documentation, and that the name of M.I.T. not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
M.I.T. makes no representations about the suitability of
this software for any purpose. It is provided "as is"
without express or implied warranty.
.FM mit hesinfo - find out what is stored in the Hesiod database

hesinfo [-bl] HesiodName HesiodNameType
 DESCRIPTION
 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.

The value returned by
 hesinfo is of the type
 HesiodNameType. 

 hesinfo understands the following options:

 -l Selects long format.

 -b Prints the fully-qualified string passed to the nameserver.


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


 \\*[Lt]username\*[Gt] the 8-character-or-less string used to identify users or classes
(e.g. joeuser, root, 1.00, etc).
Used with the
 Hesiod_Name_Types  passwd,  pobox, and
 filsys. 


 \\*[Lt]uid\*[Gt] the id number assigned to a user.


 \\*[Lt]groupid\*[Gt] the id number assigned to a group.


 \\*[Lt]groupname\*[Gt] a name identifying a unique group.


 \\*[Lt]file-system-name\*[Gt] the name of an athena file system.


 \\*[Lt]rvd server\*[Gt]:\*[Lt]pack\*[Gt] the name of an rvd's server and pack separated by a colon.


 \\*[Lt]nfs server\*[Gt]:\*[Lt]partition\*[Gt] the name of an nfs server and its partition separated by a colon.


 \\*[Lt]workstation-name\*[Gt] the machine name of an Athena workstation (e.g. E40-343-3).


 \\*[Lt]service-name\*[Gt] name of an Athena service (e.g. Zephyr).


 \\*[Lt]service-type\*[Gt] name of Unix service (valid entries are defined in /etc/services).


 \\*[Lt]printer-name\*[Gt] name of a printer.


 \\*[Lt]printer-cluster-name\*[Gt] name of an Athena print cluster.


 \\*[Lt]foo\*[Gt] some
 hesinfo calls (e.g.
 prclusterlist ) do not require a specific
 HesiodName argument. However, you must include a dummy string (e.g. 'foo') for
 hesinfo  to work properly.





 VALID Hesiod_Name_Types
The following symbols are valid substitutions for the
 HesiodNameType argument to
 hesinfo. 

  passwd returns string suitable for inclusion in
 /etc/passwd, searching with
 \*[Lt]username\*[Gt]. 

  pobox returns information on the pobox assigned to the user specified by
 HesiodName, searching with
 \*[Lt]username\*[Gt]. 


  uid returns string suitable for inclusion in
 /etc/passwd, searching with
 \*[Lt]uid\*[Gt]. 

  gid returns string suitable for inclusion in
 /etc/group, searching with
 \*[Lt]groupid\*[Gt]. 

  group returns string suitable for inclusion in
 /etc/group, searching with
 \*[Lt]groupname\*[Gt]. 

  grplist returns subgroups included in superset
defined by
 \*[Lt]groupname\*[Gt]. 

  filsys returns file system type, export point, server, mount mode, and import point
for the following valid
 HesiodNames (see above)
 - \*[Lt]file system name\*[Gt], \*[Lt]username\*[Gt], \*[Lt]rvd server\*[Gt]:\*[Lt]pack\*[Gt],  and \*[Lt]nfs server\*[Gt]:\*[Lt]partition\*[Gt] 

  cluster returns information about the local cluster the workstation, specified by
 \*[Lt]workstation name\*[Gt]. Included is information about the local file and print servers. This
information is accesses by
 clusterinfo at boot time.


  sloc returns network name of service host for
 \*[Lt]service-name\*[Gt]. 

  service returns Internet protocol type and protocol service port for
 \*[Lt]service-type\*[Gt]. 

  pcap returns a valid entry for /etc/printcap for
 \*[Lt]printer-name\*[Gt]. 

  prcluserlist returns a list of print clusters.


  prcluster returns a list of printers in a cluster specified by
 \*[Lt]printer-cluster-name\*[Gt]. 
 FILES
/etc/hesiod.conf
 "SEE ALSO"
`Hesiod - Project Athena Technical Plan -- Name Service', named(8), hesiod(3)
 AUTHOR
Steve Dyer, IBM/Project Athena

Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology.