Print this page
12721 would like svcadm disable -c
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man1/svcs.1
+++ new/usr/src/man/man1/svcs.1
1 1 '\" te
2 2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
3 +.\" Copyright 2020 Joyent, Inc.
3 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.
4 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.
5 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]
6 -.TH SVCS 1 "Apr 17, 2011"
7 +.TH SVCS 1 "May 11, 2020"
7 8 .SH NAME
8 9 svcs \- report service status
9 10 .SH SYNOPSIS
10 -.LP
11 11 .nf
12 12 \fBsvcs\fR [\fB-aHpv?\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fB-o\fR \fIcol\fR[,\fIcol\fR]]... [\fB-R\fR \fIFMRI-instance\fR]...
13 13 [\fB-sS\fR \fIcol\fR]... [\fIFMRI\fR | \fIpattern\fR]...
14 14 .fi
15 15
16 16 .LP
17 17 .nf
18 18 \fBsvcs\fR {\fB-d\fR | \fB-D\fR} [\fB-Hpv?\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fB-o\fR \fIcol\fR[,\fIcol\fR]]... [\fB-sS\fR \fIcol\fR]...
19 19 [\fIFMRI\fR | \fIpattern\fR] ...
20 20 .fi
21 21
22 22 .LP
↓ open down ↓ |
2 lines elided |
↑ open up ↑ |
23 23 .nf
24 24 \fBsvcs\fR [\fB-l\fR | \fB-L\fR] [\fB-vZ\fR] [\fB-z\fR \fIzone\fR] [\fIFMRI\fR | \fIpattern\fR]...
25 25 .fi
26 26
27 27 .LP
28 28 .nf
29 29 \fBsvcs\fR \fB-x\fR [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fIFMRI\fR]...
30 30 .fi
31 31
32 32 .SH DESCRIPTION
33 -.sp
34 -.LP
35 33 The \fBsvcs\fR command displays information about service instances as recorded
36 34 in the service configuration repository.
37 35 .sp
38 36 .LP
39 37 The first form of this command prints one-line status listings for service
40 38 instances specified by the arguments. Each instance is listed only once. With
41 39 no arguments, all enabled service instances, even if temporarily disabled, are
42 40 listed with the columns indicated below.
43 41 .sp
44 42 .LP
45 43 The second form prints one-line status listings for the dependencies or
46 44 dependents of the service instances specified by the arguments.
47 45 .sp
48 46 .LP
49 47 The third form prints detailed information about specific services and
50 48 instances.
51 49 .sp
52 50 .LP
53 51 The fourth form explains the states of service instances. For each argument, a
54 52 block of human-readable text is displayed which explains what state the service
↓ open down ↓ |
10 lines elided |
↑ open up ↑ |
55 53 is in, and why it is in that state. With no arguments, problematic services are
56 54 described.
57 55 .sp
58 56 .LP
59 57 Error messages are printed to the standard error stream.
60 58 .sp
61 59 .LP
62 60 The output of this command can be used appropriately as input to the
63 61 \fBsvcadm\fR(1M) command.
64 62 .SH OPTIONS
65 -.sp
66 -.LP
67 63 The following options are supported:
68 64 .sp
69 65 .ne 2
70 66 .na
71 67 \fB\fB-?\fR\fR
72 68 .ad
73 69 .RS 20n
74 70 Displays an extended usage message, including column specifiers.
75 71 .RE
76 72
77 73 .sp
78 74 .ne 2
79 75 .na
80 76 \fB\fB-a\fR\fR
81 77 .ad
82 78 .RS 20n
83 79 Show all services, even disabled ones. This option has no effect if services
84 80 are selected.
85 81 .RE
86 82
87 83 .sp
88 84 .ne 2
89 85 .na
90 86 \fB\fB-d\fR\fR
91 87 .ad
92 88 .RS 20n
93 89 Lists the services or service instances upon which the given service instances
94 90 depend.
95 91 .RE
96 92
97 93 .sp
98 94 .ne 2
99 95 .na
100 96 \fB\fB-D\fR\fR
101 97 .ad
102 98 .RS 20n
103 99 Lists the service instances that depend on the given services or service
104 100 instances.
105 101 .RE
106 102
107 103 .sp
108 104 .ne 2
109 105 .na
110 106 \fB\fB-H\fR\fR
111 107 .ad
112 108 .RS 20n
113 109 Omits the column headers.
114 110 .RE
115 111
116 112 .sp
117 113 .ne 2
118 114 .na
119 115 \fB\fB-l\fR\fR
120 116 .ad
121 117 .RS 20n
122 118 (The letter ell.) Displays all available information about the selected
123 119 services and service instances, with one service attribute displayed for each
124 120 line. Information for different instances are separated by blank lines.
125 121 .sp
126 122 The following specific attributes require further explanation:
127 123 .sp
128 124 .ne 2
129 125 .na
130 126 \fB\fBdependency\fR\fR
131 127 .ad
132 128 .RS 14n
133 129 Information about a dependency. The grouping and \fBrestart_on\fR properties
134 130 are displayed first and are separated by a forward slash (\fB/\fR). Next, each
135 131 entity and its state is listed. See \fBsmf\fR(5) for information about states.
136 132 In addition to the standard states, each service dependency can have the
137 133 following state descriptions:
138 134 .sp
139 135 .ne 2
140 136 .na
141 137 \fB\fBabsent\fR\fR
142 138 .ad
143 139 .RS 12n
144 140 No such service is defined on the system.
145 141 .RE
146 142
147 143 .sp
148 144 .ne 2
149 145 .na
150 146 \fB\fBinvalid\fR\fR
151 147 .ad
152 148 .RS 12n
153 149 The fault management resource identifier (FMRI) is invalid (see \fBsmf\fR(5)).
154 150 .RE
155 151
156 152 .sp
157 153 .ne 2
158 154 .na
159 155 \fB\fBmultiple\fR\fR
160 156 .ad
161 157 .RS 12n
162 158 The entity is a service with multiple instances.
163 159 .RE
164 160
165 161 File dependencies can only have one of the following state descriptions:
166 162 .sp
167 163 .ne 2
168 164 .na
169 165 \fB\fBabsent\fR\fR
170 166 .ad
171 167 .RS 11n
172 168 No such file on the system.
173 169 .RE
174 170
175 171 .sp
176 172 .ne 2
177 173 .na
178 174 \fB\fBonline\fR\fR
179 175 .ad
180 176 .RS 11n
181 177 The file exists.
182 178 .sp
183 179 If the file did not exist the last time that \fBsvc.startd\fR evaluated the
184 180 service's dependencies, it can consider the dependency to be unsatisfied.
185 181 \fBsvcadm refresh\fR forces dependency re-evaluation.
186 182 .RE
187 183
188 184 .sp
189 185 .ne 2
190 186 .na
191 187 \fB\fBunknown\fR\fR
192 188 .ad
193 189 .RS 11n
194 190 \fBstat\fR(2) failed for a reason other than \fBENOENT\fR.
195 191 .RE
196 192
197 193 See \fBsmf\fR(5) for additional details about dependencies, grouping, and
198 194 \fBrestart_on\fR values.
199 195 .RE
200 196
201 197 .sp
202 198 .ne 2
203 199 .na
204 200 \fB\fBenabled\fR\fR
↓ open down ↓ |
128 lines elided |
↑ open up ↑ |
205 201 .ad
206 202 .RS 14n
207 203 Whether the service is enabled or not, and whether it is enabled or disabled
208 204 temporarily (until the next system reboot). The former is specified as either
209 205 \fBtrue\fR or \fBfalse\fR, and the latter is designated by the presence of
210 206 \fB(temporary)\fR.
211 207 .sp
212 208 A service might be temporarily disabled because an administrator has run
213 209 \fBsvcadm disable -t\fR, used \fBsvcadm milestone\fR, or booted the system to a
214 210 specific milestone. See \fBsvcadm\fR(1M) for details.
211 +.sp
212 +If a service instance was disabled via
213 +\fBsvcadm disable -c\fR
214 +, then the provided comment will also be displayed.
215 215 .RE
216 216
217 217 .RE
218 218
219 219 .sp
220 220 .ne 2
221 221 .na
222 222 \fB-L\fR
223 223 .ad
224 224 .RS 20n
225 225 Display the log file of the selected services and service instances, one
226 226 per-line.
227 227 .RE
228 228
229 229 .sp
230 230 .ne 2
231 231 .na
232 232 \fB\fB-o\fR \fIcol\fR[,\fIcol\fR]...\fR
233 233 .ad
234 234 .RS 20n
235 235 Prints the specified columns. Each \fIcol\fR should be a column name. See
236 236 \fBCOLUMNS\fR below for available columns.
237 237 .RE
238 238
239 239 .sp
240 240 .ne 2
241 241 .na
242 242 \fB\fB-p\fR\fR
243 243 .ad
244 244 .RS 20n
245 245 Lists processes associated with each service instance. A service instance can
246 246 have no associated processes. The process ID, start time, and command name
247 247 (\fBPID\fR, \fBSTIME\fR, and \fBCMD\fR fields from \fBps\fR(1)) are displayed
248 248 for each process.
249 249 .RE
250 250
251 251 .sp
252 252 .ne 2
253 253 .na
254 254 \fB\fB-R\fR \fIFMRI-instance\fR\fR
255 255 .ad
256 256 .RS 20n
257 257 Selects service instances that have the given service instance as their
258 258 restarter.
259 259 .RE
260 260
261 261 .sp
262 262 .ne 2
263 263 .na
264 264 \fB\fB-s\fR \fIcol\fR\fR
265 265 .ad
266 266 .RS 20n
267 267 Sorts output by column. \fIcol\fR should be a column name. See \fBCOLUMNS\fR
268 268 below for available columns. Multiple \fB-s\fR options behave additively.
269 269 .RE
270 270
271 271 .sp
272 272 .ne 2
273 273 .na
274 274 \fB\fB-S\fR \fIcol\fR\fR
275 275 .ad
276 276 .RS 20n
277 277 Sorts by \fIcol\fR in the opposite order as option \fB-s\fR.
278 278 .RE
279 279
280 280 .sp
281 281 .ne 2
282 282 .na
283 283 \fB\fB-v\fR\fR
284 284 .ad
285 285 .RS 20n
286 286 Without \fB-x\fR or \fB-l\fR, displays verbose columns: \fBSTATE\fR,
287 287 \fBNSTATE\fR, \fBSTIME\fR, \fBCTID\fR, and \fBFMRI\fR.
288 288 .sp
289 289 With \fB-x\fR, displays extra information for each explanation.
290 290 .sp
291 291 With \fB-l\fR, displays user-visible properties in property groups of type
292 292 \fBapplication\fR and their description.
293 293 .RE
294 294
295 295 .sp
296 296 .ne 2
297 297 .na
298 298 \fB\fB-x\fR\fR
299 299 .ad
300 300 .RS 20n
301 301 Displays explanations for service states.
302 302 .sp
303 303 Without arguments, the \fB-x\fR option explains the states of services which:
304 304 .RS +4
305 305 .TP
306 306 .ie t \(bu
307 307 .el o
308 308 are enabled, but are not running.
309 309 .RE
310 310 .RS +4
311 311 .TP
312 312 .ie t \(bu
313 313 .el o
314 314 are preventing another enabled service from running.
315 315 .RE
316 316 .RE
317 317
318 318 .sp
319 319 .ne 2
320 320 .na
321 321 \fB-z \fIzone\fR
322 322 .ad
323 323 .RS 20n
324 324 Display only the services in the \fIzone\fR. This option is only applicable
325 325 in the global zone, see \fBzones\fR(5).
326 326 .RE
327 327
328 328 .sp
329 329 .ne 2
↓ open down ↓ |
105 lines elided |
↑ open up ↑ |
330 330 .na
331 331 \fB-Z\fR
332 332 .ad
333 333 .RS 20n
334 334 Display services from all zones, with an additional column indicating in which
335 335 zone the service is running. This option is only applicable in the global
336 336 zone, see \fBzones\fR(5).
337 337 .RE
338 338
339 339 .SH OPERANDS
340 -.sp
341 -.LP
342 340 The following operands are supported:
343 341 .sp
344 342 .ne 2
345 343 .na
346 344 \fB\fIFMRI\fR\fR
347 345 .ad
348 346 .RS 17n
349 347 A fault management resource identifier (FMRI) that specifies one or more
350 348 instances (see \fBsmf\fR(5)). FMRIs can be abbreviated by specifying the
351 349 instance name, or the trailing portion of the service name. For example, given
352 350 the FMRI:
353 351 .sp
354 352 .in +2
355 353 .nf
356 354 svc:/network/smtp:sendmail
357 355 .fi
358 356 .in -2
359 357 .sp
360 358
361 359 The following are valid abbreviations:
362 360 .sp
363 361 .in +2
364 362 .nf
365 363 sendmail
366 364 :sendmail
367 365 smtp
368 366 smtp:sendmail
369 367 network/smtp
370 368 .fi
371 369 .in -2
372 370 .sp
373 371
374 372 The following are invalid abbreviations:
375 373 .sp
376 374 .in +2
377 375 .nf
378 376 mail
379 377 network
380 378 network/smt
381 379 .fi
382 380 .in -2
383 381 .sp
384 382
385 383 If the FMRI specifies a service, then the command applies to all instances of
386 384 that service, except when used with the \fB-D\fR option.
387 385 .sp
388 386 Abbreviated forms of FMRIs are unstable, and should not be used in scripts or
389 387 other permanent tools.
390 388 .RE
391 389
392 390 .sp
393 391 .ne 2
394 392 .na
395 393 \fB\fIpattern\fR\fR
396 394 .ad
397 395 .RS 17n
398 396 A pattern that is matched against the \fIFMRI\fRs of service instances
399 397 according to the "globbing" rules described by \fBfnmatch\fR(5). If the pattern
400 398 does not begin with \fBsvc:\fR, then \fBsvc:/\fR is prepended. The following is
401 399 a typical example of a glob pattern:
402 400 .sp
403 401 .in +2
404 402 .nf
405 403 qexample% svcs \e*keyserv\e*
406 404 STATE STIME FMRI
407 405 disabled Aug_02 svc:/network/rpc/keyserv:default
408 406 .fi
409 407 .in -2
410 408 .sp
411 409
412 410 .RE
413 411
↓ open down ↓ |
62 lines elided |
↑ open up ↑ |
414 412 .sp
415 413 .ne 2
416 414 .na
417 415 \fB\fIFMRI-instance\fR\fR
418 416 .ad
419 417 .RS 17n
420 418 An FMRI that specifies an instance.
421 419 .RE
422 420
423 421 .SH COLUMNS
424 -.sp
425 -.LP
426 422 Column names are case insensitive. The default output format is equivalent to
427 423 "\fB-o\fR \fBstate,stime,fmri\fR". The default sorting columns are \fBSTATE\fR,
428 424 \fBSTIME\fR, \fBFMRI\fR.
429 425 .sp
430 426 .ne 2
431 427 .na
432 428 \fB\fBCTID\fR\fR
433 429 .ad
434 430 .RS 10n
435 431 The primary contract ID for the service instance. Not all instances have valid
436 432 primary contract IDs.
437 433 .RE
438 434
439 435 .sp
440 436 .ne 2
441 437 .na
442 438 \fB\fBDESC\fR\fR
443 439 .ad
444 440 .RS 10n
445 441 A brief description of the service, from its template element. A service might
446 442 not have a description available, in which case a hyphen (\fB\(hy\fR) is used
447 443 to denote an empty value.
448 444 .RE
449 445
450 446 .sp
451 447 .ne 2
452 448 .na
453 449 \fB\fBFMRI\fR\fR
454 450 .ad
455 451 .RS 10n
456 452 The \fIFMRI\fR of the service instance.
457 453 .RE
458 454
459 455 .sp
460 456 .ne 2
461 457 .na
462 458 \fB\fBINST\fR\fR
463 459 .ad
464 460 .RS 10n
465 461 The instance name of the service instance.
466 462 .RE
467 463
468 464 .sp
469 465 .ne 2
470 466 .na
471 467 \fB\fBNSTA\fR\fR
472 468 .ad
473 469 .RS 10n
474 470 The abbreviated next state of the service instance, as given in the \fBSTA\fR
475 471 column description. A hyphen denotes that the instance is not transitioning.
476 472 Same as \fBSTA\fR otherwise.
477 473 .RE
478 474
479 475 .sp
480 476 .ne 2
481 477 .na
482 478 \fB\fBNSTATE\fR\fR
483 479 .ad
484 480 .RS 10n
485 481 The next state of the service. A hyphen is used to denote that the instance is
486 482 not transitioning. Same as \fBSTATE\fR otherwise.
487 483 .RE
488 484
489 485 .sp
490 486 .ne 2
491 487 .na
492 488 \fB\fBSCOPE\fR\fR
493 489 .ad
494 490 .RS 10n
495 491 The scope name of the service instance.
496 492 .RE
497 493
498 494 .sp
499 495 .ne 2
500 496 .na
501 497 \fB\fBSVC\fR\fR
502 498 .ad
503 499 .RS 10n
504 500 The service name of the service instance.
505 501 .RE
506 502
507 503 .sp
508 504 .ne 2
509 505 .na
510 506 \fB\fBSTA\fR\fR
511 507 .ad
512 508 .RS 10n
513 509 The abbreviated state of the service instance (see \fBsmf\fR(5)):
514 510 .sp
515 511 .ne 2
516 512 .na
517 513 \fB\fBDGD\fR\fR
518 514 .ad
519 515 .RS 7n
520 516 degraded
521 517 .RE
522 518
523 519 .sp
524 520 .ne 2
525 521 .na
526 522 \fB\fBDIS\fR\fR
527 523 .ad
528 524 .RS 7n
529 525 disabled
530 526 .RE
531 527
532 528 .sp
533 529 .ne 2
534 530 .na
535 531 \fB\fBLRC\fR\fR
536 532 .ad
537 533 .RS 7n
538 534 legacy \fBrc*.d\fR script-initiated instance
539 535 .RE
540 536
541 537 .sp
542 538 .ne 2
543 539 .na
544 540 \fB\fBMNT\fR\fR
545 541 .ad
546 542 .RS 7n
547 543 maintenance
548 544 .RE
549 545
550 546 .sp
551 547 .ne 2
552 548 .na
553 549 \fB\fBOFF\fR\fR
554 550 .ad
555 551 .RS 7n
556 552 offline
557 553 .RE
558 554
559 555 .sp
560 556 .ne 2
561 557 .na
562 558 \fB\fBON\fR\fR
563 559 .ad
564 560 .RS 7n
565 561 online
566 562 .RE
567 563
568 564 .sp
569 565 .ne 2
570 566 .na
571 567 \fB\fBUN\fR\fR
572 568 .ad
573 569 .RS 7n
574 570 uninitialized
575 571 .RE
576 572
577 573 Absent or unrecognized states are denoted by a question mark (\fB?\fR)
578 574 character. An asterisk (\fB*\fR) is appended for instances in transition,
579 575 unless the \fBNSTA\fR or \fBNSTATE\fR column is also being displayed.
580 576 .sp
581 577 See \fBsmf\fR(5) for an explanation of service states.
582 578 .RE
583 579
584 580 .sp
585 581 .ne 2
586 582 .na
587 583 \fB\fBSTATE\fR\fR
588 584 .ad
589 585 .RS 10n
590 586 The state of the service instance. An asterisk is appended for instances in
591 587 transition, unless the \fBNSTA\fR or \fBNSTATE\fR column is also being
592 588 displayed.
593 589 .sp
594 590 See \fBsmf\fR(5) for an explanation of service states.
595 591 .RE
596 592
597 593 .sp
598 594 .ne 2
599 595 .na
↓ open down ↓ |
164 lines elided |
↑ open up ↑ |
600 596 \fB\fBSTIME\fR\fR
601 597 .ad
602 598 .RS 10n
603 599 If the service instance entered the current state within the last 24 hours,
604 600 this column indicates the time that it did so. Otherwise, this column indicates
605 601 the date on which it did so, printed with underscores (\fB_\fR) in place of
606 602 blanks.
607 603 .RE
608 604
609 605 .SH EXAMPLES
610 -.LP
611 606 \fBExample 1 \fRDisplaying the Default Output
612 607 .sp
613 608 .LP
614 609 This example displays default output:
615 610
616 611 .sp
617 612 .in +2
618 613 .nf
619 614 example% svcs
620 615 STATE STIME FMRI
621 616 \&...
622 617 legacy_run 13:25:04 lrc:/etc/rc3_d/S42myscript
623 618 \&...
624 619 online 13:21:50 svc:/system/svc/restarter:default
625 620 \&...
626 621 online 13:25:03 svc:/milestone/multi-user:default
627 622 \&...
628 623 online 13:25:07 svc:/milestone/multi-user-server:default
629 624 \&...
630 625 .fi
631 626 .in -2
632 627 .sp
633 628
634 629 .LP
635 630 \fBExample 2 \fRListing All Local Instances
636 631 .sp
637 632 .LP
638 633 This example lists all local instances of the \fBservice1\fR service.
639 634
640 635 .sp
641 636 .in +2
642 637 .nf
643 638 example% svcs -o state,nstate,fmri service1
644 639 STATE NSTATE FMRI
645 640 online - svc:/service1:instance1
646 641 disabled - svc:/service1:instance2
647 642 .fi
648 643 .in -2
649 644 .sp
650 645
651 646 .LP
652 647 \fBExample 3 \fRListing Verbose Information
653 648 .sp
654 649 .LP
655 650 This example lists verbose information.
656 651
657 652 .sp
658 653 .in +2
659 654 .nf
660 655 example% svcs -v network/rpc/rstat:udp
661 656 STATE NSTATE STIME CTID FMRI
662 657 online - Aug_09 - svc:/network/rpc/rstat:udp
663 658 .fi
664 659 .in -2
665 660 .sp
666 661
667 662 .LP
668 663 \fBExample 4 \fRListing Detailed Information
669 664 .sp
670 665 .LP
671 666 This example lists detailed information about all instances of
672 667 \fBsystem/service3\fR. Additional fields can be displayed, as appropriate to
673 668 the managing restarter.
674 669
675 670 .sp
676 671 .in +2
677 672 .nf
678 673 example% svcs -l network/rpc/rstat:udp
679 674
680 675 fmri svc:/network/rpc/rstat:udp
681 676 enabled true
682 677 state online
683 678 next_state none
684 679 restarter svc:/network/inetd:default
685 680 contract_id
686 681 dependency require_all/error svc:/network/rpc/bind (online)
687 682 .fi
688 683 .in -2
689 684 .sp
690 685
691 686 .LP
692 687 \fBExample 5 \fRListing Processes
693 688 .sp
694 689 .in +2
695 690 .nf
696 691 example% svcs -p sendmail
697 692 STATE STIME FMRI
698 693 online 13:25:13 svc:/network/smtp:sendmail
699 694 13:25:15 100939 sendmail
700 695 13:25:15 100940 sendmail
701 696 .fi
702 697 .in -2
703 698 .sp
704 699
705 700 .LP
706 701 \fBExample 6 \fRExplaining Service States Using \fBsvcs\fR \fB-x\fR
707 702 .sp
708 703 .LP
709 704 (a) In this example, \fBsvcs\fR \fB-x\fR has identified that the print/server
710 705 service being disabled is the root cause of two services which are enabled but
711 706 not online. \fBsvcs\fR \fB-xv\fR shows that those services are
712 707 \fBprint/rfc1179\fR and \fBprint/ipp-listener\fR. This situation can be
713 708 rectified by either enabling \fBprint/server\fR or disabling \fBrfc1179\fR and
714 709 \fBipp-listener\fR.
715 710
716 711 .sp
717 712 .in +2
718 713 .nf
719 714 example% svcs -x
720 715 svc:/application/print/server:default (LP print server)
721 716 State: disabled since Mon Feb 13 17:56:21 2006
722 717 Reason: Disabled by an administrator.
723 718 See: http://illumos.org/msg/SMF-8000-05
724 719 See: lpsched(1M)
725 720 Impact: 2 dependent services are not running. (Use -v for list.)
726 721 .fi
727 722 .in -2
728 723 .sp
729 724
730 725 .sp
731 726 .LP
732 727 (b) In this example, NFS is not working:
733 728
734 729 .sp
735 730 .in +2
736 731 .nf
737 732 example$ svcs nfs/client
738 733 STATE STIME FMRI
739 734 offline 16:03:23 svc:/network/nfs/client:default
740 735 .fi
741 736 .in -2
742 737 .sp
743 738
744 739 .sp
745 740 .LP
746 741 (c) The following example shows that the problem is \fBnfs/status\fR.
747 742 \fBnfs/client\fR is waiting because it depends on \fBnfs/nlockmgr\fR, which
748 743 depends on \fBnfs/status\fR:
749 744
750 745 .sp
751 746 .in +2
752 747 .nf
753 748 example$ svcs -xv nfs/client
754 749 svc:/network/nfs/client:default (NFS client)
755 750 State: offline since Mon Feb 27 16:03:23 2006
756 751 Reason: Service svc:/network/nfs/status:default
757 752 is not running because a method failed repeatedly.
758 753 See: http://illumos.org/msg/SMF-8000-GE
759 754 Path: svc:/network/nfs/client:default
↓ open down ↓ |
139 lines elided |
↑ open up ↑ |
760 755 svc:/network/nfs/nlockmgr:default
761 756 svc:/network/nfs/status:default
762 757 See: man -M /usr/share/man -s 1M mount_nfs
763 758 See: /var/svc/log/network-nfs-client:default.log
764 759 Impact: This service is not running.
765 760 .fi
766 761 .in -2
767 762 .sp
768 763
769 764 .SH EXIT STATUS
770 -.sp
771 -.LP
772 765 The following exit values are returned:
773 766 .sp
774 767 .ne 2
775 768 .na
776 769 \fB\fB0\fR\fR
777 770 .ad
778 771 .RS 5n
779 772 Successful command invocation.
780 773 .RE
781 774
782 775 .sp
783 776 .ne 2
784 777 .na
785 778 \fB\fB1\fR\fR
786 779 .ad
787 780 .RS 5n
788 781 Fatal error.
789 782 .RE
790 783
↓ open down ↓ |
9 lines elided |
↑ open up ↑ |
791 784 .sp
792 785 .ne 2
793 786 .na
794 787 \fB\fB2\fR\fR
795 788 .ad
796 789 .RS 5n
797 790 Invalid command line options were specified.
798 791 .RE
799 792
800 793 .SH ATTRIBUTES
801 -.sp
802 -.LP
803 794 See \fBattributes\fR(5) for descriptions of the following attributes:
804 795 .sp
805 796
806 797 .sp
807 798 .TS
808 799 box;
809 800 c | c
810 801 l | l .
811 802 ATTRIBUTE TYPE ATTRIBUTE VALUE
812 803 _
813 804 Interface Stability See below.
814 805 .TE
815 806
816 807 .sp
817 808 .LP
818 809 Screen output is Uncommitted. The invocation is Committed.
819 810 .SH SEE ALSO
820 -.sp
821 -.LP
822 811 \fBps\fR(1), \fBsvcprop\fR(1), \fBsvcadm\fR(1M), \fBsvccfg\fR(1M),
823 812 \fBsvc.startd\fR(1M), \fBstat\fR(2), \fBlibscf\fR(3LIB), \fBattributes\fR(5),
824 813 \fBfnmatch\fR(5), \fBsmf\fR(5), \fBzones\fR(5)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX