1.\" Copyright (c) 1989, 1990, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.roff% 5.\" 6.\" @(#)finger.1 8.3 (Berkeley) 05/05/94 7.\" 8.Dd 9.Dt FINGER 1 10.Os BSD 4 11.Sh NAME 12.Nm finger 13.Nd user information lookup program 14.Sh SYNOPSIS 15.Nm finger 16.Op Fl lmsp 17.Op Ar user ... 18.Op Ar user@host ... 19.Sh DESCRIPTION 20The 21.Nm finger 22displays information about the system users. 23.Pp 24Options are: 25.Bl -tag -width flag 26.It Fl s 27.Nm Finger 28displays the user's login name, real name, terminal name and write 29status (as a ``*'' before the terminal name if write permission is 30denied), idle time, login time, office location and office phone 31number. 32.Pp 33Idle time is in minutes if it is a single integer, hours and minutes 34if a ``:'' is present, or days if a ``d'' is present. 35Login time is displayed as month, day, hours and minutes, unless 36more than six months ago, in which case the year is displayed rather 37than the hours and minutes. 38.Pp 39Unknown devices as well as nonexistent idle and login times are 40displayed as single asterisks. 41.Pp 42.It Fl l 43Produces a multi-line format displaying all of the information 44described for the 45.Fl s 46option as well as the user's home directory, home phone number, login 47shell, and the contents of the files 48.Dq Pa .forward , 49.Dq Pa .plan 50and 51.Dq Pa .project 52from the user's home directory. 53.Pp 54If idle time is at least a minute and less than a day, it is 55presented in the form ``hh:mm''. 56Idle times greater than a day are presented as ``d day[s]hh:mm''. 57.Pp 58Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''. 59Numbers specified as ten or seven digits are printed as the appropriate 60subset of that string. 61Numbers specified as five digits are printed as ``xN-NNNN''. 62.Pp 63If write permission is denied to the device, the phrase ``(messages off)'' 64is appended to the line containing the device name. 65One entry per user is displayed with the 66.Fl l 67option; if a user is logged on multiple times, terminal information 68is repeated once per login. 69.Pp 70.It Fl p 71Prevents 72the 73.Fl l 74option of 75.Nm finger 76from displaying the contents of the 77.Dq Pa .forward , 78.Dq Pa .plan 79and 80.Dq Pa .project 81files. 82.It Fl m 83Prevent matching of 84.Ar user 85names. 86.Ar User 87is usually a login name; however, matching will also be done on the 88users' real names, unless the 89.Fl m 90option is supplied. 91All name matching performed by 92.Nm finger 93is case insensitive. 94.El 95.Pp 96If no options are specified, 97.Nm finger 98defaults to the 99.Fl l 100style output if operands are provided, otherwise to the 101.Fl s 102style. 103Note that some fields may be missing, in either format, if information 104is not available for them. 105.Pp 106If no arguments are specified, 107.Nm finger 108will print an entry for each user currently logged into the system. 109.Pp 110.Nm Finger 111may be used to look up users on a remote machine. 112The format is to specify a 113.Ar user 114as 115.Dq Li user@host , 116or 117.Dq Li @host , 118where the default output 119format for the former is the 120.Fl l 121style, and the default output format for the latter is the 122.Fl s 123style. 124The 125.Fl l 126option is the only option that may be passed to a remote machine. 127.Sh FILES 128.Bl -tag -width /var/log/lastlog -compact 129.It Pa /var/log/lastlog 130last login data base 131.El 132.Sh SEE ALSO 133.Xr chpass 1 , 134.Xr w 1 , 135.Xr who 1 , 136.Sh HISTORY 137The 138.Nm finger 139command appeared in 140.Bx 3.0 . 141