Commit | Line | Data |
---|---|---|
6b8910b8 | 1 | .\" Copyright (c) 1989 The Regents of the University of California. |
a46f6f3d | 2 | .\" All rights reserved. |
b2575e31 | 3 | .\" |
a46f6f3d KB |
4 | .\" Redistribution and use in source and binary forms are permitted |
5 | .\" provided that the above copyright notice and this paragraph are | |
6 | .\" duplicated in all such forms and that any documentation, | |
7 | .\" advertising materials, and other materials related to such | |
8 | .\" distribution and use acknowledge that the software was developed | |
9 | .\" by the University of California, Berkeley. The name of the | |
10 | .\" University may not be used to endorse or promote products derived | |
11 | .\" from this software without specific prior written permission. | |
12 | .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR | |
13 | .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED | |
6b8910b8 | 14 | .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
a46f6f3d | 15 | .\" |
676398e3 | 16 | .\" @(#)finger.1 6.7 (Berkeley) %G% |
b2575e31 | 17 | .\" |
efb2a383 | 18 | .TH FINGER 1 "" |
b2575e31 KM |
19 | .UC 4 |
20 | .SH NAME | |
21 | finger \- user information lookup program | |
22 | .SH SYNOPSIS | |
23 | .B finger | |
24 | [ | |
6b8910b8 KB |
25 | .B -lmsp |
26 | ] [user [@host] ...] | |
b2575e31 | 27 | .SH DESCRIPTION |
6b8910b8 | 28 | The |
b2575e31 | 29 | .I finger |
6b8910b8 KB |
30 | command has two basic output formats providing essentially the same |
31 | information. | |
b2575e31 | 32 | .PP |
6b8910b8 KB |
33 | The |
34 | .I -s | |
35 | option of | |
b2575e31 | 36 | .I finger |
6b8910b8 KB |
37 | displays the user's login name, real name, terminal name and write |
38 | status (as a ``*'' after the terminal name if write permission is | |
39 | denied), idle time, login time, office location and office phone | |
40 | number. | |
b2575e31 | 41 | .PP |
6b8910b8 KB |
42 | Idle time is in minutes if it is a single integer, hours and minutes |
43 | if a ``:'' is present, or days if a ``d'' is present. | |
44 | Login time is displayed as month, day, hours and minutes, unless | |
45 | more than six months ago, in which case the year is displayed rather | |
46 | than the hours and minutes. | |
2f96ea34 | 47 | .PP |
676398e3 KB |
48 | Unknown devices as well as nonexistent idle and login times are |
49 | displayed as single asterisks. | |
50 | .PP | |
6b8910b8 KB |
51 | The |
52 | .I -l | |
53 | option produces a multi-line format displaying all of the information | |
54 | described for the | |
55 | .I -s | |
56 | option as well as the user's home directory, login shell, and the | |
57 | contents of the files | |
58 | .I ``.plan'' | |
59 | and | |
60 | .I ``.project'' | |
61 | from the user's home directory. | |
62 | .PP | |
63 | If idle time is at least a minute and less than a day, it is | |
64 | presented in the form ``hh:mm''. | |
65 | Idle times greater than a day are presented as ``d day[s] hh:mm''. | |
66 | .PP | |
67 | If write permission is denied to the device, the phrase ``(messages | |
68 | off)'' is appended to the line containing the device name. | |
69 | One entry per user is displayed with the | |
70 | .IR -l | |
71 | option; if a user is logged on multiple times, terminal information | |
72 | is repeated once per login. | |
73 | .PP | |
74 | Additionally, | |
75 | .IR -l | |
76 | provides information regarding mail arrival and ``last read'' | |
77 | time for the user. | |
b2575e31 | 78 | .PP |
6b8910b8 KB |
79 | The |
80 | .I -p | |
81 | option prevents | |
82 | the | |
83 | .I -l | |
84 | option of | |
85 | .I finger | |
86 | from displaying the contents of the ``.plan'' and ``.project'' | |
87 | files. | |
88 | .PP | |
89 | Note that some fields may be missing, in either format, if information | |
90 | is not available for them. | |
b2575e31 | 91 | .PP |
6b8910b8 KB |
92 | If no operands are specified, |
93 | .I finger | |
94 | will print an entry for each user currently logged into the system. | |
95 | If no options are specified, | |
2f96ea34 | 96 | .I finger |
6b8910b8 KB |
97 | defaults to the |
98 | .I -l | |
99 | style output if operands are provided, otherwise to the | |
100 | .I -s | |
101 | style. | |
2f96ea34 | 102 | .PP |
6b8910b8 KB |
103 | .I User |
104 | is usually a login name; however, matching will also be done on the | |
105 | users' real names, unless the | |
106 | .I -m | |
107 | option is supplied. | |
108 | All name matching performed by | |
b2575e31 | 109 | .I finger |
6b8910b8 KB |
110 | is case insensitive. |
111 | .PP | |
112 | .I Finger | |
113 | may be used to look up users on a remote machine. | |
114 | The format is to specify a | |
115 | .I user | |
116 | as ``user@host'', or ``@host'', where the default output | |
117 | format for the former is the | |
118 | .I -l | |
119 | style, and the default output format for the latter is the | |
120 | .IR -s | |
121 | style. | |
122 | The | |
123 | .I -l | |
124 | option is the only option that may be passed to a remote machine. | |
125 | .SH "SEE ALSO" | |
126 | chpass(1), w(1), who(1), getpwent(3) |