xref: /csrg-svn/libexec/fingerd/fingerd.8 (revision 61423)
1*61423Sbostic.\" Copyright (c) 1980, 1991, 1993
2*61423Sbostic.\"	The Regents of the University of California.  All rights reserved.
328704Smckusick.\"
443766Strent.\" %sccs.include.redist.man%
528704Smckusick.\"
6*61423Sbostic.\"     @(#)fingerd.8	8.1 (Berkeley) 06/04/93
735555Sbostic.\"
847462Scael.Dd
947462Scael.Dt FINGERD 8
1047462Scael.Os BSD 4.3
1147462Scael.Sh NAME
1247462Scael.Nm fingerd
1347462Scael.Nd remote user information server
1447462Scael.Sh SYNOPSIS
1547462Scael.Nm fingerd
1655084Stef.Op Fl s
1755084Stef.Op Fl l
1855084Stef.Op Fl p Ar filename
1947462Scael.Sh DESCRIPTION
2047462Scael.Nm Fingerd
2147462Scaelis a simple protocol based on
2255084Stef.%T RFC1196
2347462Scaelthat provides an interface to the
2428704SmckusickName and Finger programs at several network sites.
2528704SmckusickThe program is supposed to return a friendly,
2628704Smckusickhuman-oriented status report on either the system at the moment
2728704Smckusickor a particular person in depth.
2828704SmckusickThere is no required format and the
2947462Scaelprotocol consists mostly of specifying a single
3047462Scael.Dq command line .
3147462Scael.Pp
3247462Scael.Nm Fingerd
3347462Scaellistens for
3447462Scael.Tn TCP
3547462Scaelrequests at port 79.
3628704SmckusickOnce connected it reads a single command line
3747462Scaelterminated by a
3847462Scael.Aq Tn CRLF
3947462Scaelwhich is passed to
4047462Scael.Xr finger 1 .
4147462Scael.Nm Fingerd
4228704Smckusickcloses its connections as soon as the output is finished.
4347462Scael.Pp
4447462ScaelIf the line is null (i.e. just a
4547462Scael.Aq Tn CRLF
4647462Scaelis sent) then
4747462Scael.Xr finger
4847462Scaelreturns a
4947462Scael.Dq default
5047462Scaelreport that lists all people logged into
5128704Smckusickthe system at that moment.
5247462Scael.Pp
5347462ScaelIf a user name is specified (e.g.
5447462Scael.Pf eric Aq Tn CRLF )
5547462Scaelthen the
5628704Smckusickresponse lists more extended information for only that particular user,
5728704Smckusickwhether logged in or not.
5847462ScaelAllowable
5947462Scael.Dq names
6047462Scaelin the command line include both
6147462Scael.Dq login names
6247462Scaeland
6347462Scael.Dq user names .
6428704SmckusickIf a name is ambiguous, all possible derivations are returned.
6555084Stef.Pp
6655084StefThe following options may be passed to
6755084Stef.Nm fingerd
6855084Stefas server program arguments in
6955084Stef.Pa /etc/inetd.conf :
7055084Stef.Bl -tag -width Ds
7155084Stef.It Fl s
7255084StefEnable secure mode.
7355084StefQueries without a user name are rejected and
7455084Stefforwarding of queries to other remote hosts is denied.
7555084Stef.It Fl l
7655084StefEnable logging.
7755084StefThe name of the host originating the query is reported via
7855084Stef.Xr syslog 3
7955084Stefat LOG_NOTICE priority.
8055084Stef.It Fl p
8155084StefUse an alternate program as the local information provider.
8255084StefThe default local program
8355084Stefexecuted by
8455084Stef.Nm fingerd
8555084Stefis
8655084Stef.Xr finger 1 .
8755084StefBy specifying a customized local server,
8855084Stefthis option allows a system manager
8955084Stefto have more control over what information is
9055084Stefprovided to remote sites.
9155084Stef.El
9247462Scael.Sh SEE ALSO
9347462Scael.Xr finger 1
9447462Scael.Sh BUGS
9547462ScaelConnecting directly to the server from a
9647462Scael.Tn TIP
9747462Scaelor an equally narrow-minded
9847462Scael.Tn TELNET Ns \-protocol
9947462Scaeluser program can result
10028704Smckusickin meaningless attempts at option negotiation being sent to the
10128704Smckusickserver, which will foul up the command line interpretation.
10247462Scael.Nm Fingerd
10347462Scaelshould be taught to filter out
10447462Scael.Tn IAC Ns \'s
10547462Scaeland perhaps even respond
10647462Scaelnegatively
10747462Scael.Pq Tn IAC WON'T
10847462Scaelto all option commands received.
10947462Scael.Sh HISTORY
11047462ScaelThe
11147462Scael.Nm
11247462Scaelcommand appeared in
11347462Scael.Bx 4.3 .
114