[unix-history] / usr / src / usr.bin / finger / finger.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)finger.1	6.3 (Berkeley) %G%
.\"
.TH FINGER 1 ""
.UC 4
.SH NAME
finger \- user information lookup program
.SH SYNOPSIS
.B finger
[
options
] name ...
.SH DESCRIPTION
By default
.I finger
lists the login name, full name, terminal name and write status
(as a `*' before the terminal name if write permission is denied),
idle time, login time, and office location and phone number
(if they are known) for each current UNIX user.
(Idle time is minutes if it is a single integer, hours and minutes if a ':'
is present, or days and hours if a 'd' is present.)
.PP
A longer format also exists and is used by
.I finger
whenever a list of peoples names is given.  (Account names as well as
first and last names of users are accepted.)
This format is multi-line, and includes all the information described above
as well as the user's home
directory and login shell, any plan which the person has placed in the file
.I \&.plan
in their home
directory, and the project on which they are working from the file
.I \&.project
also in the home directory.
.PP
.I Finger
may be used to lookup users on a remote machine.  The format is to specify
the user as ``user@host.''  If the user name is left off, the
standard format listing is provided on the remote machine.
.PP
.I Finger
options include:
.TP
.B \-m
Match arguments only on user name.
.TP
.B \-l
Force long output format.
.TP
.B \-p
Suppress printing of the
.I \&.plan
files
.TP
.B \-s
Force short output format.
.SH FILES
.ta 2i
/etc/utmp	who file
.br
/etc/passwd	for users names, offices, ...
.br
/usr/adm/lastlog	last login times
.br
~/.plan	plans
.br
~/.project	projects
.SH "SEE ALSO"
chfn(1), w(1), who(1)
.SH AUTHOR
Earl T. Cohen
.SH BUGS
Only the first line of the
.I .project
file is printed.
.PP
The encoding of the gcos field is UCB dependent \- it knows that an office
`197MC' is `197M Cory Hall', and that `529BE' is `529B Evans Hall'.
It also knows that a four digit office phone number should have a ``x2-''
prepended.
.PP
There is no way to pass arguments to the remote machine as
.I finger
uses an internet standard port.
.PP
A user information data base is in the works and will radically alter
the way the information that
.I finger
uses is stored.  Finger will require extensive modification when
this is implemented.
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	.\"
2f96ea34	5	.\" @(#)finger.1 6.3 (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
	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
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-''
6fbc41c7 JB	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.