1 '\" te
2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH SVCADM 1M "Oct 17, 2017"
7 .SH NAME
8 svcadm \- manipulate service instances
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] enable [\fB-rst\fR]
13 [{\fIFMRI\fR | \fIpattern\fR}...]
14 .fi
15
16 .LP
17 .nf
18 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] disable [\fB-s\fR]
19 [{\fIFMRI\fR | \fIpattern\fR}...]
20 .fi
21
22 .LP
23 .nf
24 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] restart [\fB-d\fR]
25 [{\fIFMRI\fR | \fIpattern\fR}...]
26 .fi
27
28 .LP
29 .nf
30 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] refresh
31 [{\fIFMRI\fR | \fIpattern\fR}...]
32 .fi
33
34 .LP
35 .nf
36 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] clear
37 [{\fIFMRI\fR | \fIpattern\fR}...]
38 .fi
39
40 .LP
41 .nf
42 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] mark [\fB-It] \fIinstance_state\fR
43 [{\fIFMRI\fR | \fIpattern\fR}...]
44 .fi
45
46 .LP
47 .nf
48 \fB/usr/sbin/svcadm\fR [\fB-v\fR] milestone [\fB-d\fR] \fImilestone_FMRI\fR
49 .fi
50
51 .SH DESCRIPTION
52 .LP
53 \fBsvcadm\fR issues requests for actions on services executing within the
54 service management facility (see \fBsmf\fR(5)). Actions for a service are
55 carried out by its assigned service restarter agent. The default service
56 restarter is \fBsvc.startd\fR (see \fBsvc.startd\fR(1M)).
57 .SH OPTIONS
58 .LP
59 The following options are supported:
60 .sp
61 .ne 2
62 .na
63 \fB-S\fR \fIstate\fR
64 .ad
65 .RS 20n
66 For the subcommands which normally operate on explicit \fIFMRI\fRs or an
67 \fIFMRI\fR pattern, the \fB-S\fR option can be used to select all \fIFMRI\fRs
68 in the given state.
69 .RE
70
71 .sp
72 .ne 2
73 .na
74 \fB\fB-v\fR\fR
75 .ad
76 .RS 20n
77 Print actions verbosely to standard output.
78 .RE
82 .na
83 \fB-Z\fR
84 .ad
85 .RS 20n
86 Administer services in all zones. This option is only applicable
87 from the global zone, see \fBzones\fR(5).
88 .RE
89
90 .sp
91 .ne 2
92 .na
93 \fB-z\fR \fIzone\fR
94 .ad
95 .RS 20n
96 Administer services in the specified zone. This option is only applicable
97 from the global zone, see \fBzones\fR(5).
98 .RE
99
100 .SH SUBCOMMANDS
101 .SS "Common Operations"
102 .LP
103 The subcommands listed below are used during the typical administration of a
104 service instance.
105 .sp
106 .LP
107 For subcommands taking one or more operands, if the operand specifies a service
108 (instead of a service instance), and that service has only a single instance,
109 \fBsvcadm\fR operates on that instance. If an abbreviated \fIFMRI\fR (a fault
110 management resource identifier) matches more than one service or instance, a
111 warning message is displayed and that operand is ignored.
112 If a pattern matches more than one service or instance, the subcommand is
113 applied to all matches. See \fBsmf\fR(5).
114 .sp
115 .LP
116 In the case that the service has more than one instance, \fBsvcadm\fR return a
117 non-zero exit status.
118 .sp
119 .ne 2
120 .na
121 \fB\fBenable\fR \fB[\fR\fB-rst\fR\fB]\fR {\fIFMRI\fR | \fIpattern\fR}...\fR
122 .ad
206 This action requires permission to modify the "restarter_actions" property
207 group of the service instance (see \fBsmf_security\fR(5)).
208 .RE
209
210 .sp
211 .ne 2
212 .na
213 \fB\fBclear\fR {\fIFMRI\fR | \fIpattern\fR}...\fR
214 .ad
215 .sp .6
216 .RS 4n
217 For each service instance specified by the operands, if the instance is in the
218 \fBmaintenance\fR state, signal to the assigned restarter that the service has
219 been repaired. If the instance is in the \fBdegraded\fR state, request that the
220 assigned restarter take the service to the \fBonline\fR state. This action
221 requires permission to modify the "restarter_actions" property group of the
222 service instance (see \fBsmf_security\fR(5)).
223 .RE
224
225 .SS "Exceptional Operations"
226 .LP
227 The following subcommands are used for service development and temporary
228 administrative manipulation.
229 .sp
230 .ne 2
231 .na
232 \fB\fBmark [\fR\fB-It\fR\fB]\fR \fIinstance_state\fR {\fIFMRI\fR |
233 \fIpattern\fR}...\fR
234 .ad
235 .sp .6
236 .RS 4n
237 If \fIinstance_state\fR is "maintenance", then for each service specified by
238 the operands, \fBsvcadm\fR requests that the assigned restarter place the
239 service in the \fBmaintenance\fR state. See \fBsvc.startd\fR(1M) and
240 \fBinetd\fR(1M) for a detailed description of the actions taken for each
241 restarter.
242 .sp
243 If \fIinstance_state\fR is "degraded", then for services specified by the
244 operands in the online state, \fBsvcadm\fR requests that the restarters
245 assigned to the services move them into the \fBdegraded\fR state.
246 .sp
282 .sp
283 Changing the system's current milestone with the "milestone" subcommand will
284 not change the current run level of the system. To change the system's run
285 level, invoke \fB/sbin/init\fR directly.
286 .sp
287 This action requires permission to modify the "options_ovr" property group of
288 the \fBsvc:/system/svc/restarter:default\fR service instance (see
289 \fBsmf_security\fR(5)).
290 .sp
291 The \fB-d\fR option immediately changes the milestone to the requested
292 milestone, as above. Additionally, it makes the specified milestone the default
293 boot milestone, which persists across reboot. The default milestone is defined
294 by the \fBoptions/milestone\fR property on the master restarter,
295 \fBsvc:/system/svc/restarter:default\fR. If this property is absent, "all" is
296 the default. This action requires permission to modify the "options" property
297 group of the \fBsvc:/system/svc/restarter:default\fR service instance (see
298 \fBsmf_security\fR(5)).
299 .RE
300
301 .SS "Operands"
302 .LP
303 The following operands are supported:
304 .sp
305 .ne 2
306 .na
307 \fB\fIFMRI\fR\fR
308 .ad
309 .RS 11n
310 An \fIFMRI\fR that specifies one or more instances. \fIFMRI\fRs can be
311 abbreviated by specifying the instance name, or the trailing portion of the
312 service name. For example, given the \fIFMRI\fR:
313 .sp
314 .in +2
315 .nf
316 svc:/network/smtp:sendmail
317 .fi
318 .in -2
319 .sp
320
321 All the following are valid abbreviations:
322 .sp
348 .RE
349
350 .sp
351 .ne 2
352 .na
353 \fB\fIpattern\fR\fR
354 .ad
355 .RS 11n
356 A pattern that is matched against the \fIFMRIs\fR of service instances
357 according to the "globbing" rules described by \fBfnmatch\fR(5). If the pattern
358 does not begin with "svc:", then "svc:/" is prepended.
359 .RE
360
361 .sp
362 .LP
363 If an abbreviated \fIFMRI\fR matches more than one service, a warning message
364 is displayed and that operand is ignored.
365 If a pattern matches more than one service or instance, the subcommand is
366 applied to all matches.
367 .SH EXAMPLES
368 .LP
369 \fBExample 1 \fRRestarting a Service Instance
370 .sp
371 .LP
372 The following command restarts the \fBNFS\fR server. The full \fIFMRI\fR for
373 the default service instance is: \fBsvc:/network/nfs/server:default\fR
374
375 .sp
376 .LP
377 However, you can abbreviate the full \fIFMRI\fR as follows:
378
379 .sp
380 .in +2
381 .nf
382 # svcadm restart nfs/server
383 .fi
384 .in -2
385 .sp
386
387 .LP
388 \fBExample 2 \fRDisabling the Standard HTTP Server
440 .in +2
441 .nf
442 # svcadm milestone milestone/single-user
443 .fi
444 .in -2
445 .sp
446
447 .sp
448 .LP
449 The following command restores the running services:
450
451 .sp
452 .in +2
453 .nf
454 # svcadm milestone all
455 .fi
456 .in -2
457 .sp
458
459 .SH EXIT STATUS
460 .LP
461 The following exit values are returned:
462 .sp
463 .ne 2
464 .na
465 \fB\fB0\fR\fR
466 .ad
467 .RS 5n
468 Successful completion.
469 .RE
470
471 .sp
472 .ne 2
473 .na
474 \fB\fB1\fR\fR
475 .ad
476 .RS 5n
477 A fatal error occurred. One or more error messages are displayed on standard
478 error.
479 .RE
480
493 \fB\fB3\fR\fR
494 .ad
495 .RS 5n
496 \fBsvcadm\fR determined that a service instance that it was waiting for could
497 not reach the desired state without administrator intervention due to a problem
498 with the service instance itself.
499 .RE
500
501 .sp
502 .ne 2
503 .na
504 \fB\fB4\fR\fR
505 .ad
506 .RS 5n
507 \fBsvcadm\fR determined that a service instance that it was waiting for could
508 not reach the desired state without administrator intervention due to a problem
509 with the service's dependencies.
510 .RE
511
512 .SH ATTRIBUTES
513 .LP
514 See \fBattributes\fR(5) for descriptions of the following attributes:
515 .sp
516
517 .sp
518 .TS
519 box;
520 c | c
521 l | l .
522 ATTRIBUTE TYPE ATTRIBUTE VALUE
523 _
524 Interface Stability See below.
525 .TE
526
527 .sp
528 .LP
529 The interactive output is Uncommitted. The invocation and non-interactive
530 output are Committed.
531 .SH SEE ALSO
532 .LP
533 \fBsvcprop\fR(1), \fBsvcs\fR(1), \fBinetd\fR(1M), \fBinit\fR(1M),
534 \fBsvccfg\fR(1M), \fBsvc.startd\fR(1M), \fBlibscf\fR(3LIB), \fBcontract\fR(4),
535 \fBattributes\fR(5), \fBsmf\fR(5), \fBsmf_security\fR(5), \fBzones\fR(5)
536 .SH NOTES
537 .LP
538 The amount of time \fBsvcadm\fR will spend waiting for services and their
539 dependencies to change state is implicitly limited by their method timeouts.
540 For example, a service using the default restarter whose start method hangs
541 will be transitioned to the maintenance state when its timeout expires.
542 \fBsvcadm\fR will then consider it impossible for this service to come online
543 without administrator intervention.
544 .sp
545 .LP
546 Attempts to synchronously enable a service which depends (directly or
547 indirectly) on a file may fail with an exit status indicating that dependencies
548 are unsatisfied if the caller does not have the privileges necessary to search
549 the directory containing the file. This limitation may be removed in a future
550 release.
|
1 '\" te
2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
3 .\" Copyright 2019 Joyent, Inc.
4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7 .TH SVCADM 1M "Oct 24, 2019"
8 .SH NAME
9 svcadm \- manipulate service instances
10 .SH SYNOPSIS
11 .nf
12 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] enable [\fB-rst\fR]
13 [{\fIFMRI\fR | \fIpattern\fR}...]
14 .fi
15
16 .LP
17 .nf
18 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] disable [\fB-st\fR]
19 [{\fIFMRI\fR | \fIpattern\fR}...]
20 .fi
21
22 .LP
23 .nf
24 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] restart [\fB-d\fR]
25 [{\fIFMRI\fR | \fIpattern\fR}...]
26 .fi
27
28 .LP
29 .nf
30 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] refresh
31 [{\fIFMRI\fR | \fIpattern\fR}...]
32 .fi
33
34 .LP
35 .nf
36 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] clear
37 [{\fIFMRI\fR | \fIpattern\fR}...]
38 .fi
39
40 .LP
41 .nf
42 \fB/usr/sbin/svcadm\fR [\fB-S state\fR] [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] mark [\fB-It] \fIinstance_state\fR
43 [{\fIFMRI\fR | \fIpattern\fR}...]
44 .fi
45
46 .LP
47 .nf
48 \fB/usr/sbin/svcadm\fR [\fB-v\fR] milestone [\fB-d\fR] \fImilestone_FMRI\fR
49 .fi
50
51 .SH DESCRIPTION
52 \fBsvcadm\fR issues requests for actions on services executing within the
53 service management facility (see \fBsmf\fR(5)). Actions for a service are
54 carried out by its assigned service restarter agent. The default service
55 restarter is \fBsvc.startd\fR (see \fBsvc.startd\fR(1M)).
56 .SH OPTIONS
57 The following options are supported:
58 .sp
59 .ne 2
60 .na
61 \fB-S\fR \fIstate\fR
62 .ad
63 .RS 20n
64 For the subcommands which normally operate on explicit \fIFMRI\fRs or an
65 \fIFMRI\fR pattern, the \fB-S\fR option can be used to select all \fIFMRI\fRs
66 in the given state.
67 .RE
68
69 .sp
70 .ne 2
71 .na
72 \fB\fB-v\fR\fR
73 .ad
74 .RS 20n
75 Print actions verbosely to standard output.
76 .RE
80 .na
81 \fB-Z\fR
82 .ad
83 .RS 20n
84 Administer services in all zones. This option is only applicable
85 from the global zone, see \fBzones\fR(5).
86 .RE
87
88 .sp
89 .ne 2
90 .na
91 \fB-z\fR \fIzone\fR
92 .ad
93 .RS 20n
94 Administer services in the specified zone. This option is only applicable
95 from the global zone, see \fBzones\fR(5).
96 .RE
97
98 .SH SUBCOMMANDS
99 .SS "Common Operations"
100 The subcommands listed below are used during the typical administration of a
101 service instance.
102 .sp
103 .LP
104 For subcommands taking one or more operands, if the operand specifies a service
105 (instead of a service instance), and that service has only a single instance,
106 \fBsvcadm\fR operates on that instance. If an abbreviated \fIFMRI\fR (a fault
107 management resource identifier) matches more than one service or instance, a
108 warning message is displayed and that operand is ignored.
109 If a pattern matches more than one service or instance, the subcommand is
110 applied to all matches. See \fBsmf\fR(5).
111 .sp
112 .LP
113 In the case that the service has more than one instance, \fBsvcadm\fR return a
114 non-zero exit status.
115 .sp
116 .ne 2
117 .na
118 \fB\fBenable\fR \fB[\fR\fB-rst\fR\fB]\fR {\fIFMRI\fR | \fIpattern\fR}...\fR
119 .ad
203 This action requires permission to modify the "restarter_actions" property
204 group of the service instance (see \fBsmf_security\fR(5)).
205 .RE
206
207 .sp
208 .ne 2
209 .na
210 \fB\fBclear\fR {\fIFMRI\fR | \fIpattern\fR}...\fR
211 .ad
212 .sp .6
213 .RS 4n
214 For each service instance specified by the operands, if the instance is in the
215 \fBmaintenance\fR state, signal to the assigned restarter that the service has
216 been repaired. If the instance is in the \fBdegraded\fR state, request that the
217 assigned restarter take the service to the \fBonline\fR state. This action
218 requires permission to modify the "restarter_actions" property group of the
219 service instance (see \fBsmf_security\fR(5)).
220 .RE
221
222 .SS "Exceptional Operations"
223 The following subcommands are used for service development and temporary
224 administrative manipulation.
225 .sp
226 .ne 2
227 .na
228 \fB\fBmark [\fR\fB-It\fR\fB]\fR \fIinstance_state\fR {\fIFMRI\fR |
229 \fIpattern\fR}...\fR
230 .ad
231 .sp .6
232 .RS 4n
233 If \fIinstance_state\fR is "maintenance", then for each service specified by
234 the operands, \fBsvcadm\fR requests that the assigned restarter place the
235 service in the \fBmaintenance\fR state. See \fBsvc.startd\fR(1M) and
236 \fBinetd\fR(1M) for a detailed description of the actions taken for each
237 restarter.
238 .sp
239 If \fIinstance_state\fR is "degraded", then for services specified by the
240 operands in the online state, \fBsvcadm\fR requests that the restarters
241 assigned to the services move them into the \fBdegraded\fR state.
242 .sp
278 .sp
279 Changing the system's current milestone with the "milestone" subcommand will
280 not change the current run level of the system. To change the system's run
281 level, invoke \fB/sbin/init\fR directly.
282 .sp
283 This action requires permission to modify the "options_ovr" property group of
284 the \fBsvc:/system/svc/restarter:default\fR service instance (see
285 \fBsmf_security\fR(5)).
286 .sp
287 The \fB-d\fR option immediately changes the milestone to the requested
288 milestone, as above. Additionally, it makes the specified milestone the default
289 boot milestone, which persists across reboot. The default milestone is defined
290 by the \fBoptions/milestone\fR property on the master restarter,
291 \fBsvc:/system/svc/restarter:default\fR. If this property is absent, "all" is
292 the default. This action requires permission to modify the "options" property
293 group of the \fBsvc:/system/svc/restarter:default\fR service instance (see
294 \fBsmf_security\fR(5)).
295 .RE
296
297 .SS "Operands"
298 The following operands are supported:
299 .sp
300 .ne 2
301 .na
302 \fB\fIFMRI\fR\fR
303 .ad
304 .RS 11n
305 An \fIFMRI\fR that specifies one or more instances. \fIFMRI\fRs can be
306 abbreviated by specifying the instance name, or the trailing portion of the
307 service name. For example, given the \fIFMRI\fR:
308 .sp
309 .in +2
310 .nf
311 svc:/network/smtp:sendmail
312 .fi
313 .in -2
314 .sp
315
316 All the following are valid abbreviations:
317 .sp
343 .RE
344
345 .sp
346 .ne 2
347 .na
348 \fB\fIpattern\fR\fR
349 .ad
350 .RS 11n
351 A pattern that is matched against the \fIFMRIs\fR of service instances
352 according to the "globbing" rules described by \fBfnmatch\fR(5). If the pattern
353 does not begin with "svc:", then "svc:/" is prepended.
354 .RE
355
356 .sp
357 .LP
358 If an abbreviated \fIFMRI\fR matches more than one service, a warning message
359 is displayed and that operand is ignored.
360 If a pattern matches more than one service or instance, the subcommand is
361 applied to all matches.
362 .SH EXAMPLES
363 \fBExample 1 \fRRestarting a Service Instance
364 .sp
365 .LP
366 The following command restarts the \fBNFS\fR server. The full \fIFMRI\fR for
367 the default service instance is: \fBsvc:/network/nfs/server:default\fR
368
369 .sp
370 .LP
371 However, you can abbreviate the full \fIFMRI\fR as follows:
372
373 .sp
374 .in +2
375 .nf
376 # svcadm restart nfs/server
377 .fi
378 .in -2
379 .sp
380
381 .LP
382 \fBExample 2 \fRDisabling the Standard HTTP Server
434 .in +2
435 .nf
436 # svcadm milestone milestone/single-user
437 .fi
438 .in -2
439 .sp
440
441 .sp
442 .LP
443 The following command restores the running services:
444
445 .sp
446 .in +2
447 .nf
448 # svcadm milestone all
449 .fi
450 .in -2
451 .sp
452
453 .SH EXIT STATUS
454 The following exit values are returned:
455 .sp
456 .ne 2
457 .na
458 \fB\fB0\fR\fR
459 .ad
460 .RS 5n
461 Successful completion.
462 .RE
463
464 .sp
465 .ne 2
466 .na
467 \fB\fB1\fR\fR
468 .ad
469 .RS 5n
470 A fatal error occurred. One or more error messages are displayed on standard
471 error.
472 .RE
473
486 \fB\fB3\fR\fR
487 .ad
488 .RS 5n
489 \fBsvcadm\fR determined that a service instance that it was waiting for could
490 not reach the desired state without administrator intervention due to a problem
491 with the service instance itself.
492 .RE
493
494 .sp
495 .ne 2
496 .na
497 \fB\fB4\fR\fR
498 .ad
499 .RS 5n
500 \fBsvcadm\fR determined that a service instance that it was waiting for could
501 not reach the desired state without administrator intervention due to a problem
502 with the service's dependencies.
503 .RE
504
505 .SH ATTRIBUTES
506 See \fBattributes\fR(5) for descriptions of the following attributes:
507 .sp
508
509 .sp
510 .TS
511 box;
512 c | c
513 l | l .
514 ATTRIBUTE TYPE ATTRIBUTE VALUE
515 _
516 Interface Stability See below.
517 .TE
518
519 .sp
520 .LP
521 The interactive output is Uncommitted. The invocation and non-interactive
522 output are Committed.
523 .SH SEE ALSO
524 \fBsvcprop\fR(1), \fBsvcs\fR(1), \fBinetd\fR(1M), \fBinit\fR(1M),
525 \fBsvccfg\fR(1M), \fBsvc.startd\fR(1M), \fBlibscf\fR(3LIB), \fBcontract\fR(4),
526 \fBattributes\fR(5), \fBsmf\fR(5), \fBsmf_security\fR(5), \fBzones\fR(5)
527 .SH NOTES
528 The amount of time \fBsvcadm\fR will spend waiting for services and their
529 dependencies to change state is implicitly limited by their method timeouts.
530 For example, a service using the default restarter whose start method hangs
531 will be transitioned to the maintenance state when its timeout expires.
532 \fBsvcadm\fR will then consider it impossible for this service to come online
533 without administrator intervention.
534 .sp
535 .LP
536 Attempts to synchronously enable a service which depends (directly or
537 indirectly) on a file may fail with an exit status indicating that dependencies
538 are unsatisfied if the caller does not have the privileges necessary to search
539 the directory containing the file. This limitation may be removed in a future
540 release.
|