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

*** 1,15 ****
  '\" te
  .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
  .\" 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"
  .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
--- 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 "Dec 11, 2019"
  .SH NAME
  svcprop \- retrieve values of service configuration properties
  .SH SYNOPSIS
  .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,28 ****
  .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
--- 18,27 ----
*** 33,43 ****
  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
--- 32,41 ----
*** 60,70 ****
  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
--- 58,67 ----
*** 172,182 ****
  .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
--- 169,178 ----
*** 234,244 ****
  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.
--- 230,239 ----
*** 282,292 ****
  .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
--- 277,286 ----
*** 365,375 ****
  .fi
  .in -2
  .sp
  
  .SH EXIT STATUS
- .LP
  The following exit values are returned:
  .sp
  .ne 2
  .na
  \fB\fB0\fR\fR
--- 359,368 ----
*** 395,404 ****
  .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)
--- 388,396 ----