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)