Return to finger.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / finger

Annotation of 43BSDReno/usr.bin/finger/finger.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"     @(#)finger.1   6.11 (Berkeley) 7/24/90
        !            19: .\"
        !            20: .Dd July 24, 1990
        !            21: .Dt FINGER 1
        !            22: .Os BSD 4
        !            23: .Sh NAME
        !            24: .Nm finger
        !            25: .Nd user information lookup program
        !            26: .Sh SYNOPSIS
        !            27: .Nm finger
        !            28: .Op Fl lmsp
        !            29: .Ob
        !            30: .Ar user
        !            31: .Op \&@host
        !            32: \&...
        !            33: .Oe
        !            34: .Sh DESCRIPTION
        !            35: The
        !            36: .Nm finger
        !            37: command has two basic output formats providing essentially the same
        !            38: information.
        !            39: .Pp
        !            40: Options are:
        !            41: .Tw Ds
        !            42: .Tp Fl s
        !            43: .Nm Finger
        !            44: displays the user's login name, real name, terminal name and write
        !            45: status (as a ``*'' after the terminal name if write permission is
        !            46: denied), idle time, login time, office location and office phone
        !            47: number.
        !            48: .Pp
        !            49: Idle time is in minutes if it is a single integer, hours and minutes
        !            50: if a ``:'' is present, or days if a ``d'' is present.
        !            51: Login time is displayed as month, day, hours and minutes, unless
        !            52: more than six months ago, in which case the year is displayed rather
        !            53: than the hours and minutes.
        !            54: .Pp
        !            55: Unknown devices as well as nonexistent idle and login times are
        !            56: displayed as single asterisks.
        !            57: .Pp
        !            58: .Tp Fl l
        !            59: Produces a multi-line format displaying all of the information
        !            60: described for the
        !            61: .Fl s
        !            62: option as well as the user's home directory, home phone number, login
        !            63: shell, and the contents of the files
        !            64: .Dq Pa .plan
        !            65: and
        !            66: .Dq Pa .project
        !            67: from the user's home directory.
        !            68: .Pp
        !            69: If idle time is at least a minute and less than a day, it is
        !            70: presented in the form ``hh:mm''.
        !            71: Idle times greater than a day are presented as ``d day[s]hh:mm''.
        !            72: .Pp
        !            73: Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
        !            74: Numbers specified as ten or seven digits are printed as the appropriate
        !            75: subset of that string.
        !            76: Numbers specified as five digits are printed as ``xN-NNNN''.
        !            77: .Pp
        !            78: If write permission is denied to the device, the phrase ``(messages off)''
        !            79: is appended to the line containing the device name.
        !            80: One entry per user is displayed with the
        !            81: .Fl l
        !            82: option; if a user is logged on multiple times, terminal information
        !            83: is repeated once per login.
        !            84: .Pp
        !            85: .Tp Fl p
        !            86: Prevents
        !            87: the
        !            88: .Fl l
        !            89: option of
        !            90: .Nm finger
        !            91: from displaying the contents of the
        !            92: .Dq Pa .plan
        !            93: and
        !            94: .Dq Pa .project
        !            95: files.
        !            96: .Pp
        !            97: Note that some fields may be missing, in either format, if information
        !            98: is not available for them.
        !            99: .Tp Fl m
        !           100: Prevent matching of
        !           101: .Ar user
        !           102: names.
        !           103: .Ar User
        !           104: is usually a login name; however, matching will also be done on the
        !           105: users' real names, unless the
        !           106: .Fl m
        !           107: option is supplied.
        !           108: All name matching performed by
        !           109: .Nm finger
        !           110: is case insensitive.
        !           111: .Tp
        !           112: .Pp
        !           113: If no options are specified,
        !           114: .Nm finger
        !           115: defaults to the
        !           116: .Fl l
        !           117: style output if operands are provided, otherwise to the
        !           118: .Fl s
        !           119: style.
        !           120: .Pp
        !           121: If no arguments are specified,
        !           122: .Nm finger
        !           123: will print an entry for each user currently logged into the system.
        !           124: .Pp
        !           125: .Nm Finger
        !           126: may be used to look up users on a remote machine.
        !           127: The format is to specify a
        !           128: .Ar user
        !           129: as
        !           130: .Dq Li user@host ,
        !           131: or
        !           132: .Dq Li @host ,
        !           133: where the default output
        !           134: format for the former is the
        !           135: .Fl l
        !           136: style, and the default output format for the latter is the
        !           137: .Fl s
        !           138: style.
        !           139: The
        !           140: .Fl l
        !           141: option is the only option that may be passed to a remote machine.
        !           142: .Sh SEE ALSO
        !           143: .Xr chpass 1 ,
        !           144: .Xr w 1 ,
        !           145: .Xr who 1 ,
        !           146: .Xr getpwent 3
        !           147: .Sh HISTORY
        !           148: .Nm Finger
        !           149: appeared in 3 BSD.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.