Debian Codegraph @

upstream/debian-unstable/man1/finger.1

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