only executable by group dialer
[unix-history] / usr / src / libexec / fingerd / fingerd.8
CommitLineData
54b3b5b7
KB
1.\" Copyright (c) 1980 The Regents of the University of California.
2.\" All rights reserved.
e6b338bd 3.\"
54b3b5b7
KB
4.\" Redistribution and use in source and binary forms are permitted
5.\" provided that the above copyright notice and this paragraph are
6.\" duplicated in all such forms and that any documentation,
7.\" advertising materials, and other materials related to such
8.\" distribution and use acknowledge that the software was developed
9.\" by the University of California, Berkeley. The name of the
10.\" University may not be used to endorse or promote products derived
11.\" from this software without specific prior written permission.
12.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
e6b338bd 15.\"
54b3b5b7
KB
16.\" @(#)fingerd.8 6.2 (Berkeley) %G%
17.\"
18.TH FINGERD 8 ""
e6b338bd
KM
19.UC 6
20.SH NAME
21fingerd \- remote user information server
22.SH SYNOPSIS
23.B /etc/fingerd
24.SH DESCRIPTION
25.I Fingerd
26is a simple protocol based on RFC742 that provides an interface to the
27Name and Finger programs at several network sites.
28The program is supposed to return a friendly,
29human-oriented status report on either the system at the moment
30or a particular person in depth.
31There is no required format and the
32protocol consists mostly of specifying a single ``command line''.
33.PP
34.I Fingerd
35listens for TCP requests at port 79.
36Once connected it reads a single command line
37terminated by a <CRLF> which is passed to
38.IR finger (1).
39.I Fingerd
40closes its connections as soon as the output is finished.
41.PP
42If the line is null (i.e. just a <CRLF> is sent) then
43.I finger
44returns a ``default'' report that lists all people logged into
45the system at that moment.
46.PP
47If a user name is specified (e.g. eric<CRLF>) then the
48response lists more extended information for only that particular user,
49whether logged in or not.
50Allowable ``names'' in the command line include both ``login names''
51and ``user names''.
52If a name is ambiguous, all possible derivations are returned.
53.SH SEE ALSO
54finger(1)
55.SH BUGS
56Connecting directly to the server from a TIP
57or an equally narrow-minded TELNET-protocol user program can result
58in meaningless attempts at option negotiation being sent to the
59server, which will foul up the command line interpretation.
60.I Fingerd
61should be taught to filter out IAC's and perhaps even respond
62negatively (IAC WON'T) to all option commands received.