macro and text revision (-mdoc version 3)

[unix-history] / usr / src / libexec / fingerd / fingerd.8

diff --git a/usr/src/libexec/fingerd/fingerd.8 b/usr/src/libexec/fingerd/fingerd.8
index 72fe703..7f38f36 100644 (file)
--- a/usr/src/libexec/fingerd/fingerd.8
+++ b/usr/src/libexec/fingerd/fingerd.8
@@ -1,52 +1,83 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1991 The Regents of the University of California.

 .\" All rights reserved.
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\" All rights reserved.
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"    @(#)fingerd.8   6.3 (Berkeley) %G%
+.\"     @(#)fingerd.8  6.4 (Berkeley) %G%

 .\"
 .\"

-.TH FINGERD 8 ""
-.UC 6
-.SH NAME
-fingerd \- remote user information server
-.SH SYNOPSIS
-.B fingerd
-.SH DESCRIPTION
-.I Fingerd
-is a simple protocol based on RFC742 that provides an interface to the
+.Dd 
+.Dt FINGERD 8
+.Os BSD 4.3
+.Sh NAME
+.Nm fingerd
+.Nd remote user information server
+.Sh SYNOPSIS
+.Nm fingerd
+.Sh DESCRIPTION
+.Nm Fingerd
+is a simple protocol based on
+.%T RFC742
+that provides an interface to the

 Name and Finger programs at several network sites.
 The program is supposed to return a friendly,
 human-oriented status report on either the system at the moment
 or a particular person in depth.
 There is no required format and the
 Name and Finger programs at several network sites.
 The program is supposed to return a friendly,
 human-oriented status report on either the system at the moment
 or a particular person in depth.
 There is no required format and the

-protocol consists mostly of specifying a single ``command line''.
-.PP
-.I Fingerd
-listens for TCP requests at port 79.
+protocol consists mostly of specifying a single
+.Dq command line .
+.Pp
+.Nm Fingerd
+listens for
+.Tn TCP
+requests at port 79.

 Once connected it reads a single command line
 Once connected it reads a single command line

-terminated by a <CRLF> which is passed to
-.IR finger (1).
-.I Fingerd
+terminated by a
+.Aq Tn CRLF
+which is passed to
+.Xr finger 1 .
+.Nm Fingerd

 closes its connections as soon as the output is finished.
 closes its connections as soon as the output is finished.

-.PP
-If the line is null (i.e. just a <CRLF> is sent) then 
-.I finger
-returns a ``default'' report that lists all people logged into
+.Pp
+If the line is null (i.e. just a
+.Aq Tn CRLF
+is sent) then 
+.Xr finger
+returns a
+.Dq default
+report that lists all people logged into

 the system at that moment.
 the system at that moment.

-.PP
-If a user name is specified (e.g. eric<CRLF>) then the
+.Pp
+If a user name is specified (e.g.
+.Pf eric Aq Tn CRLF )
+then the

 response lists more extended information for only that particular user,
 whether logged in or not.
 response lists more extended information for only that particular user,
 whether logged in or not.

-Allowable ``names'' in the command line include both ``login names''
-and ``user names''.
+Allowable
+.Dq names
+in the command line include both
+.Dq login names
+and
+.Dq user names .

 If a name is ambiguous, all possible derivations are returned.
 If a name is ambiguous, all possible derivations are returned.

-.SH SEE ALSO
-finger(1)
-.SH BUGS
-Connecting directly to the server from a TIP
-or an equally narrow-minded TELNET-protocol user program can result
+.Sh SEE ALSO
+.Xr finger 1
+.Sh BUGS
+Connecting directly to the server from a
+.Tn TIP
+or an equally narrow-minded
+.Tn TELNET Ns \-protocol
+user program can result

 in meaningless attempts at option negotiation being sent to the
 server, which will foul up the command line interpretation.
 in meaningless attempts at option negotiation being sent to the
 server, which will foul up the command line interpretation.

-.I Fingerd
-should be taught to filter out IAC's and perhaps even respond
-negatively (IAC WON'T) to all option commands received.
+.Nm Fingerd
+should be taught to filter out
+.Tn IAC Ns \'s
+and perhaps even respond
+negatively
+.Pq Tn IAC WON'T
+to all option commands received.
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.3 .