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