Print this page
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 ----