jimzah/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src.git synced 2024-11-27 13:32:45 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

man(7) -> mdoc(7).

Browse Source
This commit is contained in:
Ruslan Ermilov 2001-01-16 17:04:17 +00:00
parent 1b66199389
commit 734e1e3b2e
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=71118
1 changed files with 135 additions and 165 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

300
usr.bin/hesinfo/hesinfo.1
View File

@ -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