|
|
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)finger.1 6.4 (Berkeley) 5/10/86
6: .\"
7: .TH FINGER 1 "May 10, 1986"
8: .UC 4
9: .SH NAME
10: finger \- user information lookup program
11: .SH SYNOPSIS
12: .B finger
13: [
14: options
15: ] name ...
16: .SH DESCRIPTION
17: By default
18: .I finger
19: lists the login name, full name, terminal name and write status
20: (as a `*' before the terminal name if write permission is denied),
21: idle time, login time, and office location and phone number
22: (if they are known) for each current UNIX user.
23: (Idle time is minutes if it is a single integer, hours and minutes if a ':'
24: is present, or days and hours if a 'd' is present.)
25: .PP
26: A longer format also exists and is used by
27: .I finger
28: whenever a list of people's names is given. (Account names as well as
29: first and last names of users are accepted.)
30: This format is multi-line, and includes all the information described above
31: as well as the user's home
32: directory and login shell, any plan which the person has placed in the file
33: .I \&.plan
34: in their home
35: directory, and the project on which they are working from the file
36: .I \&.project
37: also in the home directory.
38: .PP
39: .I Finger
40: may be used to lookup users on a remote machine. The format is to specify
41: the user as ``user@host.'' If the user name is left off, the
42: standard format listing is provided on the remote machine.
43: .PP
44: .I Finger
45: options include:
46: .TP
47: .B \-m
48: Match arguments only on user name.
49: .TP
50: .B \-l
51: Force long output format.
52: .TP
53: .B \-p
54: Suppress printing of the
55: .I \&.plan
56: files
57: .TP
58: .B \-s
59: Force short output format.
60: .SH FILES
61: .ta 2i
62: /etc/utmp who file
63: .br
64: /etc/passwd for users names, offices, ...
65: .br
66: /usr/adm/lastlog last login times
67: .br
68: ~/.plan plans
69: .br
70: ~/.project projects
71: .SH "SEE ALSO"
72: chfn(1), w(1), who(1)
73: .SH AUTHOR
74: Earl T. Cohen
75: .SH BUGS
76: Only the first line of the
77: .I .project
78: file is printed.
79: .PP
80: The encoding of the gcos field is UCB dependent \- it knows that an office
81: `197MC' is `197M Cory Hall', and that `529BE' is `529B Evans Hall'.
82: It also knows that a four digit office phone number should have a ``x2-''
83: prepended.
84: .PP
85: There is no way to pass arguments to the remote machine as
86: .I finger
87: uses an internet standard port.
88: .PP
89: A user information data base is in the works and will radically alter
90: the way the information that
91: .I finger
92: uses is stored. Finger will require extensive modification when
93: this is implemented.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.