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
↓ 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
↓ 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  
↓ 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
↓ 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
↓ 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
↓ 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
↓ 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  
↓ 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