![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to finger.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / finger|
Return to finger.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / finger |
1.1 root 1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)finger.1 6.11 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .Dt FINGER 1
22: .Os BSD 4
23: .Sh NAME
24: .Nm finger
25: .Nd user information lookup program
26: .Sh SYNOPSIS
27: .Nm finger
28: .Op Fl lmsp
29: .Ob
30: .Ar user
31: .Op \&@host
32: \&...
33: .Oe
34: .Sh DESCRIPTION
35: The
36: .Nm finger
37: command has two basic output formats providing essentially the same
38: information.
39: .Pp
40: Options are:
41: .Tw Ds
42: .Tp Fl s
43: .Nm Finger
44: displays the user's login name, real name, terminal name and write
45: status (as a ``*'' after the terminal name if write permission is
46: denied), idle time, login time, office location and office phone
47: number.
48: .Pp
49: Idle time is in minutes if it is a single integer, hours and minutes
50: if a ``:'' is present, or days if a ``d'' is present.
51: Login time is displayed as month, day, hours and minutes, unless
52: more than six months ago, in which case the year is displayed rather
53: than the hours and minutes.
54: .Pp
55: Unknown devices as well as nonexistent idle and login times are
56: displayed as single asterisks.
57: .Pp
58: .Tp Fl l
59: Produces a multi-line format displaying all of the information
60: described for the
61: .Fl s
62: option as well as the user's home directory, home phone number, login
63: shell, and the contents of the files
64: .Dq Pa .plan
65: and
66: .Dq Pa .project
67: from the user's home directory.
68: .Pp
69: If idle time is at least a minute and less than a day, it is
70: presented in the form ``hh:mm''.
71: Idle times greater than a day are presented as ``d day[s]hh:mm''.
72: .Pp
73: Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
74: Numbers specified as ten or seven digits are printed as the appropriate
75: subset of that string.
76: Numbers specified as five digits are printed as ``xN-NNNN''.
77: .Pp
78: If write permission is denied to the device, the phrase ``(messages off)''
79: is appended to the line containing the device name.
80: One entry per user is displayed with the
81: .Fl l
82: option; if a user is logged on multiple times, terminal information
83: is repeated once per login.
84: .Pp
85: .Tp Fl p
86: Prevents
87: the
88: .Fl l
89: option of
90: .Nm finger
91: from displaying the contents of the
92: .Dq Pa .plan
93: and
94: .Dq Pa .project
95: files.
96: .Pp
97: Note that some fields may be missing, in either format, if information
98: is not available for them.
99: .Tp Fl m
100: Prevent matching of
101: .Ar user
102: names.
103: .Ar User
104: is usually a login name; however, matching will also be done on the
105: users' real names, unless the
106: .Fl m
107: option is supplied.
108: All name matching performed by
109: .Nm finger
110: is case insensitive.
111: .Tp
112: .Pp
113: If no options are specified,
114: .Nm finger
115: defaults to the
116: .Fl l
117: style output if operands are provided, otherwise to the
118: .Fl s
119: style.
120: .Pp
121: If no arguments are specified,
122: .Nm finger
123: will print an entry for each user currently logged into the system.
124: .Pp
125: .Nm Finger
126: may be used to look up users on a remote machine.
127: The format is to specify a
128: .Ar user
129: as
130: .Dq Li user@host ,
131: or
132: .Dq Li @host ,
133: where the default output
134: format for the former is the
135: .Fl l
136: style, and the default output format for the latter is the
137: .Fl s
138: style.
139: The
140: .Fl l
141: option is the only option that may be passed to a remote machine.
142: .Sh SEE ALSO
143: .Xr chpass 1 ,
144: .Xr w 1 ,
145: .Xr who 1 ,
146: .Xr getpwent 3
147: .Sh HISTORY
148: .Nm Finger
149: appeared in 3 BSD.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.