home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / N / TCPIP / NETKIT-B.05 / NETKIT-B / NetKit-B-0.05 / finger / finger.1,v next >
Encoding:
Text File  |  1994-06-08  |  5.4 KB  |  191 lines
  1. head    1.1;
  2. access;
  3. symbols;
  4. locks
  5.     rzsfl:1.1; strict;
  6. comment    @# @;
  7.  
  8.  
  9. 1.1
  10. date    94.06.08.15.00.17;    author rzsfl;    state Exp;
  11. branches;
  12. next    ;
  13.  
  14.  
  15. desc
  16. @@
  17.  
  18.  
  19. 1.1
  20. log
  21. @Initial revision
  22. @
  23. text
  24. @.\" Copyright (c) 1989, 1990 The Regents of the University of California.
  25. .\" All rights reserved.
  26. .\"
  27. .\" Redistribution and use in source and binary forms, with or without
  28. .\" modification, are permitted provided that the following conditions
  29. .\" are met:
  30. .\" 1. Redistributions of source code must retain the above copyright
  31. .\"    notice, this list of conditions and the following disclaimer.
  32. .\" 2. Redistributions in binary form must reproduce the above copyright
  33. .\"    notice, this list of conditions and the following disclaimer in the
  34. .\"    documentation and/or other materials provided with the distribution.
  35. .\" 3. All advertising materials mentioning features or use of this software
  36. .\"    must display the following acknowledgement:
  37. .\"    This product includes software developed by the University of
  38. .\"    California, Berkeley and its contributors.
  39. .\" 4. Neither the name of the University nor the names of its contributors
  40. .\"    may be used to endorse or promote products derived from this software
  41. .\"    without specific prior written permission.
  42. .\"
  43. .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  44. .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  45. .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  46. .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  47. .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  48. .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  49. .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  50. .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  51. .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  52. .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  53. .\" SUCH DAMAGE.
  54. .\"
  55. .\"    from: @@(#)finger.1    6.14 (Berkeley) 7/27/91
  56. .\"    $Id: finger.1,v 1.3 1993/10/07 19:58:28 brezak Exp $
  57. .\"
  58. .Dd July 27, 1991
  59. .Dt FINGER 1
  60. .Os BSD 4
  61. .Sh NAME
  62. .Nm finger
  63. .Nd user information lookup program
  64. .Sh SYNOPSIS
  65. .Nm finger
  66. .Op Fl lmsp
  67. .Op Ar user ...
  68. .Op Ar user@@host ...
  69. .Sh DESCRIPTION
  70. The
  71. .Nm finger
  72. displays information about the system users.
  73. .Pp
  74. Options are:
  75. .Bl -tag -width flag
  76. .It Fl s
  77. .Nm Finger
  78. displays the user's login name, real name, terminal name and write
  79. status (as a ``*'' after the terminal name if write permission is
  80. denied), idle time, login time, office location and office phone
  81. number.
  82. .Pp
  83. Idle time is in minutes if it is a single integer, hours and minutes
  84. if a ``:'' is present, or days if a ``d'' is present.
  85. Login time is displayed as month, day, hours and minutes, unless
  86. more than six months ago, in which case the year is displayed rather
  87. than the hours and minutes.
  88. .Pp
  89. Unknown devices as well as nonexistent idle and login times are
  90. displayed as single asterisks.
  91. .Pp
  92. .It Fl l
  93. Produces a multi-line format displaying all of the information
  94. described for the
  95. .Fl s
  96. option as well as the user's home directory, home phone number, login
  97. shell, mail status, and the contents of the files
  98. .Dq Pa .plan
  99. and
  100. .Dq Pa .project
  101. from the user's home directory.
  102. .Pp
  103. If idle time is at least a minute and less than a day, it is
  104. presented in the form ``hh:mm''.
  105. Idle times greater than a day are presented as ``d day[s]hh:mm''.
  106. .Pp
  107. Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
  108. Numbers specified as ten or seven digits are printed as the appropriate
  109. subset of that string.
  110. Numbers specified as five digits are printed as ``xN-NNNN''.
  111. Numbers specified as four digits are printed as ``xNNNN''.
  112. .Pp
  113. If write permission is denied to the device, the phrase ``(messages off)''
  114. is appended to the line containing the device name.
  115. One entry per user is displayed with the
  116. .Fl l
  117. option; if a user is logged on multiple times, terminal information
  118. is repeated once per login.
  119. .Pp
  120. Mail status is shown as ``No Mail.'' if there is no mail at all,
  121. ``Mail last read DDD MMM ## HH:MM YYYY (TZ)'' if the person has looked
  122. at their mailbox since new mail arriving, or ``New mail received ...'',
  123. ``  Unread since ...'' if they have new mail.
  124. .Pp
  125. .It Fl p
  126. Prevents
  127. the
  128. .Fl l
  129. option of
  130. .Nm finger
  131. from displaying the contents of the
  132. .Dq Pa .plan
  133. and
  134. .Dq Pa .project
  135. files.
  136. .It Fl m
  137. Prevent matching of
  138. .Ar user
  139. names.
  140. .Ar User
  141. is usually a login name; however, matching will also be done on the
  142. users' real names, unless the
  143. .Fl m
  144. option is supplied.
  145. All name matching performed by
  146. .Nm finger
  147. is case insensitive.
  148. .El
  149. .Pp
  150. If no options are specified,
  151. .Nm finger
  152. defaults to the
  153. .Fl l
  154. style output if operands are provided, otherwise to the
  155. .Fl s
  156. style.
  157. Note that some fields may be missing, in either format, if information
  158. is not available for them.
  159. .Pp
  160. If no arguments are specified,
  161. .Nm finger
  162. will print an entry for each user currently logged into the system.
  163. .Pp
  164. .Nm Finger
  165. may be used to look up users on a remote machine.
  166. The format is to specify a
  167. .Ar user
  168. as
  169. .Dq Li user@@host ,
  170. or
  171. .Dq Li @@host ,
  172. where the default output
  173. format for the former is the
  174. .Fl l
  175. style, and the default output format for the latter is the
  176. .Fl s
  177. style.
  178. The
  179. .Fl l
  180. option is the only option that may be passed to a remote machine.
  181. .Sh SEE ALSO
  182. .Xr chpass 1 ,
  183. .Xr w 1 ,
  184. .Xr who 1 ,
  185. .Sh HISTORY
  186. The
  187. .Nm finger
  188. command appeared in
  189. .Bx 3.0 .
  190. @
  191.