usr/man/cat1/finger.0



FINGER(1)           UNIX Programmer's Manual            FINGER(1)


N\bNA\bAM\bME\bE
     finger - user information lookup program

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     f\bfi\bin\bng\bge\ber\br [ options ] name ...

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     By default _\bf_\bi_\bn_\bg_\be_\br lists the login name, full name, terminal
     name and write status (as a `*' before the terminal name if
     write permission is denied), idle time, login time, and
     office location and phone number (if they are known) for
     each current UNIX user.  (Idle time is minutes if it is a
     single integer, hours and minutes if a ':' is present, or
     days and hours if a 'd' is present.)

     A longer format also exists and is used by _\bf_\bi_\bn_\bg_\be_\br whenever a
     list of people's names is given.  (Account names as well as
     first and last names of users are accepted.) This format is
     multi-line, and includes all the information described above
     as well as the user's home directory and login shell, any
     plan which the person has placed in the file ._\bp_\bl_\ba_\bn in their
     home directory, and the project on which they are working
     from the file ._\bp_\br_\bo_\bj_\be_\bc_\bt also in the home directory.

     _\bF_\bi_\bn_\bg_\be_\br may be used to lookup users on a remote machine.  The
     format is to specify the user as ``user@host.''  If the user
     name is left off, the standard format listing is provided on
     the remote machine.

     _\bF_\bi_\bn_\bg_\be_\br options include:

     -\b-m\bm   Match arguments only on user name.

     -\b-l\bl   Force long output format.

     -\b-p\bp   Suppress printing of the ._\bp_\bl_\ba_\bn files

     -\b-s\bs   Force short output format.

F\bFI\bIL\bLE\bES\bS
     /etc/utmp           who file
     /etc/passwd         for users names, offices, ...
     /usr/adm/lastlog    last login times
     ~/.plan             plans
     ~/.project          projects

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     chfn(1), w(1), who(1)

A\bAU\bUT\bTH\bHO\bOR\bR
     Earl T. Cohen


Printed 7/9/88            May 10, 1986                          1


FINGER(1)           UNIX Programmer's Manual            FINGER(1)


B\bBU\bUG\bGS\bS
     Only the first line of the ._\bp_\br_\bo_\bj_\be_\bc_\bt file is printed.

     The encoding of the gcos field is UCB dependent - it knows
     that an office `197MC' is `197M Cory Hall', and that `529BE'
     is `529B Evans Hall'.  It also knows that a four digit
     office phone number should have a ``x2-'' prepended.

     There is no way to pass arguments to the remote machine as
     _\bf_\bi_\bn_\bg_\be_\br uses an internet standard port.

     A user information data base is in the works and will radi-
     cally alter the way the information that _\bf_\bi_\bn_\bg_\be_\br uses is
     stored.  Finger will require extensive modification when
     this is implemented.


Printed 7/9/88            May 10, 1986                          2