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


  23        general property group. This group includes the following required and
  24        optional property settings.
  25 
  26        enabled
  27                           This is a required property. If set, the restarter
  28                           of an instance attempts to maintain availability of
  29                           the service.
  30 
  31 
  32        restarter
  33                           This is an optional property that allows the
  34                           specification of an alternate restarter to manage
  35                           the service instance. If the restarter property is
  36                           empty or absent, the restarter defaults to
  37                           svc.startd(1M).
  38 
  39 
  40        single_instance
  41                           This is an optional property. When set, only one
  42                           instance of the service is allowed to transition to
  43                           an online or degraded status at any time.


  44 
  45 
  46    Service Reporting
  47        All restarters report status using the restarter property group, which
  48        includes the following properties:
  49 
  50        next_state
  51                           The current state and next state, if currently in
  52                           transition, for instances stored in these
  53                           properties. See smf(5) for a description of the
  54                           potential states.
  55 
  56 
  57        auxiliary_state
  58                           An astring with no spaces that contains a precise
  59                           term to describe the full restarter-specific state
  60                           in combination with the restarter state property.
  61                           The auxiliary state cannot always be set and is
  62                           always cleared during transition out of any state.
  63                           Each restarter must define the precise list of
  64                           auxiliary states it uses.
  65 
  66 
  67        state_timestamp
  68                           The time when the current state was reached.
  69 
  70 
  71        contract
  72                           The primary process contract ID, if any, under which
  73                           the service instance is executing.
  74 
  75 
  76 SEE ALSO
  77        svcs(1), svc.startd(1M), service_bundle(4), smf(5), smf_method(5)
  78 
  79 
  80 
  81                                  May 23, 2008                 SMF_RESTARTER(5)


  23        general property group. This group includes the following required and
  24        optional property settings.
  25 
  26        enabled
  27                           This is a required property. If set, the restarter
  28                           of an instance attempts to maintain availability of
  29                           the service.
  30 
  31 
  32        restarter
  33                           This is an optional property that allows the
  34                           specification of an alternate restarter to manage
  35                           the service instance. If the restarter property is
  36                           empty or absent, the restarter defaults to
  37                           svc.startd(1M).
  38 
  39 
  40        single_instance
  41                           This is an optional property. When set, only one
  42                           instance of the service is allowed to transition to
  43                           an online or degraded status at any time. Note that
  44                           no known implementation honours this setting, and it
  45                           should be considered obsolete.
  46 
  47 
  48    Service Reporting
  49        All restarters report status using the restarter property group, which
  50        includes the following properties:
  51 
  52        next_state
  53                           The current state and next state, if currently in
  54                           transition, for instances stored in these
  55                           properties. See smf(5) for a description of the
  56                           potential states.
  57 
  58 
  59        auxiliary_state
  60                           An astring with no spaces that contains a precise
  61                           term to describe the full restarter-specific state
  62                           in combination with the restarter state property.
  63                           The auxiliary state cannot always be set and is
  64                           always cleared during transition out of any state.
  65                           Each restarter must define the precise list of
  66                           auxiliary states it uses.
  67 
  68 
  69        state_timestamp
  70                           The time when the current state was reached.
  71 
  72 
  73        contract
  74                           The primary process contract ID, if any, under which
  75                           the service instance is executing.
  76 
  77 
  78 SEE ALSO
  79        svcs(1), svc.startd(1M), service_bundle(4), smf(5), smf_method(5)
  80 
  81 
  82 
  83                                December 11, 2019              SMF_RESTARTER(5)