1.\" $NetBSD: hesinfo.1,v 1.9 2003/11/12 12:33:13 wiz Exp $ 2.\" 3.\" from: #Id: hesinfo.1,v 1.9 1996/11/07 01:57:12 ghudson Exp # 4.\" 5.\" Copyright 1987, 1996 by the Massachusetts Institute of Technology. 6.\" 7.\" Permission to use, copy, modify, and distribute this 8.\" software and its documentation for any purpose and without 9.\" fee is hereby granted, provided that the above copyright 10.\" notice appear in all copies and that both that copyright 11.\" notice and this permission notice appear in supporting 12.\" documentation, and that the name of M.I.T. not be used in 13.\" advertising or publicity pertaining to distribution of the 14.\" software without specific, written prior permission. 15.\" M.I.T. makes no representations about the suitability of 16.\" this software for any purpose. It is provided "as is" 17.\" without express or implied warranty. 18.Dd October 27, 1996 19.Dt HESINFO 1 20.Os 21.Sh NAME 22.Nm hesinfo 23.Nd find out what is stored in the Hesiod database 24.Sh SYNOPSIS 25.Nm 26.Op Fl bl 27.Ar HesiodName 28.Ar HesiodNameType 29.Sh DESCRIPTION 30.Nm 31takes two arguments, a name to be resolved and a string, known 32as a 33.Ar HesiodNameType . 34It then prints the information returned by 35the Hesiod nameserver. 36.Pp 37The value returned by 38.Nm 39is of the type 40.Ar HesiodNameType . 41.Pp 42.Nm 43understands the following options: 44.Bl -tag -width XX -offset indent 45.It Fl l 46Selects long format. 47.It Fl b 48Prints the fully-qualified string passed to the nameserver. 49.El 50.Ss VALID Hesiod_Names 51The following types of identifiers may be used in the 52.Ar HesiodName 53argument to 54.Nm . 55These values will be resolved by accessing the 56.Xr hesiod 3 57database. 58.Bl -tag -width XnfsXserverX:XpartitionXX 59.It Aq username 60the 8-character-or-less string used to identify users or classes 61(e.g. joeuser, root, 1.00, etc). 62Used with the 63.Ar Hesiod_Name_Types 64.Dv passwd , 65.Dv pobox , 66and 67.Dv filsys . 68.It Aq uid 69the id number assigned to a user. 70.It Aq groupid 71the id number assigned to a group. 72.It Aq groupname 73a name identifying a unique group. 74.It Aq file-system-name 75the name of an athena file system. 76.It Ao rvd server Ac Ns : Ns Aq pack 77the name of an rvd's server and pack separated by a colon. 78.It Ao nfs server Ac Ns : Ns Aq partition 79the name of an nfs server and its partition separated by a colon. 80.It Aq workstation-name 81the machine name of an Athena workstation (e.g. E40-343-3). 82.It Aq service-name 83name of an Athena service (e.g. Zephyr). 84.It Aq service-type 85name of Unix service (valid entries are defined in 86.Pa /etc/services ) . 87.It Aq printer-name 88name of a printer. 89.It Aq printer-cluster-name 90name of an Athena print cluster. 91.It Aq foo 92some 93.Nm 94calls (e.g., 95.Dv prclusterlist ) 96do not require a specific 97.Ar HesiodName 98argument. 99However, you must include a dummy string (e.g., 100.Dq foo ) 101for 102.Nm 103to work properly. 104.El 105.Ss VALID Hesiod_Name_Types 106The following symbols are valid substitutions for the 107.Ar HesiodNameType 108argument to 109.Nm . 110.Bl -tag -width passwdX 111.It passwd 112returns string suitable for inclusion in 113.Pa /etc/passwd , 114searching with 115.Aq username . 116.It pobox 117returns information on the pobox assigned to the user specified by 118.Ar HesiodName , 119searching with 120.Aq username . 121.It uid 122returns string suitable for inclusion in 123.Pa /etc/passwd , 124searching with 125.Aq uid . 126.It gid 127returns string suitable for inclusion in 128.Pa /etc/group , 129searching with 130.Aq groupid . 131.It group 132returns string suitable for inclusion in 133.Pa /etc/group , 134searching with 135.Aq groupname . 136.It grplist 137returns subgroups included in superset defined by 138.Aq groupname . 139.It filsys 140returns file system type, export point, server, mount mode, and 141import point for the following valid 142.Ar HesiodNames 143(see above) - 144.Aq Dv file system name , 145.Aq Dv username , 146.Ao Dv rvd server Ac Ns : Ns Aq pack , 147and 148.Ao Dv nfs server Ac Ns : Ns Aq partition . 149.It cluster 150returns information about the local cluster the workstation, specified by 151.Aq workstation name . 152Included is information about the local file and print servers. 153This information is accesses by 154.Dv clusterinfo 155at boot time. 156.It sloc 157returns network name of service host for 158.Aq service-name . 159.It service 160returns Internet protocol type and protocol service port for 161.Aq service-type . 162.It pcap 163returns a valid entry for 164.Pa /etc/printcap 165for 166.Aq printer-name . 167.It prcluserlist 168returns a list of print clusters. 169.It prcluster 170returns a list of printers in a cluster specified by 171.Aq printer-cluster-name . 172.El 173.Sh FILES 174.Pa /etc/hesiod.conf 175.Sh SEE ALSO 176.Xr hesiod 3 , 177.Xr named 8 178.Rs 179.%T Hesiod - Project Athena Technical Plan -- Name Service 180.Re 181.Sh AUTHORS 182.An Steve Dyer , 183IBM/Project Athena 184.Pp 185Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology. 186