summaryrefslogtreecommitdiff
path: root/usr/src/man/man5/inetd.conf.5
blob: 03d3e1e430e2a290640a98419a8e821f086ea511 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
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).