xref: /csrg-svn/libexec/fingerd/fingerd.8 (revision 47462)
1*47462Scael.\" Copyright (c) 1980, 1991 The Regents of the University of California.
235555Sbostic.\" All rights reserved.
328704Smckusick.\"
443766Strent.\" %sccs.include.redist.man%
528704Smckusick.\"
6*47462Scael.\"     @(#)fingerd.8	6.4 (Berkeley) 03/16/91
735555Sbostic.\"
8*47462Scael.Dd
9*47462Scael.Dt FINGERD 8
10*47462Scael.Os BSD 4.3
11*47462Scael.Sh NAME
12*47462Scael.Nm fingerd
13*47462Scael.Nd remote user information server
14*47462Scael.Sh SYNOPSIS
15*47462Scael.Nm fingerd
16*47462Scael.Sh DESCRIPTION
17*47462Scael.Nm Fingerd
18*47462Scaelis a simple protocol based on
19*47462Scael.%T RFC742
20*47462Scaelthat provides an interface to the
2128704SmckusickName and Finger programs at several network sites.
2228704SmckusickThe program is supposed to return a friendly,
2328704Smckusickhuman-oriented status report on either the system at the moment
2428704Smckusickor a particular person in depth.
2528704SmckusickThere is no required format and the
26*47462Scaelprotocol consists mostly of specifying a single
27*47462Scael.Dq command line .
28*47462Scael.Pp
29*47462Scael.Nm Fingerd
30*47462Scaellistens for
31*47462Scael.Tn TCP
32*47462Scaelrequests at port 79.
3328704SmckusickOnce connected it reads a single command line
34*47462Scaelterminated by a
35*47462Scael.Aq Tn CRLF
36*47462Scaelwhich is passed to
37*47462Scael.Xr finger 1 .
38*47462Scael.Nm Fingerd
3928704Smckusickcloses its connections as soon as the output is finished.
40*47462Scael.Pp
41*47462ScaelIf the line is null (i.e. just a
42*47462Scael.Aq Tn CRLF
43*47462Scaelis sent) then
44*47462Scael.Xr finger
45*47462Scaelreturns a
46*47462Scael.Dq default
47*47462Scaelreport that lists all people logged into
4828704Smckusickthe system at that moment.
49*47462Scael.Pp
50*47462ScaelIf a user name is specified (e.g.
51*47462Scael.Pf eric Aq Tn CRLF )
52*47462Scaelthen the
5328704Smckusickresponse lists more extended information for only that particular user,
5428704Smckusickwhether logged in or not.
55*47462ScaelAllowable
56*47462Scael.Dq names
57*47462Scaelin the command line include both
58*47462Scael.Dq login names
59*47462Scaeland
60*47462Scael.Dq user names .
6128704SmckusickIf a name is ambiguous, all possible derivations are returned.
62*47462Scael.Sh SEE ALSO
63*47462Scael.Xr finger 1
64*47462Scael.Sh BUGS
65*47462ScaelConnecting directly to the server from a
66*47462Scael.Tn TIP
67*47462Scaelor an equally narrow-minded
68*47462Scael.Tn TELNET Ns \-protocol
69*47462Scaeluser program can result
7028704Smckusickin meaningless attempts at option negotiation being sent to the
7128704Smckusickserver, which will foul up the command line interpretation.
72*47462Scael.Nm Fingerd
73*47462Scaelshould be taught to filter out
74*47462Scael.Tn IAC Ns \'s
75*47462Scaeland perhaps even respond
76*47462Scaelnegatively
77*47462Scael.Pq Tn IAC WON'T
78*47462Scaelto all option commands received.
79*47462Scael.Sh HISTORY
80*47462ScaelThe
81*47462Scael.Nm
82*47462Scaelcommand appeared in
83*47462Scael.Bx 4.3 .
84