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	 hes-
       iod 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)