HESINFO(1)              NetBSD General Commands Manual              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 argument
     to hesinfo.  These values will be resolved by accessing the hesiod(3)
     database.

     <username>                 the 8-character-or-less string used to iden-
                                tify 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 separated
                                by a colon.

     <nfs server>:<partition>   the name of an nfs server and its partition
                                separated 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/hesiod.conf

SEE ALSO
     hesiod(3), named(8)

     Hesiod - Project Athena Technical Plan -- Name Service.

AUTHORS
     Steve Dyer, IBM/Project Athena

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

NetBSD 5.0_STABLE              October 27, 1996              NetBSD 5.0_STABLE
