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 | .\" |
3dc87a1e | 16 | .\" @(#)finger.1 6.8 (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 | |
6b8910b8 KB |
74 | The |
75 | .I -p | |
76 | option prevents | |
77 | the | |
78 | .I -l | |
79 | option of | |
80 | .I finger | |
81 | from displaying the contents of the ``.plan'' and ``.project'' | |
82 | files. | |
83 | .PP | |
84 | Note that some fields may be missing, in either format, if information | |
85 | is not available for them. | |
b2575e31 | 86 | .PP |
6b8910b8 KB |
87 | If no operands are specified, |
88 | .I finger | |
89 | will print an entry for each user currently logged into the system. | |
90 | If no options are specified, | |
2f96ea34 | 91 | .I finger |
6b8910b8 KB |
92 | defaults to the |
93 | .I -l | |
94 | style output if operands are provided, otherwise to the | |
95 | .I -s | |
96 | style. | |
2f96ea34 | 97 | .PP |
6b8910b8 KB |
98 | .I User |
99 | is usually a login name; however, matching will also be done on the | |
100 | users' real names, unless the | |
101 | .I -m | |
102 | option is supplied. | |
103 | All name matching performed by | |
b2575e31 | 104 | .I finger |
6b8910b8 KB |
105 | is case insensitive. |
106 | .PP | |
107 | .I Finger | |
108 | may be used to look up users on a remote machine. | |
109 | The format is to specify a | |
110 | .I user | |
111 | as ``user@host'', or ``@host'', where the default output | |
112 | format for the former is the | |
113 | .I -l | |
114 | style, and the default output format for the latter is the | |
115 | .IR -s | |
116 | style. | |
117 | The | |
118 | .I -l | |
119 | option is the only option that may be passed to a remote machine. | |
120 | .SH "SEE ALSO" | |
121 | chpass(1), w(1), who(1), getpwent(3) |