SVCPROP(1) User Commands SVCPROP(1)
svcprop - retrieve values of service configuration properties
| -s snapshot
}... svcprop -w
] [-z zone
utility prints values of properties in the service
configuration repository. Properties are selected by -p
options and the
Without the -C
, or -s
accesses effective properties.
The effective properties of a service are its directly attached
properties. The effective properties of a service instance are the union
of properties in the composed view of its running
snapshot and the
properties in nonpersistent property groups in the composed view of the
instance's directly attached properties. See smf(5)
for an explanation of
property composition. If the running
snapshot does not exist then the
instance's directly attached properties are used instead.
By default, when a single property is selected, the values for each are
printed on separate lines. Empty ASCII
string values are represented by a
pair of double quotes (""
). Bourne shell metacharacters (';
', newline, space, tab, backslash, '"
') in ASCII
string values are quoted by backslashes (\
When multiple properties are selected, a single line is printed for each.
Each line comprises a property designator, a property type, and the
values (as described above), separated by spaces. By default, if a single FMRI
operand has been supplied, the property designator consists of the
property group name and the property name joined by a slash (/
operands are supplied, the designator is the canonical FMRI
for the property.
If access controls prohibit reading the value of a property, and no
property or property group is specified explicitly by a -p
property is displayed as if it had no values. If one or more property or
property group names is specified by a -p
option, and any property value
cannot be read due to access controls, an error results.
Error messages are printed to the standard error stream.
The following options are supported: -C
Uses the directly attached properties, without composition. -c
For service instances, uses the composed view of their
directly attached properties. -f
Selects the multi-property output format, with full FMRIs
as designators. -p name
For each service or service instance specified by the
operands, selects all properties in the name
group. For property groups specified by the operands,
selects the name
property. -p pg
Selects property prop
in property group pg
for each of the
services or service instances specified by the operands. -q
Quiet. Produces no output. -s name
Uses the composed view of the name
snapshot for service
Selects the multi-property output format. -v
Verbose. Prints error messages for nonexistent properties,
even if option -q is also used. -w
Waits until the specified property group or the property
group containing the specified property changes before
This option is only valid when a single entity is
specified. If more than one operand is specified, or an
operand matches more than one instance, an error message is
printed and no action is taken. The -C option is implied. -z zone
Uses properties from the service or instance in the
. This option is only applicable from the
global zone, see zones(5)
The following operands are supported: FMRI
The FMRI of a service, a service instance, a property group,
or a property.
Instances and services can be abbreviated by specifying the
instance name, or the trailing portion of the service name.
Properties and property groups must be specified by a full
FMRI. For example, given the FMRI:
The following are valid abbreviations:
The following are invalid abbreviations:
Abbreviated forms of FMRIs are unstable and should not be used
in scripts or other permanent tools. If an abbreviation
matches multiple instances, svcprop
acts on each instance. pattern
A glob pattern which is matched against the FMRIs of services
and instances in the repository. See fnmatch(5)
. If a pattern
matches multiple services or instances, svcprop
acts on each
service or instance.
Example 1: Displaying the Value of a Single Property
The following example displays the value of the state property in the
restarter property group of instance default
of service system/cron
example% svcprop -p restarter/state system/cron:default
Example 2: Retrieving Whether a Service is Enabled
Whether a service is enabled is determined by its -general/enabled
property. This property takes immediate effect, so the -c
option must be
example% svcprop -c -p general/enabled system/cron:default
Example 3: Displaying All Properties in a Property Group
On a default installation of Solaris, the following example displays all
properties in the general
property group of each instance of the network/ntp
example% svcprop -p general ntp
general/package astring SUNWntpr
general/enabled boolean true
general/entity_stability astring Unstable
Example 4: Testing the Existence of a Property
The following example tests the existence of the general/enabled
for all instances of service identity:
example% svcprop -q -p general/enabled identity:
example% echo $?
Example 5: Waiting for Property Change
The following example waits for the sendmail
instance to change state.
example% svcprop -w -p restarter/state sendmail
Example 6: Retrieving the Value of a Boolean Property in a Script
The following example retrieves the value of a boolean property in a
set -- `svcprop -c -t -p general/enabled service`
if [ $code -ne 0 ]; then
echo "svcprop failed with exit code $code"
if [ $2 != boolean ]; then
echo "general/enabled has unexpected type $2"
if [ $# -ne 3 ]; then
echo "general/enabled has wrong number of values"
Example 7: Using svcprop in a Script
example% cat getval
svcprop -p $1 $2 | (
read value v2
if [ -n "$v2" ]; then echo "Multiple values!"; exit; fi
The following exit values are returned: 0
Successful completion. 1
An error occurred. 2
Invalid command line options were specified.
SEE ALSO svcs(1)
December 11, 2019 SVCPROP(1)