1.\" Copyright (c) 1980, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)fingerd.8 8.1 (Berkeley) 06/04/93 7.\" 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.Op Fl s 17.Op Fl l 18.Op Fl p Ar filename 19.Sh DESCRIPTION 20.Nm Fingerd 21is a simple protocol based on 22.%T RFC1196 23that provides an interface to the 24Name and Finger programs at several network sites. 25The program is supposed to return a friendly, 26human-oriented status report on either the system at the moment 27or a particular person in depth. 28There is no required format and the 29protocol consists mostly of specifying a single 30.Dq command line . 31.Pp 32.Nm Fingerd 33listens for 34.Tn TCP 35requests at port 79. 36Once connected it reads a single command line 37terminated by a 38.Aq Tn CRLF 39which is passed to 40.Xr finger 1 . 41.Nm Fingerd 42closes its connections as soon as the output is finished. 43.Pp 44If the line is null (i.e. just a 45.Aq Tn CRLF 46is sent) then 47.Xr finger 48returns a 49.Dq default 50report that lists all people logged into 51the system at that moment. 52.Pp 53If a user name is specified (e.g. 54.Pf eric Aq Tn CRLF ) 55then the 56response lists more extended information for only that particular user, 57whether logged in or not. 58Allowable 59.Dq names 60in the command line include both 61.Dq login names 62and 63.Dq user names . 64If a name is ambiguous, all possible derivations are returned. 65.Pp 66The following options may be passed to 67.Nm fingerd 68as server program arguments in 69.Pa /etc/inetd.conf : 70.Bl -tag -width Ds 71.It Fl s 72Enable secure mode. 73Queries without a user name are rejected and 74forwarding of queries to other remote hosts is denied. 75.It Fl l 76Enable logging. 77The name of the host originating the query is reported via 78.Xr syslog 3 79at LOG_NOTICE priority. 80.It Fl p 81Use an alternate program as the local information provider. 82The default local program 83executed by 84.Nm fingerd 85is 86.Xr finger 1 . 87By specifying a customized local server, 88this option allows a system manager 89to have more control over what information is 90provided to remote sites. 91.El 92.Sh SEE ALSO 93.Xr finger 1 94.Sh BUGS 95Connecting directly to the server from a 96.Tn TIP 97or an equally narrow-minded 98.Tn TELNET Ns \-protocol 99user program can result 100in meaningless attempts at option negotiation being sent to the 101server, which will foul up the command line interpretation. 102.Nm Fingerd 103should be taught to filter out 104.Tn IAC Ns \'s 105and perhaps even respond 106negatively 107.Pq Tn IAC WON'T 108to all option commands received. 109.Sh HISTORY 110The 111.Nm 112command appeared in 113.Bx 4.3 . 114