SVCPROP(1) User Commands SVCPROP(1)
svcprop - retrieve values of service configuration properties
svcprop [-fqtv] [-C | -c | -s snapshot]
[-z zone] [-p [name/]name]...
{FMRI | pattern}...
svcprop -w [-fqtv] [-z zone] [-p [name/]name] {FMRI | pattern}
The svcprop utility prints values of properties in the service
configuration repository. Properties are selected by -p options and
the operands.
Without the -C, -c, or -s options, svcprop 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(7) 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, '"', single-quote, '`') 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 (/). If multiple FMRI 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 option,
the 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 property
group. For property groups specified by the operands,
selects the name property.
-p pg/prop
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
instances.
-t
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 printing.
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
specified zone. This option is only applicable from
the global zone, see zones(7).
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:
svc:/network/smtp:sendmail
The following are valid abbreviations:
sendmail
:sendmail
smtp
smtp:sendmail
network/smtp
The following are invalid abbreviations:
mail
network
network/smt
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(7).
If a pattern matches multiple services or instances,
svcprop acts on each service or instance.
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
online
Whether a service is enabled is determined by its -general/enabled
property. This property takes immediate effect, so the -c option must
be used:
example% svcprop -c -p general/enabled system/cron:default
true
On a default installation of Solaris, the following example displays
all properties in the general property group of each instance of the
network/ntp service:
example% svcprop -p general ntp
general/package astring SUNWntpr
general/enabled boolean true
general/entity_stability astring Unstable
The following example tests the existence of the general/enabled
property for all instances of service identity:
example% svcprop -q -p general/enabled identity:
example% echo $?
0
The following example waits for the sendmail instance to change
state.
example% svcprop -w -p restarter/state sendmail
The following example retrieves the value of a boolean property in a
script:
set -- `svcprop -c -t -p general/enabled service`
code=$?
if [ $code -ne 0 ]; then
echo "svcprop failed with exit code $code"
return 1
fi
if [ $2 != boolean ]; then
echo "general/enabled has unexpected type $2"
return 2
fi
if [ $# -ne 3 ]; then
echo "general/enabled has wrong number of values"
return 3
fi
value=$3
...
example% cat getval
#!/bin/sh
svcprop -p $1 $2 | (
read value v2
if [ -n "$v2" ]; then echo "Multiple values!"; exit; fi
echo $value
)
The following exit values are returned:
0
Successful completion.
1
An error occurred.
2
Invalid command line options were specified.
svcs(1), service_bundle(5), attributes(7), fnmatch(7), smf(7),
smf_method(7), smf_security(7), zones(7), inetd(8), svc.startd(8),
svcadm(8), svccfg(8)
December 11, 2019 SVCPROP(1)
NAME
svcprop - retrieve values of service configuration properties
SYNOPSIS
svcprop [-fqtv] [-C | -c | -s snapshot]
[-z zone] [-p [name/]name]...
{FMRI | pattern}...
svcprop -w [-fqtv] [-z zone] [-p [name/]name] {FMRI | pattern}
DESCRIPTION
The svcprop utility prints values of properties in the service
configuration repository. Properties are selected by -p options and
the operands.
Without the -C, -c, or -s options, svcprop 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(7) for an explanation of property composition. If the running
snapshot does not exist then the instance's directly attached
properties are used instead.
Output Format
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, '"', single-quote, '`') 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 (/). If multiple FMRI 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 option,
the 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.
OPTIONS
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 property
group. For property groups specified by the operands,
selects the name property.
-p pg/prop
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
instances.
-t
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 printing.
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
specified zone. This option is only applicable from
the global zone, see zones(7).
OPERANDS
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:
svc:/network/smtp:sendmail
The following are valid abbreviations:
sendmail
:sendmail
smtp
smtp:sendmail
network/smtp
The following are invalid abbreviations:
network
network/smt
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(7).
If a pattern matches multiple services or instances,
svcprop acts on each service or instance.
EXAMPLES
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
online
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 used:
example% svcprop -c -p general/enabled system/cron:default
true
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 service:
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
property for all instances of service identity:
example% svcprop -q -p general/enabled identity:
example% echo $?
0
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
script:
set -- `svcprop -c -t -p general/enabled service`
code=$?
if [ $code -ne 0 ]; then
echo "svcprop failed with exit code $code"
return 1
fi
if [ $2 != boolean ]; then
echo "general/enabled has unexpected type $2"
return 2
fi
if [ $# -ne 3 ]; then
echo "general/enabled has wrong number of values"
return 3
fi
value=$3
...
Example 7: Using svcprop in a Script
example% cat getval
#!/bin/sh
svcprop -p $1 $2 | (
read value v2
if [ -n "$v2" ]; then echo "Multiple values!"; exit; fi
echo $value
)
EXIT STATUS
The following exit values are returned:
0
Successful completion.
1
An error occurred.
2
Invalid command line options were specified.
SEE ALSO
svcs(1), service_bundle(5), attributes(7), fnmatch(7), smf(7),
smf_method(7), smf_security(7), zones(7), inetd(8), svc.startd(8),
svcadm(8), svccfg(8)
December 11, 2019 SVCPROP(1)