diff options
Diffstat (limited to 'usr/src/man/man5/inetd.conf.5')
| -rw-r--r-- | usr/src/man/man5/inetd.conf.5 | 256 |
1 files changed, 256 insertions, 0 deletions
diff --git a/usr/src/man/man5/inetd.conf.5 b/usr/src/man/man5/inetd.conf.5 new file mode 100644 index 0000000000..03d3e1e430 --- /dev/null +++ b/usr/src/man/man5/inetd.conf.5 @@ -0,0 +1,256 @@ +'\" te +.\" Copyright 1989 AT&T Copyright (c) 1985 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.\" Copyright (C) 2004, Sun Microsystems, Inc. All Rights Reserved +.TH INETD.CONF 5 "April 9, 2016" +.SH NAME +inetd.conf \- Internet servers database +.SH SYNOPSIS +.LP +.nf +\fB/etc/inet/inetd.conf\fR +.fi + +.LP +.nf +\fB/etc/inetd.conf\fR +.fi + +.SH DESCRIPTION +.LP +In the current release of the Solaris operating system, the \fBinetd.conf\fR +file is no longer directly used to configure \fBinetd\fR. The Solaris services +which were formerly configured using this file are now configured in the +Service Management Facility (see \fBsmf\fR(7)) using \fBinetadm\fR(8). Any +records remaining in this file after installation or upgrade, or later created +by installing additional software, must be converted to \fBsmf\fR(7) services +and imported into the SMF repository using \fBinetconv\fR(8), otherwise the +service will not be available. +.sp +.LP +For Solaris operating system releases prior to the current release (such as +Solaris 9), the \fBinetd.conf\fR file contains the list of servers that +\fBinetd\fR(8) invokes when it receives an Internet request over a socket. +Each server entry is composed of a single line of the form: +.sp +.in +2 +.nf +\fIservice-name\fR \fIendpoint-type\fR \fIprotocol \fR\fIwait-status\fR \fIuid\fR \fIserver-program\fR \e +\fIserver-arguments\fR +.fi +.in -2 +.sp + +.sp +.LP +Fields are separated by either SPACE or TAB characters. A `\fB#\fR' (number +sign) indicates the beginning of a comment; characters up to the end of the +line are not interpreted by routines that search this file. +.sp +.ne 2 +.na +\fB\fIservice-name\fR\fR +.ad +.RS 20n +The name of a valid service listed in the \fBservices\fR file. For \fBRPC\fR +services, the value of the \fIservice-name\fR field consists of the \fBRPC\fR +service name or program number, followed by a '\fB/\fR' (slash) and either a +version number or a range of version numbers, for example, \fBrstatd/2-4\fR. +.RE + +.sp +.ne 2 +.na +\fB\fIendpoint-type\fR\fR +.ad +.RS 20n +Can be one of: +.sp +.ne 2 +.na +\fB\fBstream\fR\fR +.ad +.RS 13n +for a stream socket +.RE + +.sp +.ne 2 +.na +\fB\fBdgram\fR\fR +.ad +.RS 13n +for a datagram socket +.RE + +.sp +.ne 2 +.na +\fB\fBraw\fR\fR +.ad +.RS 13n +for a raw socket +.RE + +.sp +.ne 2 +.na +\fB\fBseqpacket\fR\fR +.ad +.RS 13n +for a sequenced packet socket +.RE + +.sp +.ne 2 +.na +\fB\fBtli\fR\fR +.ad +.RS 13n +for all \fBTLI\fR endpoints +.RE + +.RE + +.sp +.ne 2 +.na +\fB\fIprotocol\fR\fR +.ad +.RS 20n +A recognized protocol listed in the file \fB/etc/inet/protocols\fR. For servers +capable of supporting \fBTCP\fR and \fBUDP\fR over IPv6, the following protocol +types are also recognized: +.RS +4 +.TP +.ie t \(bu +.el o +\fBtcp6\fR +.RE +.RS +4 +.TP +.ie t \(bu +.el o +\fBudp6\fR +.RE +\fB\fR\fBtcp6\fR and \fBudp6\fR are not official protocols; accordingly, they +are not listed in the \fB/etc/inet/protocols\fR file. +.sp +Here the \fBinetd\fR program uses an \fBAF_INET6\fR type socket endpoint. These +servers can also handle incoming IPv4 client requests in addition to IPv6 +client requests. +.sp +For \fBRPC\fR services, the field consists of the string \fBrpc\fR followed by +a '/' (slash) and either a '*' (asterisk), one or more nettypes, one or more +netids, or a combination of nettypes and netids. Whatever the value, it is +first treated as a nettype. If it is not a valid nettype, then it is treated as +a netid. For example, \fBrpc/*\fR for an \fBRPC\fR service using all the +transports supported by the system (the list can be found in the +\fB/etc/netconfig\fR file), equivalent to saying \fBrpc/visible rpc/ticots\fR +for an \fBRPC\fR service using the Connection-Oriented Transport Service. +.RE + +.sp +.ne 2 +.na +\fB\fIwait-status\fR\fR +.ad +.RS 20n +This field has values \fBwait\fR or \fBnowait\fR. This entry specifies whether +the server that is invoked by \fBinetd\fR will take over the listening socket +associated with the service, and whether once launched, \fBinetd\fR will +\fBwait\fR for that server to exit, if ever, before it resumes listening for +new service requests. The \fIwait-status\fR for datagram servers must be set to +\fBwait\fR, as they are always invoked with the original datagram socket that +will participate in delivering the service bound to the specified service. They +do not have separate "listening" and "accepting" sockets. Accordingly, do not +configure \fBUDP\fR services as \fBnowait\fR. This causes a race condition by +which the \fBinetd\fR program selects on the socket and the server program +reads from the socket. Many server programs will be forked, and performance +will be severely compromised. Connection-oriented services such as \fBTCP\fR +stream services can be designed to be either \fBwait\fR or \fBnowait\fR status. +.RE + +.sp +.ne 2 +.na +\fB\fIuid\fR\fR +.ad +.RS 20n +The user \fBID\fR under which the server should run. This allows servers to run +with access privileges other than those for root. +.RE + +.sp +.ne 2 +.na +\fB\fIserver-program\fR\fR +.ad +.RS 20n +Either the pathname of a server program to be invoked by \fBinetd\fR to perform +the requested service, or the value \fBinternal\fR if \fBinetd\fR itself +provides the service. +.RE + +.sp +.ne 2 +.na +\fB\fIserver-arguments\fR\fR +.ad +.RS 20n +If a server must be invoked with command line arguments, the entire command +line (including argument 0) must appear in this field (which consists of all +remaining words in the entry). If the server expects \fBinetd\fR to pass it the +address of its peer, for compatibility with 4.2BSD executable daemons, then the +first argument to the command should be specified as \fB%A\fR. No more than 20 +arguments are allowed in this field. The \fB%A\fR argument is implemented only +for services whose \fIwait-status\fR value is \fBnowait\fR. +.RE + +.SH FILES +.ne 2 +.na +\fB\fB/etc/netconfig\fR\fR +.ad +.RS 23n +network configuration file +.RE + +.sp +.ne 2 +.na +\fB\fB/etc/inet/protocols\fR\fR +.ad +.RS 23n +Internet protocols +.RE + +.sp +.ne 2 +.na +\fB\fB/etc/inet/services\fR\fR +.ad +.RS 23n +Internet network services +.RE + +.SH SEE ALSO +.LP +.BR rlogin (1), +.BR rsh (1), +.BR services (5), +.BR smf (7), +.BR in.tftpd (8), +.BR inetadm (8), +.BR inetconv (8), +.BR inetd (8) +.SH NOTES +.LP +\fB/etc/inet/inetd.conf\fR is the official SVR4 name of the \fBinetd.conf\fR +file. The symbolic link \fB/etc/inetd.conf\fR exists for \fBBSD\fR +compatibility. +.sp +.LP +This man page describes \fBinetd.conf\fR as it was supported in Solaris +operating system releases prior to the current release. The services that were +configured by means of \fBinetd.conf\fR are now configured in the Service +Management Facility (see \fBsmf\fR(7)) using \fBinetadm\fR(8). |
