home | help
HESINFO(1)		     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 data-
     base.

     <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 argu-
     ment 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 im-
	    port 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,  speci-
	    fied 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 <ser-
	    vice-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-clus-
	    ter-name>.

FILES
     /etc/athena/hesiod.conf

SEE ALSO
     `Hesiod  -  Project  Athena Technical Plan -- Name Service', named(8), hes-
     iod(3)

AUTHOR
     Steve Dyer, IBM/Project Athena
     Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology.

				 27 October 1996		      HESINFO(1)

home | help