finger(1) - osol9

1finger(1)                        User Commands                       finger(1)
2
3
4

NAME

6       finger - display information about local and remote users
7

SYNOPSIS

9       finger [-bfhilmpqsw] [username]...
10
11
12       finger [-l]
13            [username@hostname 1 [@hostname 2 .. .@hostname n]...]
14
15
16       finger [-l] [@hostname 1 [@hostname 2 .. .@hostname n]...]
17
18

DESCRIPTION

20       By default, the finger command displays in multi-column format the fol‐
21       lowing information about each logged-in user:
22
23           o      user name
24
25           o      user's full name
26
27           o      terminal name (prepended with a `*'  (asterisk)   if  write-
28                  permission is denied)
29
30           o      idle time
31
32           o      login time
33
34           o      host name, if logged in remotely
35
36
37       Idle time is in minutes if it is a single integer, in hours and minutes
38       if a `:' (colon)  is present, or in days and hours if a `d' is present.
39
40
41       When one or more username arguments are given, more  detailed  informa‐
42       tion  is  given for each username specified, whether they are logged in
43       or not. username must be that of a local user, and may be  a  first  or
44       last  name,  or an account name. Information is presented in multi-line
45       format as follows:
46
47           o      the user name and the user's full name
48
49           o      the user's home directory and login shell
50
51           o      time the user logged in if currently logged in, or the  time
52                  the user last logged in; and the terminal or host from which
53                  the user logged in
54
55           o      last time the user received mail, and the last time the user
56                  read mail
57
58           o      the first line of the $HOME/.project file, if it exists
59
60           o      the contents of the $HOME/.plan file, if it exists
61
62
63       Note:  when  the comment (GECOS) field in /etc/passwd includes a comma,
64       finger does not display the information following the comma.
65
66
67       If the arguments username@hostname1[@hostname2...@hostnamen] or  @host‐
68       name1[@hostname2...@hostnamen]  are  used, the request is sent first to
69       hostnamen and forwarded through each  hostnamen-1  to   hostname1.  The
70       program  uses  the  finger  user information protocol (see RFC 1288) to
71       query that remote host for information about the named user (if   user‐
72       name  is specified), or about each logged-in user. The information dis‐
73       played is server dependent.
74
75
76       As required by RFC 1288, finger  passes  only  printable,  7-bit  ASCII
77       data.  This behavior may be modified by a system administrator by using
78       the PASS option in /etc/default/finger. Specifying PASS=low allows  all
79       characters  less than decimal 32 ASCII. Specifying PASS=high allows all
80       characters  greater  than   decimal   126   ASCII.   PASS=low,high   or
81       PASS=high,low  allows both characters less than 32 and greater than 126
82       to pass through.
83

OPTIONS

85       The following options are supported, except that the  username@hostname
86       form supports only the -l option:
87
88       -b     Suppresses  printing  the  user's  home directory and shell in a
89              long format printout.
90
91
92       -f     Suppresses printing the header that is  normally  printed  in  a
93              non-long format printout.
94
95
96       -h     Suppresses printing of the .project file in a long format print‐
97              out.
98
99
100       -i     Forces "idle" output format, which is similar  to  short  format
101              except  that only the login name, terminal, login time, and idle
102              time are printed.
103
104
105       -l     Forces long output format.
106
107
108       -m     Matches arguments only on user name (not first or last name).
109
110
111       -p     Suppresses printing of the .plan file in a long format printout.
112
113
114       -q     Forces quick output format, which is  similar  to  short  format
115              except  that  only  the login name, terminal, and login time are
116              printed.
117
118
119       -s     Forces short output format.
120
121
122       -w     Suppresses printing the full name in a short format printout.
123
124

FILES

126       $HOME/.plan             user's plan
127
128
129       $HOME/.project          user's projects
130
131
132       /etc/default/finger     finger options file
133
134
135       /etc/passwd             password file
136
137
138       /var/adm/lastlog        time of last login
139
140
141       /var/adm/utmpx          accounting
142
143

ATTRIBUTES

145       See attributes(5) for descriptions of the following attributes:
146
147
148
149
150       ┌─────────────────────────────┬─────────────────────────────┐
151       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
152       ├─────────────────────────────┼─────────────────────────────┤
153       │Availability                 │SUNWrcmds                    │
154       └─────────────────────────────┴─────────────────────────────┘
155

NOTES

165       The finger user information protocol limits the  options  that  may  be
166       used with the remote form of this command.
167
168
169
170SunOS 5.11                        6 Nov 2000                         finger(1)