BSD 3 development
[unix-history] / usr / man / man1 / finger.1
CommitLineData
1b0f334f
EC
1.TH FINGER 1
2.UC
3.SH NAME
4finger \- user information lookup program
5.SH SYNOPSIS
6.B finger
7[
8options
9] name ...
10.SH DESCRIPTION
11By default
12.I finger
13lists the login name, full name, terminal name and write status
14(as a '*' before the terminal name if write permission is denied),
15idle time, login time, and office location and phone number
16(if they are known) for each current UNIX user.
17(Idle time is minutes if it is a single integer, hours and minutes if a ':'
18is present, or days and hours if a 'd' is present.)
19.PP
20A longer format also exists and is used by
21.I finger
22whenever a list of peoples names is given. (Account names as well as
23first and last names of users are accepted.)
24This format is multi-line, and includes all the information described above
25as well as the user's home
26directory and login shell, any plan which the person has placed in the file
27.I \&.plan
28in their home
29directory, and the project on which they are working from the file
30.I \&.project
31also in the home directory.
32.PP
33.I Finger
34options include:
35.TP
36.B \-f
37Suppress the printing of the header line (short format).
38.TP
39.B \-l
40Force long output format.
41.TP
42.B \-p
43Suppress printing of the
44.I \&.plan
45files
46.TP
47.B \-s
48Force short output format.
49.SH FILES
50.ta 2i
51/etc/utmp who file
52.br
53/etc/passwd for users names, offices, phones, directories and shells
54.br
55/usr/adm/lastlog last login times
56.br
57~/.plan plans
58.br
59~/.project projects
60.SH "SEE ALSO"
61w(1), who(1)
62.SH AUTHOR
63Earl T. Cohen
64.SH BUGS
65Only the first line of the
66.I .project
67file is printed.
68.PP
69The encoding of the gecos field is UCB dependent \- it knows that an office
70`197MC' is `197M Cory Hall', and tht `529BE' is `529B Evans Hall'.