diff options
author | ru <ru@FreeBSD.org> | 2001-01-16 17:04:17 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2001-01-16 17:04:17 +0000 |
commit | b72a3c78cc671cb6b17ed6cf4f97a186ff065bbc (patch) | |
tree | ce50c42dd81b741e666abd1030da2d68e5aa71c6 /usr.bin | |
parent | 292389e8003ee4b7508c7f9324857f3d4e6fa3ed (diff) | |
download | FreeBSD-src-b72a3c78cc671cb6b17ed6cf4f97a186ff065bbc.zip FreeBSD-src-b72a3c78cc671cb6b17ed6cf4f97a186ff065bbc.tar.gz |
man(7) -> mdoc(7).
Diffstat (limited to 'usr.bin')
-rw-r--r-- | usr.bin/hesinfo/hesinfo.1 | 300 |
1 files changed, 135 insertions, 165 deletions
diff --git a/usr.bin/hesinfo/hesinfo.1 b/usr.bin/hesinfo/hesinfo.1 index b43910c..226ff49 100644 --- a/usr.bin/hesinfo/hesinfo.1 +++ b/usr.bin/hesinfo/hesinfo.1 @@ -16,211 +16,181 @@ .\" M.I.T. makes no representations about the suitability of .\" this software for any purpose. It is provided "as is" .\" without express or implied warranty. -.TH HESINFO 1 "27 October 1996" -.FM mit -.SH NAME -hesinfo \- find out what is stored in the Hesiod database -.SH SYNOPSIS -.nf -hesinfo \fI[-bl]\fR \fIHesiodName\fR \fIHesiodNameType\fR -.SH DESCRIPTION -.I hesinfo +.Dd October 27, 1996 +.Dt HESINFO 1 +.Os +.Sh NAME +.Nm hesinfo +.Nd "find out what is stored in the Hesiod database" +.Sh SYNOPSIS +.Nm +.Op Fl bl +.Ar HesiodName HesiodNameType +.Sh DESCRIPTION +.Nm takes two arguments, a name to be resolved and a string, known -as a HesiodNameType. It then prints the information returned by +as a +.Ar HesiodNameType . +It then prints the information returned by the Hesiod nameserver. -.PP +.Pp The value returned by -.B hesinfo +.Nm is of the type -.I HesiodNameType. -.PP -.I hesinfo +.Ar HesiodNameType . +.Pp +.Nm understands the following options: -.TP -.B -l +.Bl -tag -width indent +.It Fl l Selects long format. -.TP -.B -b -Prints the fully-qualified string passed to the nameserver. - -.PP -.SS VALID Hesiod_Names +.It Fl b +Prints the fully\-qualified string passed to the nameserver. +.El +.Ss VALID Hesiod_Names The following types of identifiers may be used in the -.I HesiodName +.Ar HesiodName argument to -.B hesinfo. +.Nm . These values will be resolved by accessing the -.B hesiod +.Xr hesiod 3 database. - -.TP -.B \<username> -the 8-character-or-less string used to identify users or classes +.Bl -tag -width indent +.It Aq Ar username +the 8\-character\-or\-less string used to identify users or classes (e.g. joeuser, root, 1.00, etc). Used with the -.I Hesiod_Name_Types -.BR passwd, -.BR pobox, +.Ar Hesiod_Name_Types +.Cm passwd , +.Cm pobox , and -.BR filsys. - - -.TP -.B \<uid> +.Cm filsys . +.It Aq Ar uid the id number assigned to a user. - -.TP -.B \<groupid> +.It Aq Ar groupid the id number assigned to a group. - -.TP -.B \<groupname> +.It Aq Ar groupname a name identifying a unique group. - -.TP -.B \<file-system-name> -the name of an athena file system. - -.TP -.B \<rvd server>:<pack> -the name of an rvd's server and pack seperated by a colon. - -.TP -.B \<nfs server>:<partition> -the name of an nfs server and its partition seperated by a colon. - -.TP -.B \<workstation-name> -the machine name of an Athena workstation (e.g. E40-343-3). - -.TP -.B \<service-name> +.It Aq Ar file\-system\-name +the name of an Athena file system. +.It Xo +.Ao Ar "rvd\-server" Ac : Ns Aq Ar pack +.Xc +the name of an rvd's server and pack separated by a colon. +.It Xo +.Ao Ar "nfs\-server" Ac : Ns Aq Ar partition +.Xc +the name of an +.Tn NFS +server and its partition separated by a colon. +.It Aq Ar workstation\-name +the machine name of an Athena workstation (e.g. E40\-343\-3). +.It Aq Ar service\-name name of an Athena service (e.g. Zephyr). - -.TP -.B \<service-type> -name of Unix service (valid entries are defined in /etc/services). - -.TP -.B \<printer-name> +.It Aq Ar service\-type +name of +.Ux +service (valid entries are defined in +.Pa /etc/services ) . +.It Aq Ar printer\-name name of a printer. - -.TP -.B \<printer-cluster-name> +.It Aq Ar printer\-cluster\-name name of an Athena print cluster. - -.TP -.B \<foo> +.It Aq Ar foo some -.B hesinfo -calls (e.g. -.B prclusterlist -) do not require a specific -.I HesiodName -argument. However, you must include a dummy string (e.g. 'foo') for -.B hesinfo - to work properly. - - - - -.PP -.SS VALID Hesiod_Name_Types +.Nm +calls (e.g.\& +.Cm prclusterlist ) +do not require a specific +.Ar HesiodName +argument. +However, you must include a dummy string (e.g.\& +.Ql foo ) +for +.Nm +to work properly. +.El +.Ss VALID Hesiod_Name_Types The following symbols are valid substitutions for the -.I HesiodNameType +.Ar HesiodNameType argument to -.B hesinfo. - -.TP -.B \ passwd +.Nm . +.Bl -tag -width indent +.It Cm passwd returns string suitable for inclusion in -.I /etc/passwd, +.Pa /etc/passwd , searching with -.B <username>. - -.TP -.B \ pobox +.Aq Ar username . +.It Cm pobox returns information on the pobox assigned to the user specified by -.I HesiodName, +.Ar HesiodName , searching with -.B <username>. - - -.TP -.B \ uid +.Aq Ar username . +.It Cm uid returns string suitable for inclusion in -.I /etc/passwd, +.Pa /etc/passwd , searching with -.B <uid>. - -.TP -.B \ gid +.Aq Ar uid . +.It Cm gid returns string suitable for inclusion in -.I /etc/group, +.Pa /etc/group , searching with -.B <groupid>. - -.TP -.B \ group +.Aq Ar groupid . +.It Cm group returns string suitable for inclusion in -.I /etc/group, +.Pa /etc/group , searching with -.B <groupname>. - -.TP -.B \ grplist +.Aq Ar groupname . +.It Cm grplist returns subgroups included in superset defined by -.B <groupname>. - -.TP -.B \ filsys +.Aq Ar groupname . +.It Cm filsys returns file system type, export point, server, mount mode, and import point for the following valid -.I HesiodNames -(see above) -.B - <file system name>, <username>, <rvd server>:<pack>, -.B and <nfs server>:<partition> - -.TP -.B \ cluster +.Ar HesiodNames +(see above) - +.Aq Ar "file\-system\-name" , +.Aq Ar username , +.Ao Ar "rvd\-server" Ac : Ns Aq Ar pack , +and +.Ao Ar "nfs\-server" Ac : Ns Aq Ar partition . +.It Cm cluster returns information about the local cluster the workstation, specified by -.B <workstation name>. -Included is information about the local file and print servers. This -information is accesses by -.B clusterinfo +.Aq Ar "workstation\-name" . +Included is information about the local file and print servers. +This information is accesses by +.Sy clusterinfo at boot time. - -.TP -.B \ sloc +.It Cm sloc returns network name of service host for -.B <service-name>. - -.TP -.B \ service +.Aq Ar service\-name . +.It Cm service returns Internet protocol type and protocol service port for -.B <service-type>. - -.TP -.B \ pcap -returns a valid entry for /etc/printcap for -.B <printer-name>. - -.TP -.B \ prcluserlist +.Aq Ar service\-type . +.It Cm pcap +returns a valid entry for +.Pa /etc/printcap +for +.Aq Ar printer\-name . +.It Cm prcluserlist returns a list of print clusters. - -.TP -.B \ prcluster +.It Cm prcluster returns a list of printers in a cluster specified by -.B <printer-cluster-name>. - -.SH FILES -/etc/hesiod.conf -.SH "SEE ALSO" -`Hesiod - Project Athena Technical Plan -- Name Service', named(8), hesiod(3) -.SH AUTHOR -Steve Dyer, IBM/Project Athena -.br +.Aq Ar printer\-cluster\-name . +.El +.Sh FILES +.Bl -tag -width /etc/hesiod.conf +.It Pa /etc/hesiod.conf +.El +.Sh SEE ALSO +.Xr hesiod 3 , +.Xr named 8 +.Rs +.%T "Hesiod - Project Athena Technical Plan -- Name Service" +.Re +.Sh AUTHORS +.An Steve Dyer , +IBM/Project Athena +.Pp Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology. -.br |