usr.bin/hesinfo/hesinfo.1

   1 .\"     $NetBSD: hesinfo.1,v 1.1 1999/01/25 22:45:55 lukem Exp $
   2 .\"
   3 .\" from: #Id: hesinfo.1,v 1.9 1996/11/07 01:57:12 ghudson Exp #
   4 .\"
   5 .\" Copyright 1987, 1996 by the Massachusetts Institute of Technology.
   6 .\"
   7 .\" Permission to use, copy, modify, and distribute this
   8 .\" software and its documentation for any purpose and without
   9 .\" fee is hereby granted, provided that the above copyright
  10 .\" notice appear in all copies and that both that copyright
  11 .\" notice and this permission notice appear in supporting
  12 .\" documentation, and that the name of M.I.T. not be used in
  13 .\" advertising or publicity pertaining to distribution of the
  14 .\" software without specific, written prior permission.
  15 .\" M.I.T. makes no representations about the suitability of
  16 .\" this software for any purpose.  It is provided "as is"
  17 .\" without express or implied warranty.
  18 .\"
  19 .Dd June 27, 2022
  20 .Dt HESINFO 1
  21 .Os
  22 .Sh NAME
  23 .Nm hesinfo
  24 .Nd "find out what is stored in the Hesiod database"
  25 .Sh SYNOPSIS
  26 .Nm
  27 .Op Fl bl
  28 .Ar HesiodName HesiodNameType
  29 .Sh DESCRIPTION
  30 The
  31 .Nm
  32 utility takes two arguments, a name to be resolved and a string, known
  33 as a
  34 .Ar HesiodNameType .
  35 It then prints the information returned by
  36 the Hesiod nameserver.
  37 .Pp
  38 The value returned by
  39 .Nm
  40 is of the type
  41 .Ar HesiodNameType .
  42 .Pp
  43 The following options are available:
  44 .Bl -tag -width indent
  45 .It Fl l
  46 Selects long format.
  47 .It Fl b
  48 Prints the fully\-qualified string passed to the nameserver.
  49 .El
  50 .Ss VALID Hesiod_Names
  51 The following types of identifiers may be used in the
  52 .Ar HesiodName
  53 argument to
  54 .Nm .
  55 These values will be resolved by accessing the
  56 .Xr hesiod 3
  57 database.
  58 .Bl -tag -width indent
  59 .It Aq Ar username
  60 the 8\-character\-or\-less string used to identify users or classes
  61 (e.g.\& joeuser, root, 1.00, etc).
  62 Used with the
  63 .Ar Hesiod_Name_Types
  64 .Cm passwd ,
  65 .Cm pobox ,
  66 and
  67 .Cm filsys .
  68 .It Aq Ar uid
  69 the id number assigned to a user.
  70 .It Aq Ar groupid
  71 the id number assigned to a group.
  72 .It Aq Ar groupname
  73 a name identifying a unique group.
  74 .It Aq Ar file\-system\-name
  75 the name of an Athena file system.
  76 .It Xo
  77 .Ao Ar "rvd\-server" Ac : Ns Aq Ar pack
  78 .Xc
  79 the name of an rvd's server and pack separated by a colon.
  80 .It Xo
  81 .Ao Ar "nfs\-server" Ac : Ns Aq Ar partition
  82 .Xc
  83 the name of an
  84 .Tn NFS
  85 server and its partition separated by a colon.
  86 .It Aq Ar workstation\-name
  87 the machine name of an Athena workstation (e.g.\& E40\-343\-3).
  88 .It Aq Ar service\-name
  89 name of an Athena service (e.g.\& Zephyr).
  90 .It Aq Ar service\-type
  91 name of
  92 .Ux
  93 service (valid entries are defined in
  94 .Pa /etc/services ) .
  95 .It Aq Ar printer\-name
  96 name of a printer.
  97 .It Aq Ar printer\-cluster\-name
  98 name of an Athena print cluster.
  99 .It Aq Ar foo
 100 some
 101 .Nm
 102 calls (e.g.\&
 103 .Cm prclusterlist )
 104 do not require a specific
 105 .Ar HesiodName
 106 argument.
 107 However, you must include a dummy string (e.g.\&
 108 .Ql foo )
 109 for
 110 .Nm
 111 to work properly.
 112 .El
 113 .Ss VALID Hesiod_Name_Types
 114 The following symbols are valid substitutions for the
 115 .Ar HesiodNameType
 116 argument to
 117 .Nm .
 118 .Bl -tag -width indent
 119 .It Cm passwd
 120 returns string suitable for inclusion in
 121 .Pa /etc/passwd ,
 122 searching with
 123 .Aq Ar username .
 124 .It Cm pobox
 125 returns information on the pobox assigned to the user specified by
 126 .Ar HesiodName ,
 127 searching with
 128 .Aq Ar username .
 129 .It Cm uid
 130 returns string suitable for inclusion in
 131 .Pa /etc/passwd ,
 132 searching with
 133 .Aq Ar uid .
 134 .It Cm gid
 135 returns string suitable for inclusion in
 136 .Pa /etc/group ,
 137 searching with
 138 .Aq Ar groupid .
 139 .It Cm group
 140 returns string suitable for inclusion in
 141 .Pa /etc/group ,
 142 searching with
 143 .Aq Ar groupname .
 144 .It Cm grplist
 145 returns subgroups included in superset
 146 defined by
 147 .Aq Ar groupname .
 148 .It Cm filsys
 149 returns file system type, export point, server, mount mode, and import point
 150 for the following valid
 151 .Ar HesiodNames
 152 (see above) -
 153 .Aq Ar "file\-system\-name" ,
 154 .Aq Ar username ,
 155 .Ao Ar "rvd\-server" Ac : Ns Aq Ar pack ,
 156 and
 157 .Ao Ar "nfs\-server" Ac : Ns Aq Ar partition .
 158 .It Cm cluster
 159 returns information about the local cluster the workstation, specified by
 160 .Aq Ar "workstation\-name" .
 161 Included is information about the local file and print servers.
 162 This information is accesses by
 163 .Sy clusterinfo
 164 at boot time.
 165 .It Cm sloc
 166 returns network name of service host for
 167 .Aq Ar service\-name .
 168 .It Cm service
 169 returns Internet protocol type and protocol service port for
 170 .Aq Ar service\-type .
 171 .It Cm pcap
 172 returns a valid entry for
 173 .Pa /etc/printcap
 174 for
 175 .Aq Ar printer\-name .
 176 .It Cm prcluserlist
 177 returns a list of print clusters.
 178 .It Cm prcluster
 179 returns a list of printers in a cluster specified by
 180 .Aq Ar printer\-cluster\-name .
 181 .El
 182 .Sh FILES
 183 .Bl -tag -width /etc/hesiod.conf
 184 .It Pa /etc/hesiod.conf
 185 .El
 186 .Sh SEE ALSO
 187 .Xr hesiod 3
 188 .Rs
 189 .%T "Hesiod - Project Athena Technical Plan -- Name Service"
 190 .Re
 191 .Sh AUTHORS
 192 .An Steve Dyer ,
 193 IBM/Project Athena
 194 .Pp
 195 Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology.