Return to finger.1 CVS log

Up to [local] / src / usr.bin / finger

Annotation of src/usr.bin/finger/finger.1, Revision 1.3

1.3     ! downsj      1: .\"    $OpenBSD: finger.1,v 1.2 1996/06/26 05:33:15 deraadt Exp $
        !             2: .\"
1.1       deraadt     3: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
                      4: .\" All rights reserved.
                      5: .\"
                      6: .\" Redistribution and use in source and binary forms, with or without
                      7: .\" modification, are permitted provided that the following conditions
                      8: .\" are met:
                      9: .\" 1. Redistributions of source code must retain the above copyright
                     10: .\"    notice, this list of conditions and the following disclaimer.
                     11: .\" 2. Redistributions in binary form must reproduce the above copyright
                     12: .\"    notice, this list of conditions and the following disclaimer in the
                     13: .\"    documentation and/or other materials provided with the distribution.
                     14: .\" 3. All advertising materials mentioning features or use of this software
                     15: .\"    must display the following acknowledgement:
                     16: .\"    This product includes software developed by the University of
                     17: .\"    California, Berkeley and its contributors.
                     18: .\" 4. Neither the name of the University nor the names of its contributors
                     19: .\"    may be used to endorse or promote products derived from this software
                     20: .\"    without specific prior written permission.
                     21: .\"
                     22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     25: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     32: .\" SUCH DAMAGE.
                     33: .\"
                     34: .\"    from: @(#)finger.1      6.14 (Berkeley) 7/27/91
                     35: .\"
                     36: .Dd July 27, 1991
                     37: .Dt FINGER 1
                     38: .Os BSD 4
                     39: .Sh NAME
                     40: .Nm finger
                     41: .Nd user information lookup program
                     42: .Sh SYNOPSIS
                     43: .Nm finger
1.3     ! downsj     44: .Op Fl lmMsp
1.1       deraadt    45: .Op Ar user ...
                     46: .Op Ar user@host ...
                     47: .Sh DESCRIPTION
                     48: The
                     49: .Nm finger
                     50: displays information about the system users.
                     51: .Pp
                     52: Options are:
                     53: .Bl -tag -width flag
                     54: .It Fl s
                     55: .Nm Finger
                     56: displays the user's login name, real name, terminal name and write
                     57: status (as a ``*'' before the terminal name if write permission is
                     58: denied), idle time, login time, office location and office phone
                     59: number.
                     60: .Pp
                     61: Idle time is in minutes if it is a single integer, hours and minutes
                     62: if a ``:'' is present, or days if a ``d'' is present.
                     63: Login time is displayed as month, day, hours and minutes, unless
                     64: more than six months ago, in which case the year is displayed rather
                     65: than the hours and minutes.
                     66: .Pp
                     67: Unknown devices as well as nonexistent idle and login times are
                     68: displayed as single asterisks.
                     69: .Pp
                     70: .It Fl l
                     71: Produces a multi-line format displaying all of the information
                     72: described for the
                     73: .Fl s
                     74: option as well as the user's home directory, home phone number, login
                     75: shell, mail status, and the contents of the files
                     76: .Dq Pa .plan
                     77: and
                     78: .Dq Pa .project
                     79: from the user's home directory.
                     80: .Pp
                     81: If idle time is at least a minute and less than a day, it is
                     82: presented in the form ``hh:mm''.
                     83: Idle times greater than a day are presented as ``d day[s]hh:mm''.
                     84: .Pp
                     85: Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
                     86: Numbers specified as ten or seven digits are printed as the appropriate
                     87: subset of that string.
                     88: Numbers specified as five digits are printed as ``xN-NNNN''.
                     89: Numbers specified as four digits are printed as ``xNNNN''.
                     90: .Pp
                     91: If write permission is denied to the device, the phrase ``(messages off)''
                     92: is appended to the line containing the device name.
                     93: One entry per user is displayed with the
                     94: .Fl l
                     95: option; if a user is logged on multiple times, terminal information
                     96: is repeated once per login.
                     97: .Pp
                     98: Mail status is shown as ``No Mail.'' if there is no mail at all,
                     99: ``Mail last read DDD MMM ## HH:MM YYYY (TZ)'' if the person has looked
                    100: at their mailbox since new mail arriving, or ``New mail received ...'',
                    101: ``  Unread since ...'' if they have new mail.
                    102: .Pp
                    103: .It Fl p
                    104: Prevents
                    105: the
                    106: .Fl l
                    107: option of
                    108: .Nm finger
                    109: from displaying the contents of the
                    110: .Dq Pa .plan
                    111: and
                    112: .Dq Pa .project
                    113: files.
                    114: .It Fl m
                    115: Prevent matching of
                    116: .Ar user
                    117: names.
                    118: .Ar User
                    119: is usually a login name; however, matching will also be done on the
                    120: users' real names, unless the
                    121: .Fl m
                    122: option is supplied.
                    123: All name matching performed by
                    124: .Nm finger
                    125: is case insensitive.
1.3     ! downsj    126: .It Fl M
        !           127: Enable matching of
        !           128: .Ar user
        !           129: names.  This is disabled by default on systems running YP.
1.1       deraadt   130: .El
                    131: .Pp
                    132: If no options are specified,
                    133: .Nm finger
                    134: defaults to the
                    135: .Fl l
                    136: style output if operands are provided, otherwise to the
                    137: .Fl s
                    138: style.
                    139: Note that some fields may be missing, in either format, if information
                    140: is not available for them.
                    141: .Pp
                    142: If no arguments are specified,
                    143: .Nm finger
                    144: will print an entry for each user currently logged into the system.
                    145: .Pp
                    146: .Nm Finger
                    147: may be used to look up users on a remote machine.
                    148: The format is to specify a
                    149: .Ar user
                    150: as
                    151: .Dq Li user@host ,
                    152: or
                    153: .Dq Li @host ,
                    154: where the default output
                    155: format for the former is the
                    156: .Fl l
                    157: style, and the default output format for the latter is the
                    158: .Fl s
                    159: style.
                    160: The
                    161: .Fl l
                    162: option is the only option that may be passed to a remote machine.
                    163: .Sh SEE ALSO
                    164: .Xr chpass 1 ,
                    165: .Xr w 1 ,
                    166: .Xr who 1
                    167: .Sh HISTORY
                    168: The
                    169: .Nm finger
                    170: command appeared in
                    171: .Bx 3.0 .