finger(1)                                               finger(1)



NAME
     finger - displays information about the users on a system

SYNOPSIS
     finger [f] [w] [login-or-real-name]...

     finger -i [f] [w] [login-name]...

     finger -q [f] [w] [login-name]...

     finger -l [b] [h] [m] [p] [login-or-real-name]...

     finger [-l] login-or-real-name@host
     [login-or-real-name@host]...

     finger [-s] @host [@host]...

ARGUMENTS
     @host
          Specifies the name of a remote host. The value of host
          can be a host name or an Internet address, as specified
          in the /etc/hosts file.  If you specify just a remote
          host, finger ignores any options that you may have
          specified and displays the unmodified default format
          for each user on the remote host.  If you precede host
          with a login or a real name, finger ignores any options
          that you may have specified and displays the unmodified
          long format for that user.

     -b   Suppresses the display of the Directory and Shell
          fields when the long format is used.

     -f   Suppresses the display of column headings.

     -h   Suppresses the display of the first line of the
          .project file.

     -i   Causes finger to show the Login, TTY, When, and Idle
          columns for only those users who have idle time.  If
          you specify login-name, it is the login name of a user,
          as stored in the first field of /etc/passwd, because
          finger searches only that field for a match.

     -l   Causes finger to use the long format. You should use
          this option only in conjunction with options that
          modify the long format.

     login-name
          Specifies the name of the user for which you want
          information.

     login-or-real-name



January 1992                                                    1

finger(1)                                               finger(1)



          Specifies the login name or any of the real names
          stored in the fifth field of the user's entry in
          /etc/passwd.  For example, if Christine Louise Witt's
          login name is chris, and Tina Louise Witt is in the
          fifth field of her entry in /etc/passwd, finger can
          display information about her if you use any of the
          following names as a value of the login-or-real-name
          argument:  chris, Tina, Louise, or Witt.  Note that if
          you specify Christine as the value of the
          login-or-real-name argument in this case, finger cannot
          find a match and displays this message:

             Login name: christine        In real life: ???

     -m   Limits the search for a match to the login name, as
          stored in the first field of /etc/passwd.

     -p   Suppresses the display of any .plan files when the long
          format is used.

     -q   Causes finger to display only the Login, TTY, and When
          columns.  If you specify login-name, it is the login
          name of a user, as stored in the first field of
          /etc/passwd, because finger searches only that field
          for a match.

     -s   Causes finger to use the default format. You should use
          this option only in conjunction with options that
          modify the default format.

     -w   Suppresses display of the Name column.

DESCRIPTION
     The finger command displays information about the users who
     are currently logged in to the system.  On A/UX systems,
     finger displays a line of information for each user logged
     in to the system and for each CommandShell window.

     The finger command displays information about the users on a
     system in either of two formats:  the default format and the
     long format.  The default format is displayed when you do
     not specify any options or arguments; when you specify the
     -i, -q, or -s option; or when you specify the name of a
     remote system.  The long format is displayed when you
     specify the -l option or when you specify the name of a user
     on the local system or on a remote system.

Default Format
     The default format produces fields of data that have these
     headings:  Login, Name, TTY, Idle, When, and Office.  The
     Login column is the user's login name as stored in the first
     field of the /etc/passwd file. The Name column is the real



2                                                    January 1992

finger(1)                                               finger(1)



     name of the user as stored in the fifth field of the
     /etc/passwd file. The TTY column is the user's current
     terminal name. The Idle column is the amount of time since
     the user last pressed a key on the keyboard.  When the value
     in the TTY column is co, the value in the When column
     represents the time the user logged in to the system.  For
     the lines that correspond to a CommandShell window, the
     value in the When column represents the time the user
     created the window.  The Office column reflects extra
     information, if any, taken from the fifth field of the
     user's entry in /etc/passwd.  See ``Enhancing finger
     Output'' later in the ``Description'' section for details.

     Status of permission to write to the user's terminal is
     indicated by the presence (denied) or absence (enabled) of
     an asterisk (*) before the terminal name.  If idle time is a
     single integer, it represents minutes. If idle time is two
     integers separated by a colon (:), they represent hours and
     minutes.  If idle time is an integer to which a d is
     appended, it represents days.

     The -f, -i, -l, -q, and -w options modify the default
     format.

Long Format
     When you use the long format, finger displays the same
     information as would be displayed in the default format, as
     well as the user's home directory and shell, the contents of
     the user's .plan file, if any, and the first line of the
     user's .project file, if any.

     The long format displays this information in the following
     format:

        Login name: login-nameIn real life: real-names
        Mailstop: mail-stopHome phone: phone-number
        Directory: directoryShell: shell
        On since date-and-time on ttytime Idle Time
        Project: project-information
        Plan: plan-information

     The -b, -h, @host, -m, login-or-real-name, -p, and -s
     options modify the long format.

Enhancing finger Output
     You can use the chfn command to store extra information in
     the fifth field of your entry in /etc/passwd.  The extra
     information consists of your office number or mail stop,
     office phone number, and home phone number. If this
     information is available, finger displays the office number
     or mail stop and office phone number when the default format
     is used and displays the office number or mail stop, office



January 1992                                                    3

finger(1)                                               finger(1)



     phone number, and home phone number when the long format is
     used.

FILES
     /usr/ucb/finger
          Executable file
     /etc/passwd
          File that is examined for login names, real names, and
          other information
     /etc/utmp
          File that finger uses to determine who is currently
          logged in
     /usr/adm/lastlog
          File that contains the last login time of each user
     ~/.plan
          File containing the user's plan
     ~/.project
          File describing the projects the user is working on

SEE ALSO
     chfn(1), w(1), who(1), whoami(1)

     hosts(4), passwd(4) in A/UX Programmer's Reference

     in.fingerd(1M) in A/UX System Administrator's Reference






























4                                                    January 1992