share/man/man1/finger.1

   1 '\" te
   2 .\" Copyright 1989 AT&T
   3 .\" Copyright (c) 1980 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement specifies the terms and conditions for redistribution.
   4 .\"   Copyright (c) 2000, Sun Microsystems, Inc.  All Rights Reserved.
   5 .TH FINGER 1 "Nov 9, 2015"
   6 .SH NAME
   7 finger \- display information about local and remote users
   8 .SH SYNOPSIS
   9 .LP
  10 .nf
  11 \fBfinger\fR [\fB-bfhilmpqsw\fR] [\fIusername\fR]...
  12 .fi
  13
  14 .LP
  15 .nf
  16 \fBfinger\fR [\fB-l\fR]
  17      [\fIusername@hostname\fR 1 [\fI@hostname\fR 2 \fI\&..\fR \fI\&.@hostname\fR n]...]
  18 .fi
  19
  20 .LP
  21 .nf
  22 \fBfinger\fR [\fB-l\fR] [\fI@hostname\fR 1 [\fI@hostname\fR 2 \fI\&..\fR \fI\&.@hostname\fR n]...]
  23 .fi
  24
  25 .SH DESCRIPTION
  26 .LP
  27 By default, the \fBfinger\fR command displays in multi-column format the
  28 following information about each logged-in user:
  29 .RS +4
  30 .TP
  31 .ie t \(bu
  32 .el o
  33 user name
  34 .RE
  35 .RS +4
  36 .TP
  37 .ie t \(bu
  38 .el o
  39 user's full name
  40 .RE
  41 .RS +4
  42 .TP
  43 .ie t \(bu
  44 .el o
  45 terminal name (prepended with a `*\|' (asterisk)  if write-permission is
  46 denied)
  47 .RE
  48 .RS +4
  49 .TP
  50 .ie t \(bu
  51 .el o
  52 idle time
  53 .RE
  54 .RS +4
  55 .TP
  56 .ie t \(bu
  57 .el o
  58 login time
  59 .RE
  60 .RS +4
  61 .TP
  62 .ie t \(bu
  63 .el o
  64 host name, if logged in remotely
  65 .RE
  66 .sp
  67 .LP
  68 Idle time is in minutes if it is a single integer, in hours and minutes if a
  69 `:\|' (colon)  is present, or in days and hours if a `d' is present.
  70 .sp
  71 .LP
  72 When one or more \fIusername\fR arguments are given, more detailed information
  73 is given for each \fIusername\fR specified, whether they are logged in or not.
  74 \fIusername\fR must be that of a local user, and may be a first or last name,
  75 or an account name. Information is presented in multi-line format as follows:
  76 .RS +4
  77 .TP
  78 .ie t \(bu
  79 .el o
  80 the user name and the user's full name
  81 .RE
  82 .RS +4
  83 .TP
  84 .ie t \(bu
  85 .el o
  86 the user's home directory and login shell
  87 .RE
  88 .RS +4
  89 .TP
  90 .ie t \(bu
  91 .el o
  92 time the user logged in if currently logged in, or the time the user last
  93 logged in; and the terminal or host from which the user logged in
  94 .RE
  95 .RS +4
  96 .TP
  97 .ie t \(bu
  98 .el o
  99 last time the user received mail, and the last time the user read mail
 100 .RE
 101 .RS +4
 102 .TP
 103 .ie t \(bu
 104 .el o
 105 the first line of the \fB$HOME/.project\fR file, if it exists
 106 .RE
 107 .RS +4
 108 .TP
 109 .ie t \(bu
 110 .el o
 111 the contents of the \fB$HOME/.plan\fR file, if it exists
 112 .RE
 113 .sp
 114 .LP
 115 Note: when the comment (GECOS) field in \fB/etc/passwd\fR includes a comma,
 116 \fBfinger\fR does not display the information following the comma.
 117 .sp
 118 .LP
 119 If the arguments
 120 \fIusername@hostname\fR1[\fI@hostname\fR2\fI\|.\|.\|.@hostname\fRn] or
 121 \fI@hostname\fR1[\fI@hostname\fR2\fI\|.\|.\|.@hostname\fRn] are used, the
 122 request is sent first to \fBhostname\fRn and forwarded through each
 123 \fBhostname\fRn-1 to  \fBhostname\fR1. The program uses the \fBfinger user
 124 information protocol\fR (see RFC 1288) to query that remote host for
 125 information about the named user (if  \fIusername\fR is specified), or about
 126 each logged-in user. The information displayed is server dependent.
 127 .sp
 128 .LP
 129 As required by RFC 1288, \fBfinger\fR passes only printable, 7-bit \fBASCII\fR
 130 data. This behavior may be modified by a system administrator by using the
 131 \fBPASS\fR option in \fB/etc/default/finger\fR. Specifying \fBPASS=low\fR
 132 allows all characters less than decimal 32 ASCII. Specifying \fBPASS=high\fR
 133 allows all characters greater than decimal 126 \fBASCII\fR. \fBPASS=low,high\fR
 134 or \fBPASS=high,low\fR allows both characters less than 32 and greater than 126
 135 to pass through.
 136 .SH OPTIONS
 137 .LP
 138 The following options are supported, except that the  \fIusername@hostname\fR
 139 form supports only the \fB-l\fR option:
 140 .sp
 141 .ne 2
 142 .na
 143 \fB\fB-b\fR \fR
 144 .ad
 145 .RS 7n
 146 Suppresses printing the user's home directory and shell in a long format
 147 printout.
 148 .RE
 149
 150 .sp
 151 .ne 2
 152 .na
 153 \fB\fB-f\fR \fR
 154 .ad
 155 .RS 7n
 156 Suppresses printing the header that is normally printed in a non-long format
 157 printout.
 158 .RE
 159
 160 .sp
 161 .ne 2
 162 .na
 163 \fB\fB-h\fR \fR
 164 .ad
 165 .RS 7n
 166 Suppresses printing of the \fB\&.project\fR file in a long format printout.
 167 .RE
 168
 169 .sp
 170 .ne 2
 171 .na
 172 \fB\fB-i\fR \fR
 173 .ad
 174 .RS 7n
 175 Forces "idle" output format, which is similar to short format except that only
 176 the login name, terminal, login time, and idle time are printed.
 177 .RE
 178
 179 .sp
 180 .ne 2
 181 .na
 182 \fB\fB-l\fR \fR
 183 .ad
 184 .RS 7n
 185 Forces long output format.
 186 .RE
 187
 188 .sp
 189 .ne 2
 190 .na
 191 \fB\fB-m\fR \fR
 192 .ad
 193 .RS 7n
 194 Matches arguments only on user name (not first or last name).
 195 .RE
 196
 197 .sp
 198 .ne 2
 199 .na
 200 \fB\fB-p\fR \fR
 201 .ad
 202 .RS 7n
 203 Suppresses printing of the \fB\&.plan\fR file in a long format printout.
 204 .RE
 205
 206 .sp
 207 .ne 2
 208 .na
 209 \fB\fB-q\fR \fR
 210 .ad
 211 .RS 7n
 212 Forces quick output format, which is similar to short format except that only
 213 the login name, terminal, and login time are printed.
 214 .RE
 215
 216 .sp
 217 .ne 2
 218 .na
 219 \fB\fB-s\fR \fR
 220 .ad
 221 .RS 7n
 222 Forces short output format.
 223 .RE
 224
 225 .sp
 226 .ne 2
 227 .na
 228 \fB\fB-w\fR \fR
 229 .ad
 230 .RS 7n
 231 Suppresses printing the full name in a short format printout.
 232 .RE
 233
 234 .SH FILES
 235 .ne 2
 236 .na
 237 \fB\fB$HOME/.plan    \fR \fR
 238 .ad
 239 .RS 24n
 240 user's plan
 241 .RE
 242
 243 .sp
 244 .ne 2
 245 .na
 246 \fB\fB$HOME/.project\fR \fR
 247 .ad
 248 .RS 24n
 249 user's projects
 250 .RE
 251
 252 .sp
 253 .ne 2
 254 .na
 255 \fB\fB/etc/default/finger\fR \fR
 256 .ad
 257 .RS 24n
 258 \fBfinger\fR options file
 259 .RE
 260
 261 .sp
 262 .ne 2
 263 .na
 264 \fB\fB/etc/passwd\fR\fR
 265 .ad
 266 .RS 24n
 267 password file
 268 .RE
 269
 270 .sp
 271 .ne 2
 272 .na
 273 \fB\fB/var/log/lastlog.v2\fR \fR
 274 .ad
 275 .RS 24n
 276 time of last login
 277 .RE
 278
 279 .sp
 280 .ne 2
 281 .na
 282 \fB\fB/var/log/utmpx\fR \fR
 283 .ad
 284 .RS 24n
 285 accounting
 286 .RE
 287
 288 .SH SEE ALSO
 289 .LP
 290 \fBpasswd\fR(1), \fBwho\fR(1), \fBwhois\fR(1), \fBpasswd\fR(4),
 291 \fBattributes\fR(5)
 292 .sp
 293 .LP
 294 Zimmerman, D., \fIThe Finger User Information Protocol\fR, RFC 1288, Center for
 295 Discrete Mathematics and Theoretical Computer Science (DIMACS), Rutgers
 296 University, December 1991.
 297 .SH NOTES
 298 .LP
 299 The \fBfinger user information protocol\fR limits the options that may be used
 300 with the remote form of this command.