Commit | Line | Data |
---|---|---|
b2575e31 KM |
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 | .\" | |
c85f63d3 | 5 | .\" @(#)finger.1 6.4 (Berkeley) %G% |
b2575e31 | 6 | .\" |
efb2a383 | 7 | .TH FINGER 1 "" |
b2575e31 KM |
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 | |
2f96ea34 | 20 | (as a `*' before the terminal name if write permission is denied), |
b2575e31 KM |
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 | |
c85f63d3 | 28 | whenever a list of people's names is given. (Account names as well as |
b2575e31 KM |
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 | |
2f96ea34 JB |
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 | |
b2575e31 KM |
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" | |
efb2a383 | 72 | chfn(1), w(1), who(1) |
b2575e31 KM |
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'. | |
6fbc41c7 JB |
82 | It also knows that a four digit office phone number should have a ``x2-'' |
83 | prepended. | |
b2575e31 | 84 | .PP |
2f96ea34 JB |
85 | There is no way to pass arguments to the remote machine as |
86 | .I finger | |
87 | uses an internet standard port. | |
88 | .PP | |
b2575e31 KM |
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. |