finger

 

---

 
 
 
 User Commands                                           finger(1)
 
 
 


NAME
      finger - display information about local and remote users
 


SYNOPSIS
      finger [ -bfhilmpqsw ]  [ username ... ]
 
      finger [ -l ]  [  username@hostname  1  [  @hostname  2   ..
      .@hostname  n  ... ]  ]
 
      finger [ -l ]  [  @hostname  1  [  @hostname  2  ..  .@host-
      name  n  ... ]  ]
 


DESCRIPTION
      By default, the finger command displays in multi-column for-
      mat the following information about each logged-in user:
 
         +  user name
 
         +  user's full name
 
         +  terminal name (prepended with a `*' (asterisk)
             if write-permission is denied)
 
         +  idle time
 
         +  login time
 
         +  host name, if logged in remotely
 
      Idle time is in minutes if it is a single integer, in  hours
      and  minutes  if  a  `:' (colon)  is present, or in 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.
      Information is presented in multi-line format as follows:
 
         +  the user name and the user's full name
 
         +  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; and the terminal or host
            from which the user logged in
 
         +  last time the user received mail, and  the  last  time
            the user read mail
 
         +  the first line of the $HOME/.project
               file, if it exists
 
 
 
 SunOS 5.8            Last change: 1 Nov 1999                    1
 
 
 
 
 
 
 User Commands                                           finger(1)
 
 
 
         +  the contents of the $HOME/.plan
               file, if it exists
 
      Note: when the comment (GECOS) field in /etc/passwd includes
      a  comma,  finger does not display the information following
      the comma.
 
      If the arguments username@hostname1[@hostname2...@hostnamen]
      or @hostname1[@hostname2...@hostnamen] are used, the request
      is sent  first  to  hostnamen  and  forwarded  through  each
      hostnamen-1 to
       hostname1. The program uses  the  finger  user  information
      protocol (see RFC 1288) to query that remote host for infor-
      mation about the named user (if  username is specified),  or
      about  each  logged-in  user.  The  information displayed is
      server dependent.
 
      As required by RFC 1288, finger passes only printable, 7-bit
      ASCII  data.  This  behavior  may  be  modified  by a system
      administrator    by    using    the    PASS    option     in
      /etc/default/finger.  Specifying PASS=low allows all charac-
      ters less than decimal 32 ASCII. Specifying PASS=high allows
      all characters greater than decimal 126 ASCII. PASS=low,high
      or PASS=high,low allows both characters  less  than  32  and
      greater than 126 to pass through.
 


OPTIONS
      The  following  options  are  supported,  except  that   the
      username@hostname form supports only the -l option:
 
      -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  for-
            mat 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
 
 
 
 SunOS 5.8            Last change: 1 Nov 1999                    2
 
 
 
 
 
 
 User Commands                                           finger(1)
 
 
 
            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.
 
 USAGE
      The finger command is IPv6-enabled. See ip6(7P).
 


FILES
      $HOME/.plan
            user's plan
 
      $HOME/.project
            user's projects
 
      /etc/default/finger
            finger options file
 
      /etc/passwd"
            password file
 
      /var/adm/lastlog
            time of last login
 
      /var/adm/utmp
            accounting
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     | Availability                | SUNWcsu                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      passwd(1),  who(1),  whois(1),   passwd(4),   attributes(5),
      ip6(7P)
 
      Zimmerman, D., RFC 1288, The Finger User Information  Proto-
      col,  Center  for  Discrete Mathematics and Theoretical Com-
      puter Science (DIMACS), Rutgers University, December 1991.
 


NOTES
      The finger user information protocol limits the options that
      may be used with the remote form of this command.
 
 
 
 
 SunOS 5.8            Last change: 1 Nov 1999                    3
 
 
 

---