svcprop man page on SmartOS

Printed from http://www.polarhome.com/service/man/?qf=svcprop&af=0&tf=2&of=SmartOS

SVCPROP(1)							    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 configu‐
       ration repository. Properties are selected by -p options and the	 oper‐
       ands.

       Without	the  -C, -c, or -s options, svcprop accesses effective proper‐
       ties. 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 explana‐
       tion  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, '"', sin‐
       gle-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  composi‐
		     tion.

       -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 op‐
		     erands, 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 oper‐
		     ands.

       -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 proper‐
		     ties, 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	speci‐
		     fied.  If more than one operand is specified, or an oper‐
		     and 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 spec‐
		     ified zone.  This option  is  only	 applicable  from  the
		     global zone, see zones(5).

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:

		    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 ser‐
		  vices and instances in the repository. See fnmatch(5). 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
	 general/single_instance boolean true

       Example 4 Testing the Existance of a Property

       The  following example tests the existence of the general/enabled prop‐
       erty 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),	  inetd(1M),   svcadm(1M),  svccfg(1M),	 svc.startd(1M),  ser‐
       vice_bundle(4),	attributes(5),	fnmatch(5),   smf(5),	smf_method(5),
       smf_security(5), zones(5)

				 Sep 13, 2007			    SVCPROP(1)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net