projects / unix-history / blame
| 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 | .\" | |
| efb2a383 | 5 | .\" @(#)finger.1 6.1 (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 | |
| 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 peoples 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 | options include: | |
| 41 | .TP | |
| 42 | .B \-m | |
| 43 | Match arguments only on user name. | |
| 44 | .TP | |
| 45 | .B \-l | |
| 46 | Force long output format. | |
| 47 | .TP | |
| 48 | .B \-p | |
| 49 | Suppress printing of the | |
| 50 | .I \&.plan | |
| 51 | files | |
| 52 | .TP | |
| 53 | .B \-s | |
| 54 | Force short output format. | |
| 55 | .SH FILES | |
| 56 | .ta 2i | |
| 57 | /etc/utmp who file | |
| 58 | .br | |
| 59 | /etc/passwd for users names, offices, ... | |
| 60 | .br | |
| 61 | /usr/adm/lastlog last login times | |
| 62 | .br | |
| 63 | ~/.plan plans | |
| 64 | .br | |
| 65 | ~/.project projects | |
| 66 | .SH "SEE ALSO" | |
| efb2a383 | 67 | chfn(1), w(1), who(1) |
| b2575e31 KM |
68 | .SH AUTHOR |
| 69 | Earl T. Cohen | |
| 70 | .SH BUGS | |
| 71 | Only the first line of the | |
| 72 | .I .project | |
| 73 | file is printed. | |
| 74 | .PP | |
| 75 | The encoding of the gcos field is UCB dependent \- it knows that an office | |
| 76 | `197MC' is `197M Cory Hall', and that `529BE' is `529B Evans Hall'. | |
| 77 | .PP | |
| 78 | A user information data base is in the works and will radically alter | |
| 79 | the way the information that | |
| 80 | .I finger | |
| 81 | uses is stored. Finger will require extensive modification when | |
| 82 | this is implemented. |