Print this page
12071 clarify implementation of single_instance in SMF services
Reviewed by: Robert Mustacchi <rm@fingolfin.org>

@@ -1,15 +1,15 @@
 '\" te
 .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
+.\" Copyright 2019 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 SVCPROP 1 "April 9, 2016"
+.TH SVCPROP 1 "Dec 11, 2019"
 .SH NAME
 svcprop \- retrieve values of service configuration properties
 .SH SYNOPSIS
-.LP
 .nf
 \fBsvcprop\fR [\fB-fqtv\fR] [\fB-C\fR | \fB-c\fR | \fB-s\fR \fIsnapshot\fR]
      [\fB-z\fR \fIzone\fR] [\fB-p\fR [\fIname\fR/]\fIname\fR]...
      {\fIFMRI\fR | \fIpattern\fR}...
 .fi

@@ -18,11 +18,10 @@
 .nf
 \fBsvcprop\fR \fB-w\fR [\fB-fqtv\fR] [\fB-z\fR \fIzone\fR] [\fB-p\fR [\fIname\fR/]\fIname\fR] {\fIFMRI\fR | \fIpattern\fR}
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBsvcprop\fR utility prints values of properties in the service
 configuration repository. Properties are selected by \fB-p\fR options and the
 operands.
 .sp
 .LP

@@ -33,11 +32,10 @@
 properties in nonpersistent property groups in the composed view of the
 instance's directly attached properties. See \fBsmf\fR(5) for an explanation of
 property composition. If the \fBrunning\fR snapshot does not exist then the
 instance's directly attached properties are used instead.
 .SS "Output Format"
-.LP
 By default, when a single property is selected, the values for each are printed
 on separate lines. Empty \fBASCII\fR string values are represented by a pair of
 double quotes (\fB""\fR). Bourne shell metacharacters ('\fB;\fR', '\fB&\fR\&',
 \&'\fB(\fR', '\fB)\fR', '\fB|\fR', '\fB^\fR', '\fB<\fR\&', '\fB>\fR', newline,
 space, tab, backslash, '\fB"\fR', single-quote, '\fB`\fR') in \fBASCII\fR

@@ -60,11 +58,10 @@
 due to access controls, an error results.
 .sp
 .LP
 Error messages are printed to the standard error stream.
 .SH OPTIONS
-.LP
 The following options are supported:
 .sp
 .ne 2
 .na
 \fB\fB-C\fR\fR

@@ -172,11 +169,10 @@
 .RS 14n
 Uses properties from the service or instance in the specified \fIzone\fR.
 This option is only applicable from the global zone, see \fBzones\fR(5).
 
 .SH OPERANDS
-.LP
 The following operands are supported:
 .sp
 .ne 2
 .na
 \fB\fIFMRI\fR\fR

@@ -234,11 +230,10 @@
 the repository. See \fBfnmatch\fR(5). If a pattern matches multiple services or
 instances, \fBsvcprop\fR acts on each service or instance.
 .RE
 
 .SH EXAMPLES
-.LP
 \fBExample 1 \fRDisplaying the Value of a Single Property
 .sp
 .LP
 The following example displays the value of the state property in the restarter
 property group of instance \fBdefault\fR of service \fBsystem/cron\fR.

@@ -282,11 +277,10 @@
 .nf
 example% svcprop -p general ntp
 general/package astring SUNWntpr
 general/enabled boolean true
 general/entity_stability astring Unstable
-general/single_instance boolean true
 .fi
 .in -2
 .sp
 
 .LP

@@ -365,11 +359,10 @@
 .fi
 .in -2
 .sp
 
 .SH EXIT STATUS
-.LP
 The following exit values are returned:
 .sp
 .ne 2
 .na
 \fB\fB0\fR\fR

@@ -395,10 +388,9 @@
 .RS 5n
 Invalid command line options were specified.
 .RE
 
 .SH SEE ALSO
-.LP
 \fBsvcs\fR(1), \fBinetd\fR(1M), \fBsvcadm\fR(1M), \fBsvccfg\fR(1M),
 \fBsvc.startd\fR(1M), \fBservice_bundle\fR(4), \fBattributes\fR(5),
 \fBfnmatch\fR(5), \fBsmf\fR(5), \fBsmf_method\fR(5), \fBsmf_security\fR(5),
 \fBzones\fR(5)