Print this page
12721 would like svcadm disable -c
@@ -1,15 +1,15 @@
'\" te
.\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
+.\" Copyright 2020 Joyent, Inc.
.\" 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.
.\" 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.
.\" 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]
-.TH SVCS 1 "Apr 17, 2011"
+.TH SVCS 1 "May 11, 2020"
.SH NAME
svcs \- report service status
.SH SYNOPSIS
-.LP
.nf
\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]...
[\fB-sS\fR \fIcol\fR]... [\fIFMRI\fR | \fIpattern\fR]...
.fi
@@ -28,12 +28,10 @@
.nf
\fBsvcs\fR \fB-x\fR [\fB-v\fR] [\fB-Z\fR | \fB-z\fR \fIzone\fR] [\fIFMRI\fR]...
.fi
.SH DESCRIPTION
-.sp
-.LP
The \fBsvcs\fR command displays information about service instances as recorded
in the service configuration repository.
.sp
.LP
The first form of this command prints one-line status listings for service
@@ -60,12 +58,10 @@
.sp
.LP
The output of this command can be used appropriately as input to the
\fBsvcadm\fR(1M) command.
.SH OPTIONS
-.sp
-.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-?\fR\fR
@@ -210,10 +206,14 @@
\fB(temporary)\fR.
.sp
A service might be temporarily disabled because an administrator has run
\fBsvcadm disable -t\fR, used \fBsvcadm milestone\fR, or booted the system to a
specific milestone. See \fBsvcadm\fR(1M) for details.
+.sp
+If a service instance was disabled via
+\fBsvcadm disable -c\fR
+, then the provided comment will also be displayed.
.RE
.RE
.sp
@@ -335,12 +335,10 @@
zone the service is running. This option is only applicable in the global
zone, see \fBzones\fR(5).
.RE
.SH OPERANDS
-.sp
-.LP
The following operands are supported:
.sp
.ne 2
.na
\fB\fIFMRI\fR\fR
@@ -419,12 +417,10 @@
.RS 17n
An FMRI that specifies an instance.
.RE
.SH COLUMNS
-.sp
-.LP
Column names are case insensitive. The default output format is equivalent to
"\fB-o\fR \fBstate,stime,fmri\fR". The default sorting columns are \fBSTATE\fR,
\fBSTIME\fR, \fBFMRI\fR.
.sp
.ne 2
@@ -605,11 +601,10 @@
the date on which it did so, printed with underscores (\fB_\fR) in place of
blanks.
.RE
.SH EXAMPLES
-.LP
\fBExample 1 \fRDisplaying the Default Output
.sp
.LP
This example displays default output:
@@ -765,12 +760,10 @@
.fi
.in -2
.sp
.SH EXIT STATUS
-.sp
-.LP
The following exit values are returned:
.sp
.ne 2
.na
\fB\fB0\fR\fR
@@ -796,12 +789,10 @@
.RS 5n
Invalid command line options were specified.
.RE
.SH ATTRIBUTES
-.sp
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
@@ -815,10 +806,8 @@
.sp
.LP
Screen output is Uncommitted. The invocation is Committed.
.SH SEE ALSO
-.sp
-.LP
\fBps\fR(1), \fBsvcprop\fR(1), \fBsvcadm\fR(1M), \fBsvccfg\fR(1M),
\fBsvc.startd\fR(1M), \fBstat\fR(2), \fBlibscf\fR(3LIB), \fBattributes\fR(5),
\fBfnmatch\fR(5), \fBsmf\fR(5), \fBzones\fR(5)