Convert to mdoc.
This commit is contained in:
wiz
parent
d9c0b26cbc
commit
d581e50802
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: hesinfo.1,v 1.8 2003/06/27 08:50:50 wiz Exp $
|
||||
.\" $NetBSD: hesinfo.1,v 1.9 2003/11/12 12:33:13 wiz Exp $
|
||||
.\"
|
||||
.\" from: #Id: hesinfo.1,v 1.9 1996/11/07 01:57:12 ghudson Exp #
|
||||
.\"
|
||||
@ -15,213 +15,171 @@
|
||||
.\" 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
|
||||
.Ar HesiodNameType
|
||||
.Sh DESCRIPTION
|
||||
.Nm
|
||||
takes two arguments, a name to be resolved and a string, known
|
||||
as a HesiodNameType.
|
||||
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 XX -offset indent
|
||||
.It Fl l
|
||||
Selects long format.
|
||||
.TP
|
||||
.B -b
|
||||
.It Fl b
|
||||
Prints the fully-qualified string passed to the nameserver.
|
||||
|
||||
.PP
|
||||
.SS VALID Hesiod_Names
|
||||
.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 \\*[Lt]username\*[Gt]
|
||||
.Bl -tag -width XnfsXserverX:XpartitionXX
|
||||
.It Aq 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
|
||||
.Dv passwd ,
|
||||
.Dv pobox ,
|
||||
and
|
||||
.BR filsys.
|
||||
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]uid\*[Gt]
|
||||
.Dv filsys .
|
||||
.It Aq uid
|
||||
the id number assigned to a user.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]groupid\*[Gt]
|
||||
.It Aq groupid
|
||||
the id number assigned to a group.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]groupname\*[Gt]
|
||||
.It Aq groupname
|
||||
a name identifying a unique group.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]file-system-name\*[Gt]
|
||||
.It Aq file-system-name
|
||||
the name of an athena file system.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]rvd server\*[Gt]:\*[Lt]pack\*[Gt]
|
||||
the name of an rvd's server and pack separated by a colon.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]nfs server\*[Gt]:\*[Lt]partition\*[Gt]
|
||||
.It Ao rvd server Ac Ns : Ns Aq pack
|
||||
the name of an rvd's server and pack separated by a colon.
|
||||
.It Ao nfs server Ac Ns : Ns Aq partition
|
||||
the name of an nfs server and its partition separated by a colon.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]workstation-name\*[Gt]
|
||||
.It Aq workstation-name
|
||||
the machine name of an Athena workstation (e.g. E40-343-3).
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]service-name\*[Gt]
|
||||
.It Aq service-name
|
||||
name of an Athena service (e.g. Zephyr).
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]service-type\*[Gt]
|
||||
name of Unix service (valid entries are defined in /etc/services).
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]printer-name\*[Gt]
|
||||
.It Aq service-type
|
||||
name of Unix service (valid entries are defined in
|
||||
.Pa /etc/services ) .
|
||||
.It Aq printer-name
|
||||
name of a printer.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]printer-cluster-name\*[Gt]
|
||||
.It Aq printer-cluster-name
|
||||
name of an Athena print cluster.
|
||||
|
||||
.TP
|
||||
.B \\*[Lt]foo\*[Gt]
|
||||
.It Aq foo
|
||||
some
|
||||
.B hesinfo
|
||||
calls (e.g.
|
||||
.B prclusterlist
|
||||
) do not require a specific
|
||||
.I HesiodName
|
||||
.Nm
|
||||
calls (e.g.,
|
||||
.Dv prclusterlist )
|
||||
do not require a specific
|
||||
.Ar HesiodName
|
||||
argument.
|
||||
However, you must include a dummy string (e.g. 'foo') for
|
||||
.B hesinfo
|
||||
to work properly.
|
||||
|
||||
|
||||
|
||||
|
||||
.PP
|
||||
.SS VALID Hesiod_Name_Types
|
||||
However, you must include a dummy string (e.g.,
|
||||
.Dq 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 passwdX
|
||||
.It passwd
|
||||
returns string suitable for inclusion in
|
||||
.I /etc/passwd,
|
||||
.Pa /etc/passwd ,
|
||||
searching with
|
||||
.B \*[Lt]username\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ pobox
|
||||
.Aq username .
|
||||
.It pobox
|
||||
returns information on the pobox assigned to the user specified by
|
||||
.I HesiodName,
|
||||
.Ar HesiodName ,
|
||||
searching with
|
||||
.B \*[Lt]username\*[Gt].
|
||||
|
||||
|
||||
.TP
|
||||
.B \ uid
|
||||
.Aq username .
|
||||
.It uid
|
||||
returns string suitable for inclusion in
|
||||
.I /etc/passwd,
|
||||
.Pa /etc/passwd ,
|
||||
searching with
|
||||
.B \*[Lt]uid\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ gid
|
||||
.Aq uid .
|
||||
.It gid
|
||||
returns string suitable for inclusion in
|
||||
.I /etc/group,
|
||||
.Pa /etc/group ,
|
||||
searching with
|
||||
.B \*[Lt]groupid\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ group
|
||||
.Aq groupid .
|
||||
.It group
|
||||
returns string suitable for inclusion in
|
||||
.I /etc/group,
|
||||
.Pa /etc/group ,
|
||||
searching with
|
||||
.B \*[Lt]groupname\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ grplist
|
||||
returns subgroups included in superset
|
||||
defined by
|
||||
.B \*[Lt]groupname\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ filsys
|
||||
returns file system type, export point, server, mount mode, and import point
|
||||
for the following valid
|
||||
.I HesiodNames
|
||||
(see above)
|
||||
.B - \*[Lt]file system name\*[Gt], \*[Lt]username\*[Gt], \*[Lt]rvd server\*[Gt]:\*[Lt]pack\*[Gt],
|
||||
.B and \*[Lt]nfs server\*[Gt]:\*[Lt]partition\*[Gt]
|
||||
|
||||
.TP
|
||||
.B \ cluster
|
||||
.Aq groupname .
|
||||
.It grplist
|
||||
returns subgroups included in superset defined by
|
||||
.Aq groupname .
|
||||
.It filsys
|
||||
returns file system type, export point, server, mount mode, and
|
||||
import point for the following valid
|
||||
.Ar HesiodNames
|
||||
(see above) -
|
||||
.Aq Dv file system name ,
|
||||
.Aq Dv username ,
|
||||
.Ao Dv rvd server Ac Ns : Ns Aq pack ,
|
||||
and
|
||||
.Ao Dv nfs server Ac Ns : Ns Aq partition .
|
||||
.It cluster
|
||||
returns information about the local cluster the workstation, specified by
|
||||
.B \*[Lt]workstation name\*[Gt].
|
||||
Included is information about the local file and print servers. This
|
||||
information is accesses by
|
||||
.B clusterinfo
|
||||
.Aq workstation name .
|
||||
Included is information about the local file and print servers.
|
||||
This information is accesses by
|
||||
.Dv clusterinfo
|
||||
at boot time.
|
||||
|
||||
.TP
|
||||
.B \ sloc
|
||||
.It sloc
|
||||
returns network name of service host for
|
||||
.B \*[Lt]service-name\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ service
|
||||
.Aq service-name .
|
||||
.It service
|
||||
returns Internet protocol type and protocol service port for
|
||||
.B \*[Lt]service-type\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ pcap
|
||||
returns a valid entry for /etc/printcap for
|
||||
.B \*[Lt]printer-name\*[Gt].
|
||||
|
||||
.TP
|
||||
.B \ prcluserlist
|
||||
.Aq service-type .
|
||||
.It pcap
|
||||
returns a valid entry for
|
||||
.Pa /etc/printcap
|
||||
for
|
||||
.Aq printer-name .
|
||||
.It prcluserlist
|
||||
returns a list of print clusters.
|
||||
|
||||
.TP
|
||||
.B \ prcluster
|
||||
.It prcluster
|
||||
returns a list of printers in a cluster specified by
|
||||
.B \*[Lt]printer-cluster-name\*[Gt].
|
||||
|
||||
.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 printer-cluster-name .
|
||||
.El
|
||||
.Sh FILES
|
||||
.Pa /etc/hesiod.conf
|
||||
.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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user