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 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 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 <printercluster-name>.

FILES

/etc/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)