1inetadm(1M)             System Administration Commands             inetadm(1M)
2
3
4

NAME

6       inetadm - observe or configure inetd-controlled services
7

SYNOPSIS

9       inetadm
10
11
12       inetadm -?
13
14
15       inetadm -p
16
17
18       inetadm -l {FMRI | pattern}
19
20
21       inetadm -e {FMRI | pattern}
22
23
24       inetadm -d {FMRI | pattern}
25
26
27       inetadm -m {FMRI | pattern}... {name=value}...
28
29
30       inetadm -M {name=value}...
31
32

DESCRIPTION

34       The  inetadm utility provides the following capabilities for inetd-man‐
35       aged SMF services:
36
37           o      Provides a list of all such services installed.
38
39           o      Lists the services' properties and values.
40
41           o      Allows enabling and disabling of services.
42
43           o      Allows modification of the services'property values, as well
44                  as the default values provided by inetd.
45
46
47       See smf(5) for a description of an SMF service.
48
49
50       With  no arguments, inetadm lists all services under inetd(1M) control,
51       including such attributes as their current run state and whether or not
52       they are enabled.
53

OPTIONS

55       For options taking one or more FMRI operands (see smf(5) for a descrip‐
56       tion of an FMRI), if the operand specifies a service (instead of a ser‐
57       vice  instance),  and  that service has only a single instance, inetadm
58       operates on that instance.
59
60
61       If a service name is supplied and it contains more than  one  instances
62       or  a  pattern is supplied and and it matches more than one instance, a
63       warning message is displayed and that operand is ignored.
64
65
66       For those options taking name=value parameters, a description  of  each
67       of  the possible names and the allowed values is found in the inetd(1M)
68       man page.
69
70
71       The following options are supported:
72
73       -?
74
75           Display a usage message.
76
77
78       -p
79
80           Lists all default inet service property values provided by inetd in
81           the  form  of name=value pairs. If the value is of boolean type, it
82           is listed as TRUE or FALSE.
83
84
85       -l {FMRI | pattern}...
86
87           List  all  properties  for  the  specified  service  instances   as
88           name=value  pairs.  In addition, if the property value is inherited
89           from the default value provided by inetd, the  name=value  pair  is
90           identified by the token (default). Property inheritance occurs when
91           properties do not have a specified service instance default.
92
93
94       -e {FMRI | pattern}...
95
96           Enable the specified service instances.
97
98
99       -d {FMRI | pattern}...
100
101           Disable the specified service instances.
102
103
104       -m {FMRI | pattern}...{name=value}...
105
106           Change the values of the specified  properties  of  the  identified
107           service instances. Properties are specified as whitespace-separated
108           name=value pairs. To remove an instance-specific value  and  accept
109           the default value for a property, simply specify the property with‐
110           out a value, for example, name= .
111
112
113       -M {name=value}...
114
115           Change the values of the specified inetd default properties.  Prop‐
116           erties are specified as whitespace-separated name=value pairs.
117
118

EXAMPLES

120       Example 1 Displaying Properties for a Service
121
122
123       The following command displays the properties for the spray service.
124
125
126         # inetadm -l network/rpc/spray:default
127         SCOPE    NAME=VALUE
128                  name="sprayd"
129                  endpoint_type="tli"
130                  proto="datagram_v"
131                  isrpc=TRUE
132                  rpc_low_version=1
133                  rpc_high_version=1
134                  wait=TRUE
135                  exec="/usr/lib/netsvc/spray/rpc.sprayd"
136                  user="root"
137         default  bind_addr=""
138         default  bind_fail_max=-1
139         default  bind_fail_interval=-1
140         default  max_con_rate=-1
141         default  max_copies=-1
142         default  con_rate_offline=-1
143         default  failrate_cnt=40
144         default  failrate_interval=60
145         default  inherit_env=TRUE
146         default  tcp_trace=FALSE
147         default  tcp_wrappers=FALSE
148         default  connection_backlog=10
149
150
151       Example 2 Displaying Default Properties
152
153
154       The following command displays default properties.
155
156
157         # inetadm -p
158         NAME=VALUE
159         bind_addr=""
160         bind_fail_max=-1
161         bind_fail_interval=-1
162         max_con_rate=-1
163         max_copies=-1
164         con_rate_offline=-1
165         failrate_cnt=40
166         failrate_interval=60
167         inherit_env=TRUE
168         tcp_trace=FALSE
169         tcp_wrappers=FALSE
170         default  connection_backlog=10
171
172
173       Example 3 Changing Property Values for a Service
174
175
176       The  following  command  changes rpc_high_version to 3 and tcp_trace to
177       TRUE for the spray service.
178
179
180         # inetadm -m network/rpc/spray:default \
181                  rpc_high_version=3 tcp_trace=TRUE
182         # inetadm -l network/rpc/spray:default
183         SCOPE    NAME=VALUE
184                  name="sprayd"
185                  endpoint_type="tli"
186                  proto="datagram_v"
187                  isrpc=TRUE
188                  rpc_low_version=1
189                  rpc_high_version=3
190                  wait=TRUE
191                  exec="/usr/lib/netsvc/spray/rpc.sprayd"
192                  user="root"
193         default  bind_addr=""
194         default  bind_fail_max=-1
195         default  bind_fail_interval=-1
196         default  max_con_rate=-1
197         default  max_copies=-1
198         default  con_rate_offline=-1
199         default  failrate_cnt=40
200         default  failrate_interval=60
201         default  inherit_env=TRUE
202                  tcp_trace=TRUE
203         default  tcp_wrappers=FALSE
204         default  connection_backlog=10
205
206

EXIT STATUS

208       The following exit values are returned:
209
210       0    Operation completed successfully.
211
212
213       1    A fatal error occurred. An accompanying error message will provide
214            further information.
215
216
217       2    Invalid arguments were supplied, such as an ambiguous service FMRI
218            or pattern.
219
220

ATTRIBUTES

222       See attributes(5) for descriptions of the following attributes:
223
224
225
226
227       ┌─────────────────────────────┬─────────────────────────────┐
228       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
229       ├─────────────────────────────┼─────────────────────────────┤
230       │Availability                 │SUNWcsu                      │
231       ├─────────────────────────────┼─────────────────────────────┤
232       │Interface Stability          │Evolving                     │
233       └─────────────────────────────┴─────────────────────────────┘
234

SEE ALSO

236       inetd(1M), svccfg(1M), attributes(5), smf(5)
237
238
239
240SunOS 5.11                        5 Jul 2007                       inetadm(1M)
Impressum