This commit was manufactured by cvs2svn to create tag 'FreeBSD-release/1.0'.

[unix-history] / usr.sbin / inetd / inetd.8

diff --git a/usr.sbin/inetd/inetd.8 b/usr.sbin/inetd/inetd.8
index 5dbb198..17e233a 100644 (file)
--- a/usr.sbin/inetd/inetd.8
+++ b/usr.sbin/inetd/inetd.8
@@ -29,7 +29,8 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"     @(#)inetd.8    6.7 (Berkeley) 3/16/91
+.\"     from: @(#)inetd.8      6.7 (Berkeley) 3/16/91
+.\"    $Id: inetd.8,v 1.2 1993/09/23 17:31:37 jtc Exp $

 .\"
 .Dd March 16, 1991
 .Dt INETD 8
 .\"
 .Dd March 16, 1991
 .Dt INETD 8


@@ -41,6 +42,7 @@
 .Sh SYNOPSIS
 .Nm inetd
 .Op Fl d
 .Sh SYNOPSIS
 .Nm inetd
 .Op Fl d

+.Op Fl l

 .Op Ar configuration file
 .Sh DESCRIPTION
 .Nm Inetd
 .Op Ar configuration file
 .Sh DESCRIPTION
 .Nm Inetd


@@ -64,6 +66,8 @@ The option available for
 .Bl -tag -width Ds
 .It Fl d
 Turns on debugging.
 .Bl -tag -width Ds
 .It Fl d
 Turns on debugging.

+.It Fl l
+Turns on logging.

 .El
 .Pp
 Upon execution,
 .El
 .Pp
 Upon execution,


@@ -87,6 +91,20 @@ server program
 server program arguments
 .Ed
 .Pp
 server program arguments
 .Ed
 .Pp

+To specify an 
+.Em Sun-RPC 
+based service, the entry would contain these fields.
+.Pp
+.Bd -unfilled -offset indent -compact
+service name/version
+socket type
+rpc/protocol
+wait/nowait
+user
+server program
+server program arguments
+.Ed
+.Pp

 The
 .Em service-name
 entry is the name of a valid service in
 The
 .Em service-name
 entry is the name of a valid service in


@@ -98,7 +116,19 @@ services (discussed below), the service
 name
 .Em must
 be the official name of the service (that is, the first entry in
 name
 .Em must
 be the official name of the service (that is, the first entry in

-.Pa /etc/services ) .
+.Pa /etc/services ) . 
+When used to specify a
+.Em Sun-RPC
+based service, this field is a valid RPC service name in
+the file
+.Pa /etc/rpc . 
+The part on the right of the 
+.Dq /
+is the RPC version number. This
+can simply be a single numeric argument or a range of versions.
+A range is bounded by the low version to the high version - 
+.Dq rusers/1-3 .
+

 .Pp
 The
 .Em socket-type
 .Pp
 The
 .Em socket-type


@@ -120,6 +150,12 @@ Examples might be
 .Dq tcp
 or
 .Dq udp .
 .Dq tcp
 or
 .Dq udp .

+Rpc based services are specified with the 
+.Dq rpc/tcp
+or 
+.Dq rpc/udp 
+service type.
+

 .Pp
 The
 .Em wait/nowait
 .Pp
 The
 .Em wait/nowait


@@ -201,6 +237,15 @@ details of these services, consult the appropriate
 .Tn RFC
 from the Network Information Center.
 .Pp
 .Tn RFC
 from the Network Information Center.
 .Pp

+When given the
+.Fl l
+option
+.Nm Inetd
+will log an entry to syslog each time an 
+.Xr accept 2 
+is made, which notes the
+service selected and the IP-number of the remote requestor.
+.Pp

 .Nm Inetd
 rereads its configuration file when it receives a hangup signal,
 .Dv SIGHUP .
 .Nm Inetd
 rereads its configuration file when it receives a hangup signal,
 .Dv SIGHUP .


@@ -220,3 +265,8 @@ The
 .Nm
 command appeared in
 .Bx 4.3 .
 .Nm
 command appeared in
 .Bx 4.3 .

+Support for
+.Em Sun-RPC 
+based services is modelled after that
+provided by
+.Em Sun-OS 4.1 .