hesinfo

HESINFO(1)                                                          HESINFO(1)



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 argu-
       ment 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   Hes-
              iod_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/ser-
              vices).


       <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 spe-
              cific 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  Technol-
       ogy.



                                27 October 1996                     HESINFO(1)