macro and text revision (-mdoc version 3)
[unix-history] / usr / src / libexec / fingerd / fingerd.8
CommitLineData
0fccfdb8 1.\" Copyright (c) 1980, 1991 The Regents of the University of California.
54b3b5b7 2.\" All rights reserved.
e6b338bd 3.\"
2e4fb7d2 4.\" %sccs.include.redist.man%
e6b338bd 5.\"
0fccfdb8 6.\" @(#)fingerd.8 6.4 (Berkeley) %G%
54b3b5b7 7.\"
0fccfdb8
CL
8.Dd
9.Dt FINGERD 8
10.Os BSD 4.3
11.Sh NAME
12.Nm fingerd
13.Nd remote user information server
14.Sh SYNOPSIS
15.Nm fingerd
16.Sh DESCRIPTION
17.Nm Fingerd
18is a simple protocol based on
19.%T RFC742
20that provides an interface to the
e6b338bd
KM
21Name and Finger programs at several network sites.
22The program is supposed to return a friendly,
23human-oriented status report on either the system at the moment
24or a particular person in depth.
25There is no required format and the
0fccfdb8
CL
26protocol consists mostly of specifying a single
27.Dq command line .
28.Pp
29.Nm Fingerd
30listens for
31.Tn TCP
32requests at port 79.
e6b338bd 33Once connected it reads a single command line
0fccfdb8
CL
34terminated by a
35.Aq Tn CRLF
36which is passed to
37.Xr finger 1 .
38.Nm Fingerd
e6b338bd 39closes its connections as soon as the output is finished.
0fccfdb8
CL
40.Pp
41If the line is null (i.e. just a
42.Aq Tn CRLF
43is sent) then
44.Xr finger
45returns a
46.Dq default
47report that lists all people logged into
e6b338bd 48the system at that moment.
0fccfdb8
CL
49.Pp
50If a user name is specified (e.g.
51.Pf eric Aq Tn CRLF )
52then the
e6b338bd
KM
53response lists more extended information for only that particular user,
54whether logged in or not.
0fccfdb8
CL
55Allowable
56.Dq names
57in the command line include both
58.Dq login names
59and
60.Dq user names .
e6b338bd 61If a name is ambiguous, all possible derivations are returned.
0fccfdb8
CL
62.Sh SEE ALSO
63.Xr finger 1
64.Sh BUGS
65Connecting directly to the server from a
66.Tn TIP
67or an equally narrow-minded
68.Tn TELNET Ns \-protocol
69user program can result
e6b338bd
KM
70in meaningless attempts at option negotiation being sent to the
71server, which will foul up the command line interpretation.
0fccfdb8
CL
72.Nm Fingerd
73should be taught to filter out
74.Tn IAC Ns \'s
75and perhaps even respond
76negatively
77.Pq Tn IAC WON'T
78to all option commands received.
79.Sh HISTORY
80The
81.Nm
82command appeared in
83.Bx 4.3 .