finger(1)                      DG/UX R4.11MU05                     finger(1)


NAME
       finger - display information about local and remote users

SYNOPSIS
       finger [ -bfhilmpqsw ] username...

       finger [-l] username@hostname ...  (TCP/IP)

DESCRIPTION
       By default, the finger command displays information about each
       logged-in user, including login name, full name, terminal name
       (prepended with a `*' if write-permission is denied), idle time,
       login time, and location if known.

       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.

       When one or more username arguments are given, more detailed
       information is given for each username specified, whether they are
       logged in or not.  username must be that of a local user, and may be
       a first or last name, or an account name.  When finger is used to
       find users on a remote device, the user and the name of the remote
       device are specified in the form username@hostname.  Information is
       presented in a multi-line format, and includes, in addition to the
       information mentioned above:

              the user's home directory and login shell

              time the user logged in if currently logged in, or the time
              the user last logged in if not (see the item in the NOTES
              section below), as well as the terminal or host from which the
              user logged in and, if a terminal.

              last time the user received mail, and the last time the user
              read their mail

              any plan contained in the file .plan in the user's home
              directory

              and any project on which the user is working described in the
              file .project (also in the user's home directory)

   Options
       -b     Suppress printing the user's home directory and shell in a
              long format printout.

       -f     Suppress printing the header that is normally printed in a
              non-long format printout.

       -h     Suppress printing of the .project file in a long format
              printout.

       -i     Force ``idle'' output format, which is similar to short format
              except that only the login name, terminal, login time, and
              idle time are printed.

       -l     Force long output format.

       -m     Match arguments only on user name (not first or last name).

       -p     Suppress printing of the .plan file in a long format printout.

       -q     Force quick output format, which is similar to short format
              except that only the login name, terminal, and login time are
              printed.

       -s     Force short output format.

       -w     Suppress printing the full name in a short format printout.

       Within the TCP/IP network, the -l option can be used remotely.

FILES
       /etc/utmp           who is logged in
       /etc/passwd         for users' names
       ~/.plan             plans
       ~/.project          projects

SEE ALSO
       passwd(1), who(1).

NOTES
       Only the first line of the ~/.project file is printed.

       For reporting of last login times, finger will use the
       /var/adm/lastlog file, if it exists.  A DG/UX system does not create
       this file, but you can create it if desired.  The required file
       format is defined in /usr/include/lastlog.h.  To create or modify
       entries in the file using a C program, you must call lseek(2) to
       position the file pointer based on the user-ID.  The file pointer
       offset for a given user-ID (uid) entry is (uid * sizeof(struct
       lastlog)).  A subsequent call to write(2) will record the updated
       entry in the /var/adm/lastlog file.

       For reporting who is logged in, finger, when not given explicit
       usernames, uses /etc/utmp.  In /etc/utmp, logins are truncated to
       eight characters.  With logins greater than eight characters, finger
       will not get an exact match when using these truncated logins to
       obtain user information from the password databases. To indicate that
       a password entry wasn't found, finger displays the truncated login
       followed by "???" in the Name column and nothing else.  When using
       finger -l for a long format printout of all users, only the "Login
       name" and "In real life" fields will be displayed for logins greater
       than eight characters, with the "In real life" field set to "???".


Licensed material--property of copyright holder(s)