162 lines
4.8 KiB
Groff
162 lines
4.8 KiB
Groff
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)finger.1 6.14 (Berkeley) 7/27/91
|
|
.\"
|
|
.Dd July 27, 1991
|
|
.Dt FINGER 1
|
|
.Os BSD 4
|
|
.Sh NAME
|
|
.Nm finger
|
|
.Nd user information lookup program
|
|
.Sh SYNOPSIS
|
|
.Nm finger
|
|
.Op Fl lmsp
|
|
.Op Ar user ...
|
|
.Op Ar user@host ...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm finger
|
|
displays information about the system users.
|
|
.Pp
|
|
Options are:
|
|
.Bl -tag -width flag
|
|
.It Fl s
|
|
.Nm Finger
|
|
displays the user's login name, real name, terminal name and write
|
|
status (as a ``*'' after the terminal name if write permission is
|
|
denied), idle time, login time, office location and office phone
|
|
number.
|
|
.Pp
|
|
Idle time is in minutes if it is a single integer, hours and minutes
|
|
if a ``:'' is present, or days if a ``d'' is present.
|
|
Login time is displayed as month, day, hours and minutes, unless
|
|
more than six months ago, in which case the year is displayed rather
|
|
than the hours and minutes.
|
|
.Pp
|
|
Unknown devices as well as nonexistent idle and login times are
|
|
displayed as single asterisks.
|
|
.Pp
|
|
.It Fl l
|
|
Produces a multi-line format displaying all of the information
|
|
described for the
|
|
.Fl s
|
|
option as well as the user's home directory, home phone number, login
|
|
shell, and the contents of the files
|
|
.Dq Pa .forward ,
|
|
.Dq Pa .plan
|
|
and
|
|
.Dq Pa .project
|
|
from the user's home directory.
|
|
.Pp
|
|
If idle time is at least a minute and less than a day, it is
|
|
presented in the form ``hh:mm''.
|
|
Idle times greater than a day are presented as ``d day[s]hh:mm''.
|
|
.Pp
|
|
Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
|
|
Numbers specified as ten or seven digits are printed as the appropriate
|
|
subset of that string.
|
|
Numbers specified as five digits are printed as ``xN-NNNN''.
|
|
.Pp
|
|
If write permission is denied to the device, the phrase ``(messages off)''
|
|
is appended to the line containing the device name.
|
|
One entry per user is displayed with the
|
|
.Fl l
|
|
option; if a user is logged on multiple times, terminal information
|
|
is repeated once per login.
|
|
.Pp
|
|
.It Fl p
|
|
Prevents
|
|
the
|
|
.Fl l
|
|
option of
|
|
.Nm finger
|
|
from displaying the contents of the
|
|
.Dq Pa .forward ,
|
|
.Dq Pa .plan
|
|
and
|
|
.Dq Pa .project
|
|
files.
|
|
.It Fl m
|
|
Prevent matching of
|
|
.Ar user
|
|
names.
|
|
.Ar User
|
|
is usually a login name; however, matching will also be done on the
|
|
users' real names, unless the
|
|
.Fl m
|
|
option is supplied.
|
|
All name matching performed by
|
|
.Nm finger
|
|
is case insensitive.
|
|
.El
|
|
.Pp
|
|
If no options are specified,
|
|
.Nm finger
|
|
defaults to the
|
|
.Fl l
|
|
style output if operands are provided, otherwise to the
|
|
.Fl s
|
|
style.
|
|
Note that some fields may be missing, in either format, if information
|
|
is not available for them.
|
|
.Pp
|
|
If no arguments are specified,
|
|
.Nm finger
|
|
will print an entry for each user currently logged into the system.
|
|
.Pp
|
|
.Nm Finger
|
|
may be used to look up users on a remote machine.
|
|
The format is to specify a
|
|
.Ar user
|
|
as
|
|
.Dq Li user@host ,
|
|
or
|
|
.Dq Li @host ,
|
|
where the default output
|
|
format for the former is the
|
|
.Fl l
|
|
style, and the default output format for the latter is the
|
|
.Fl s
|
|
style.
|
|
The
|
|
.Fl l
|
|
option is the only option that may be passed to a remote machine.
|
|
.Sh SEE ALSO
|
|
.Xr chpass 1 ,
|
|
.Xr w 1 ,
|
|
.Xr who 1 ,
|
|
.Sh HISTORY
|
|
The
|
|
.Nm finger
|
|
command appeared in
|
|
.Bx 3.0 .
|