186 lines
4.6 KiB
Groff
186 lines
4.6 KiB
Groff
.\" $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 #
|
|
.\"
|
|
.\" Copyright 1987, 1996 by the Massachusetts Institute of Technology.
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this
|
|
.\" software and its documentation for any purpose and without
|
|
.\" fee is hereby granted, provided that the above copyright
|
|
.\" notice appear in all copies and that both that copyright
|
|
.\" notice and this permission notice appear in supporting
|
|
.\" documentation, and that the name of M.I.T. not be used in
|
|
.\" advertising or publicity pertaining to distribution of the
|
|
.\" software without specific, written prior permission.
|
|
.\" 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.
|
|
.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
|
|
.Ar HesiodNameType .
|
|
It then prints the information returned by
|
|
the Hesiod nameserver.
|
|
.Pp
|
|
The value returned by
|
|
.Nm
|
|
is of the type
|
|
.Ar HesiodNameType .
|
|
.Pp
|
|
.Nm
|
|
understands the following options:
|
|
.Bl -tag -width XX -offset indent
|
|
.It Fl l
|
|
Selects long format.
|
|
.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
|
|
.Ar HesiodName
|
|
argument to
|
|
.Nm .
|
|
These values will be resolved by accessing the
|
|
.Xr hesiod 3
|
|
database.
|
|
.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
|
|
.Ar Hesiod_Name_Types
|
|
.Dv passwd ,
|
|
.Dv pobox ,
|
|
and
|
|
.Dv filsys .
|
|
.It Aq uid
|
|
the id number assigned to a user.
|
|
.It Aq groupid
|
|
the id number assigned to a group.
|
|
.It Aq groupname
|
|
a name identifying a unique group.
|
|
.It Aq file-system-name
|
|
the name of an athena file system.
|
|
.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.
|
|
.It Aq workstation-name
|
|
the machine name of an Athena workstation (e.g. E40-343-3).
|
|
.It Aq service-name
|
|
name of an Athena service (e.g. Zephyr).
|
|
.It Aq service-type
|
|
name of Unix service (valid entries are defined in
|
|
.Pa /etc/services ) .
|
|
.It Aq printer-name
|
|
name of a printer.
|
|
.It Aq printer-cluster-name
|
|
name of an Athena print cluster.
|
|
.It Aq foo
|
|
some
|
|
.Nm
|
|
calls (e.g.,
|
|
.Dv prclusterlist )
|
|
do not require a specific
|
|
.Ar HesiodName
|
|
argument.
|
|
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
|
|
.Ar HesiodNameType
|
|
argument to
|
|
.Nm .
|
|
.Bl -tag -width passwdX
|
|
.It passwd
|
|
returns string suitable for inclusion in
|
|
.Pa /etc/passwd ,
|
|
searching with
|
|
.Aq username .
|
|
.It pobox
|
|
returns information on the pobox assigned to the user specified by
|
|
.Ar HesiodName ,
|
|
searching with
|
|
.Aq username .
|
|
.It uid
|
|
returns string suitable for inclusion in
|
|
.Pa /etc/passwd ,
|
|
searching with
|
|
.Aq uid .
|
|
.It gid
|
|
returns string suitable for inclusion in
|
|
.Pa /etc/group ,
|
|
searching with
|
|
.Aq groupid .
|
|
.It group
|
|
returns string suitable for inclusion in
|
|
.Pa /etc/group ,
|
|
searching with
|
|
.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
|
|
.Aq workstation name .
|
|
Included is information about the local file and print servers.
|
|
This information is accesses by
|
|
.Dv clusterinfo
|
|
at boot time.
|
|
.It sloc
|
|
returns network name of service host for
|
|
.Aq service-name .
|
|
.It service
|
|
returns Internet protocol type and protocol service port for
|
|
.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.
|
|
.It prcluster
|
|
returns a list of printers in a cluster specified by
|
|
.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.
|