1*67088Sbostic.\" Copyright (c) 1989, 1990, 1993, 1994 261995Sbostic.\" The Regents of the University of California. All rights reserved. 319135Smckusick.\" 450601Scael.\" %sccs.include.redist.roff% 519135Smckusick.\" 6*67088Sbostic.\" @(#)finger.1 8.3 (Berkeley) 05/05/94 735627Sbostic.\" 843693Scael.Dd 943693Scael.Dt FINGER 1 1043693Scael.Os BSD 4 1143693Scael.Sh NAME 1243693Scael.Nm finger 1343693Scael.Nd user information lookup program 1443693Scael.Sh SYNOPSIS 1543693Scael.Nm finger 1643693Scael.Op Fl lmsp 1750612Sbostic.Op Ar user ... 1850612Sbostic.Op Ar user@host ... 1943693Scael.Sh DESCRIPTION 2037659SbosticThe 2143693Scael.Nm finger 2250612Sbosticdisplays information about the system users. 2343693Scael.Pp 2443693ScaelOptions are: 2550601Scael.Bl -tag -width flag 2650601Scael.It Fl s 2743693Scael.Nm Finger 2837659Sbosticdisplays the user's login name, real name, terminal name and write 2966105Sbosticstatus (as a ``*'' before the terminal name if write permission is 3037659Sbosticdenied), idle time, login time, office location and office phone 3137659Sbosticnumber. 3243693Scael.Pp 3337659SbosticIdle time is in minutes if it is a single integer, hours and minutes 3437659Sbosticif a ``:'' is present, or days if a ``d'' is present. 3537659SbosticLogin time is displayed as month, day, hours and minutes, unless 3637659Sbosticmore than six months ago, in which case the year is displayed rather 3737659Sbosticthan the hours and minutes. 3843693Scael.Pp 3937668SbosticUnknown devices as well as nonexistent idle and login times are 4037668Sbosticdisplayed as single asterisks. 4143693Scael.Pp 4250601Scael.It Fl l 4343693ScaelProduces a multi-line format displaying all of the information 4437659Sbosticdescribed for the 4543693Scael.Fl s 4638052Sbosticoption as well as the user's home directory, home phone number, login 4738052Sbosticshell, and the contents of the files 4850612Sbostic.Dq Pa .forward , 4943693Scael.Dq Pa .plan 5037659Sbosticand 5143693Scael.Dq Pa .project 5237659Sbosticfrom the user's home directory. 5343693Scael.Pp 5437659SbosticIf idle time is at least a minute and less than a day, it is 5537659Sbosticpresented in the form ``hh:mm''. 5643693ScaelIdle times greater than a day are presented as ``d day[s]hh:mm''. 5743693Scael.Pp 5838052SbosticPhone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''. 5938052SbosticNumbers specified as ten or seven digits are printed as the appropriate 6038052Sbosticsubset of that string. 6138052SbosticNumbers specified as five digits are printed as ``xN-NNNN''. 6243693Scael.Pp 6338052SbosticIf write permission is denied to the device, the phrase ``(messages off)'' 6438052Sbosticis appended to the line containing the device name. 6537659SbosticOne entry per user is displayed with the 6643693Scael.Fl l 6737659Sbosticoption; if a user is logged on multiple times, terminal information 6837659Sbosticis repeated once per login. 6943693Scael.Pp 7050601Scael.It Fl p 7143693ScaelPrevents 7237659Sbosticthe 7343693Scael.Fl l 7437659Sbosticoption of 7543693Scael.Nm finger 7643693Scaelfrom displaying the contents of the 7750612Sbostic.Dq Pa .forward , 7843693Scael.Dq Pa .plan 7943693Scaeland 8043693Scael.Dq Pa .project 8137659Sbosticfiles. 8250601Scael.It Fl m 8343693ScaelPrevent matching of 8443693Scael.Ar user 8543693Scaelnames. 8643693Scael.Ar User 8737659Sbosticis usually a login name; however, matching will also be done on the 8837659Sbosticusers' real names, unless the 8943693Scael.Fl m 9037659Sbosticoption is supplied. 9137659SbosticAll name matching performed by 9243693Scael.Nm finger 9337659Sbosticis case insensitive. 9450601Scael.El 9543693Scael.Pp 9643693ScaelIf no options are specified, 9743693Scael.Nm finger 9843693Scaeldefaults to the 9943693Scael.Fl l 10043693Scaelstyle output if operands are provided, otherwise to the 10143693Scael.Fl s 10243693Scaelstyle. 10350612SbosticNote that some fields may be missing, in either format, if information 10450612Sbosticis not available for them. 10543693Scael.Pp 10643693ScaelIf no arguments are specified, 10743693Scael.Nm finger 10843693Scaelwill print an entry for each user currently logged into the system. 10943693Scael.Pp 11043693Scael.Nm Finger 11137659Sbosticmay be used to look up users on a remote machine. 11237659SbosticThe format is to specify a 11343693Scael.Ar user 11443693Scaelas 11543693Scael.Dq Li user@host , 11643693Scaelor 11743693Scael.Dq Li @host , 11843693Scaelwhere the default output 11937659Sbosticformat for the former is the 12043693Scael.Fl l 12137659Sbosticstyle, and the default output format for the latter is the 12243693Scael.Fl s 12337659Sbosticstyle. 12437659SbosticThe 12543693Scael.Fl l 12637659Sbosticoption is the only option that may be passed to a remote machine. 127*67088Sbostic.Sh FILES 128*67088Sbostic.Bl -tag -width /var/log/lastlog -compact 129*67088Sbostic.It Pa /var/log/lastlog 130*67088Sbosticlast login data base 131*67088Sbostic.El 13243693Scael.Sh SEE ALSO 13343693Scael.Xr chpass 1 , 13443693Scael.Xr w 1 , 13543693Scael.Xr who 1 , 13643693Scael.Sh HISTORY 13750601ScaelThe 13850601Scael.Nm finger 13950601Scaelcommand appeared in 14050601Scael.Bx 3.0 . 141