share/man/man4/inetd.conf.4

   1 '\" te
   2 .\"  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.
   3 .\" Copyright (C) 2004, Sun Microsystems, Inc. All Rights Reserved
   4 .TH INETD.CONF 4 "April 9, 2016"
   5 .SH NAME
   6 inetd.conf \- Internet servers database
   7 .SH SYNOPSIS
   8 .LP
   9 .nf
  10 \fB/etc/inet/inetd.conf\fR
  11 .fi
  12
  13 .LP
  14 .nf
  15 \fB/etc/inetd.conf\fR
  16 .fi
  17
  18 .SH DESCRIPTION
  19 .LP
  20 In the current release of the Solaris operating system, the \fBinetd.conf\fR
  21 file is no longer directly used to configure \fBinetd\fR. The Solaris services
  22 which were formerly configured using this file are now configured in the
  23 Service Management Facility (see \fBsmf\fR(5)) using \fBinetadm\fR(8). Any
  24 records remaining in this file after installation or upgrade, or later created
  25 by installing additional software, must be converted to \fBsmf\fR(5) services
  26 and imported into the SMF repository using \fBinetconv\fR(8), otherwise the
  27 service will not be available.
  28 .sp
  29 .LP
  30 For Solaris operating system releases prior to the current release (such as
  31 Solaris 9), the \fBinetd.conf\fR file contains the list of servers that
  32 \fBinetd\fR(8) invokes when it receives an Internet request over a socket.
  33 Each server entry is composed of a single line of the form:
  34 .sp
  35 .in +2
  36 .nf
  37 \fIservice-name\fR \fIendpoint-type\fR \fIprotocol \fR\fIwait-status\fR \fIuid\fR \fIserver-program\fR \e
  38 \fIserver-arguments\fR
  39 .fi
  40 .in -2
  41 .sp
  42
  43 .sp
  44 .LP
  45 Fields are separated by either SPACE or TAB characters. A `\fB#\fR' (number
  46 sign) indicates the beginning of a comment; characters up to the end of the
  47 line are not interpreted by routines that search this file.
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fIservice-name\fR\fR
  52 .ad
  53 .RS 20n
  54 The name of a valid service listed in the \fBservices\fR file. For \fBRPC\fR
  55 services, the value of the \fIservice-name\fR field consists of the \fBRPC\fR
  56 service name or program number, followed by a '\fB/\fR' (slash) and either a
  57 version number or a range of version numbers, for example, \fBrstatd/2-4\fR.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fIendpoint-type\fR\fR
  64 .ad
  65 .RS 20n
  66 Can be one of:
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fBstream\fR\fR
  71 .ad
  72 .RS 13n
  73 for a stream socket
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .na
  79 \fB\fBdgram\fR\fR
  80 .ad
  81 .RS 13n
  82 for a datagram socket
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fBraw\fR\fR
  89 .ad
  90 .RS 13n
  91 for a raw socket
  92 .RE
  93
  94 .sp
  95 .ne 2
  96 .na
  97 \fB\fBseqpacket\fR\fR
  98 .ad
  99 .RS 13n
 100 for a sequenced packet socket
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fBtli\fR\fR
 107 .ad
 108 .RS 13n
 109 for all \fBTLI\fR endpoints
 110 .RE
 111
 112 .RE
 113
 114 .sp
 115 .ne 2
 116 .na
 117 \fB\fIprotocol\fR\fR
 118 .ad
 119 .RS 20n
 120 A recognized protocol listed in the file \fB/etc/inet/protocols\fR. For servers
 121 capable of supporting \fBTCP\fR and \fBUDP\fR over IPv6, the following protocol
 122 types are also recognized:
 123 .RS +4
 124 .TP
 125 .ie t \(bu
 126 .el o
 127 \fBtcp6\fR
 128 .RE
 129 .RS +4
 130 .TP
 131 .ie t \(bu
 132 .el o
 133 \fBudp6\fR
 134 .RE
 135 \fB\fR\fBtcp6\fR and \fBudp6\fR are not official protocols; accordingly, they
 136 are not listed in the \fB/etc/inet/protocols\fR file.
 137 .sp
 138 Here the \fBinetd\fR program uses an \fBAF_INET6\fR type socket endpoint. These
 139 servers can also handle incoming IPv4 client requests in addition to IPv6
 140 client requests.
 141 .sp
 142 For \fBRPC\fR services, the field consists of the string \fBrpc\fR followed by
 143 a '/' (slash) and either a '*' (asterisk), one or more nettypes, one or more
 144 netids, or a combination of nettypes and netids. Whatever the value, it is
 145 first treated as a nettype. If it is not a valid nettype, then it is treated as
 146 a netid. For example, \fBrpc/*\fR for an \fBRPC\fR service using all the
 147 transports supported by the system (the list can be found in the
 148 \fB/etc/netconfig\fR file), equivalent to saying \fBrpc/visible rpc/ticots\fR
 149 for an \fBRPC\fR service using the Connection-Oriented Transport Service.
 150 .RE
 151
 152 .sp
 153 .ne 2
 154 .na
 155 \fB\fIwait-status\fR\fR
 156 .ad
 157 .RS 20n
 158 This field has values \fBwait\fR or \fBnowait\fR. This entry specifies whether
 159 the server that is invoked by \fBinetd\fR will take over the listening socket
 160 associated with the service, and whether once launched, \fBinetd\fR will
 161 \fBwait\fR for that server to exit, if ever, before it resumes listening for
 162 new service requests. The \fIwait-status\fR for datagram servers must be set to
 163 \fBwait\fR, as they are always invoked with the original datagram socket that
 164 will participate in delivering the service bound to the specified service. They
 165 do not have separate "listening" and "accepting" sockets. Accordingly, do not
 166 configure \fBUDP\fR services as \fBnowait\fR. This causes a race condition by
 167 which the \fBinetd\fR program selects on the socket and the server program
 168 reads from the socket. Many server programs will be forked, and performance
 169 will be severely compromised. Connection-oriented services such as \fBTCP\fR
 170 stream services can be designed to be either \fBwait\fR or \fBnowait\fR status.
 171 .RE
 172
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fIuid\fR\fR
 177 .ad
 178 .RS 20n
 179 The user \fBID\fR under which the server should run. This allows servers to run
 180 with access privileges other than those for root.
 181 .RE
 182
 183 .sp
 184 .ne 2
 185 .na
 186 \fB\fIserver-program\fR\fR
 187 .ad
 188 .RS 20n
 189 Either the pathname of a server program to be invoked by \fBinetd\fR to perform
 190 the requested service, or the value \fBinternal\fR if \fBinetd\fR itself
 191 provides the service.
 192 .RE
 193
 194 .sp
 195 .ne 2
 196 .na
 197 \fB\fIserver-arguments\fR\fR
 198 .ad
 199 .RS 20n
 200 If a server must be invoked with command line arguments, the entire command
 201 line (including argument 0) must appear in this field (which consists of all
 202 remaining words in the entry). If the server expects \fBinetd\fR to pass it the
 203 address of its peer, for compatibility with 4.2BSD executable daemons, then the
 204 first argument to the command should be specified as \fB%A\fR. No more than 20
 205 arguments are allowed in this field. The \fB%A\fR argument is implemented only
 206 for services whose \fIwait-status\fR value is \fBnowait\fR.
 207 .RE
 208
 209 .SH FILES
 210 .ne 2
 211 .na
 212 \fB\fB/etc/netconfig\fR\fR
 213 .ad
 214 .RS 23n
 215 network configuration file
 216 .RE
 217
 218 .sp
 219 .ne 2
 220 .na
 221 \fB\fB/etc/inet/protocols\fR\fR
 222 .ad
 223 .RS 23n
 224 Internet protocols
 225 .RE
 226
 227 .sp
 228 .ne 2
 229 .na
 230 \fB\fB/etc/inet/services\fR\fR
 231 .ad
 232 .RS 23n
 233 Internet network services
 234 .RE
 235
 236 .SH SEE ALSO
 237 .LP
 238 \fBrlogin\fR(1), \fBrsh\fR(1), \fBin.tftpd\fR(8), \fBinetadm\fR(8),
 239 \fBinetconv\fR(8), \fBinetd\fR(8), \fBservices\fR(4), \fBsmf\fR(5)
 240 .SH NOTES
 241 .LP
 242 \fB/etc/inet/inetd.conf\fR is the official SVR4 name of the \fBinetd.conf\fR
 243 file. The symbolic link \fB/etc/inetd.conf\fR exists for \fBBSD\fR
 244 compatibility.
 245 .sp
 246 .LP
 247 This man page describes \fBinetd.conf\fR as it was supported in Solaris
 248 operating system releases prior to the current release. The services that were
 249 configured by means of \fBinetd.conf\fR are now configured in the Service
 250 Management Facility (see \fBsmf\fR(5)) using \fBinetadm\fR(8).