man(7) -> mdoc(7).
This commit is contained in:
parent
1b66199389
commit
734e1e3b2e
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=71118
@ -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
|
||||
|
Loading…
Reference in New Issue
Block a user