FINGER(1N)              COMMAND REFERENCE              FINGER(1N)



NAME
     finger, f - user information lookup program

SYNOPSIS
     finger [ -b ] [ -f ] [ -h ] [ -i ] [ -l ] [ -m ] [ -p ] [ -q
     ] [ -s ] [ -w ]
     [ username ... ]

DESCRIPTION
     By default finger 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 user currently logged in.  (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 finger whenever a
     list of peoples 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 as
     well as the user's home directory and login shell, any plan
     which the person has placed in the file .plan in their home
     directory, and the project on which they are working from
     the file .project, also in the home directory.

     A quick format also exists, which prints the username, login
     port, and login time.

     The finger command gets personal information about a user
     from the gecos command field in the entry for the user in
     the file /etc/passwd. This field is manipulated by the user
     via the chfn(1) command.  The format of this field is
     determined by the file /usr/lib/chfn;thisfilecontainsthe
     headings of the reports printed by finger. If there is no
     /usr/lib/chfn finger uses a set of default labels for the
     output headers.  These default labels are as follows:

          Name      This is the user's full name.

          Extension This is the user's office phone number.

          Mail Stop This is the user's company mail address.

          Home Phone
                    This is the user's home phone number.

          Machine   This is the user's primary activity machine.

     If /usr/lib/chfn exists, its contents are used instead of
     the default labels; it can be changed to suit the needs of
     the user. (See chfn(1) and chfn(5)).  Output from the finger



Printed 5/12/88                                                 1

FINGER(1N)              COMMAND REFERENCE              FINGER(1N)



     command changes accordingly.

OPTIONS
     -b Brief version of long format.  Suppress printing of login
        shell and home directory.

     -f Suppress printing of headers on listings.

     -h Suppress printing of the .project file.

     -i Print data in quick format with idle time.

     -l Force long output format.

     -m Match arguments only on user name.

     -p Suppress printing of the .plan file.

     -q Print data in quick format.

     -s Force short output format.

     -w Print data in narrow short format, which doesn't give the
        full name or titles for other gecos field elements.

FILES
     /etc/utmp    login data

     /etc/passwd  user account data file

     /usr/adm/lastlog
                  last login time

     $HOME/.plan  personal plan file

     $HOME/.project
                  personal project file

     /usr/lib/chfn
                  gecos format file

RETURN VALUE
     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.



Printed 5/12/88                                                 2

FINGER(1N)              COMMAND REFERENCE              FINGER(1N)



                    See intro(2) for more information on system
                    errors.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     Only the first line of the .project file is printed.

SEE ALSO
     chfn(1), w(1), who(1N), and chfn(5).











































Printed 5/12/88                                                 3

%%index%%
na:312,95;
sy:407,475;
de:882,2769;4035,35;
op:4070,888;
fi:4958,470;
rv:5428,504;6316,278;
ca:6594,151;
se:6745,195;
%%index%%000000000151