NAME

       hesinfo - find out what is stored in the Hesiod database

SYNOPSIS

       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.

       <username>
              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.

       <uid>  the id number assigned to a user.

       <groupid>
              the id number assigned to a group.

       <groupname>
              a name identifying a unique group.

       <file-system-name>
              the name of an athena file system.

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

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

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

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

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

       <printer-name>
              name of a printer.

       <printer-cluster-name>
              name of an Athena print cluster.

       <foo>  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 <username>.

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

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

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

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

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

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

        cluster
              returns  information  about  the  local  cluster the workstation, specified by <workstation name>.
              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 <service-name>.

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

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

        prcluserlist
              returns a list of print clusters.

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

FILES

       /etc/athena/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.

                                                 27 October 1996                                      HESINFO(1)