Print this page
7711 SMF: Finish implementing support for degraded state

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man5/smf_method.5.man.txt
          +++ new/usr/src/man/man5/smf_method.5.man.txt
↓ open down ↓ 171 lines elided ↑ open up ↑
 172  172         service instance is ready to answer requests or is otherwise
 173  173         functional.
 174  174  
 175  175  
 176  176         The following exit status codes are defined in <libscf.h> and in the
 177  177         shell support file.
 178  178  
 179  179  
 180  180  
 181  181  
 182      -       SMF_EXIT_OK           0          Method exited,
 183      -                                        performing its
 184      -                                        operation
 185      -                                        successfully.
 186      -       SMF_EXIT_ERR_FATAL    95         Method failed
 187      -                                        fatally and is
 188      -                                        unrecoverable
 189      -                                        without
 190      -                                        administrative
 191      -                                        intervention.
 192      -       SMF_EXIT_ERR_CONFIG   96         Unrecoverable
 193      -                                        configuration
 194      -                                        error. A common
 195      -                                        condition that
 196      -                                        returns this exit
 197      -                                        status is the
 198      -                                        absence of required
 199      -                                        configuration files
 200      -                                        for an enabled
 201      -                                        service instance.
 202      -       SMF_EXIT_ERR_NOSMF    99         Method has been
 203      -                                        mistakenly invoked
 204      -                                        outside the smf(5)
 205      -                                        facility. Services
 206      -                                        that depend on
 207      -                                        smf(5) capabilities
 208      -                                        should exit with
 209      -                                        this status value.
 210      -       SMF_EXIT_ERR_PERM     100        Method requires a
 211      -                                        form of permission
 212      -                                        such as file
 213      -                                        access, privilege,
 214      -                                        authorization, or
 215      -                                        other credential
 216      -                                        that is not
 217      -                                        available when
 218      -                                        invoked.
 219      -       SMF_EXIT_ERR_OTHER    non-zero   Any non-zero exit
 220      -                                        status from a
 221      -                                        method is treated
 222      -                                        as an unknown
 223      -                                        error. A series of
 224      -                                        unknown errors can
 225      -                                        be diagnosed as a
 226      -                                        fault by the
 227      -                                        restarter or on
 228      -                                        behalf of the
 229      -                                        restarter.
      182 +       SMF_EXIT_OK            0          Method exited,
      183 +                                         performing its
      184 +                                         operation
      185 +                                         successfully.
      186 +       SMF_EXIT_ERR_FATAL     95         Method failed
      187 +                                         fatally and is
      188 +                                         unrecoverable
      189 +                                         without
      190 +                                         administrative
      191 +                                         intervention.
      192 +       SMF_EXIT_ERR_CONFIG    96         Unrecoverable
      193 +                                         configuration
      194 +                                         error. A common
      195 +                                         condition that
      196 +                                         returns this exit
      197 +                                         status is the
      198 +                                         absence of required
      199 +                                         configuration files
      200 +                                         for an enabled
      201 +                                         service instance.
      202 +       SMF_EXIT_MON_DEGRADE   97         Method encountered
      203 +                                         some problems and
      204 +                                         may not be fully
      205 +                                         functional.
      206 +       SMF_EXIT_ERR_NOSMF     99         Method has been
      207 +                                         mistakenly invoked
      208 +                                         outside the smf(5)
      209 +                                         facility. Services
      210 +                                         that depend on
      211 +                                         smf(5) capabilities
      212 +                                         should exit with
      213 +                                         this status value.
      214 +       SMF_EXIT_ERR_PERM      100        Method requires a
      215 +                                         form of permission
      216 +                                         such as file
      217 +                                         access, privilege,
      218 +                                         authorization, or
      219 +                                         other credential
      220 +                                         that is not
      221 +                                         available when
      222 +                                         invoked.
      223 +       SMF_EXIT_ERR_OTHER     non-zero   Any non-zero exit
      224 +                                         status from a
      225 +                                         method is treated
      226 +                                         as an unknown
      227 +                                         error. A series of
      228 +                                         unknown errors can
      229 +                                         be diagnosed as a
      230 +                                         fault by the
      231 +                                         restarter or on
      232 +                                         behalf of the
      233 +                                         restarter.
 230  234  
 231  235  
 232  236  
 233  237         Use of a precise exit code allows the responsible restarter to
 234  238         categorize an error response as likely to be intermittent and worth
 235  239         pursuing restart or permanent and request administrative intervention.
 236  240  
 237  241     Timeouts
 238  242         Each method can have an independent timeout, given in seconds. The
 239  243         choice of a particular timeout should be based on site expectations for
↓ open down ↓ 199 lines elided ↑ open up ↑
 439  443         The present version of smf(5) does not support multiple repositories.
 440  444  
 441  445  
 442  446         When a service is configured to be started as root but with privileges
 443  447         different from limit_privileges, the resulting process is privilege
 444  448         aware.  This can be surprising to developers who expect seteuid(<non-
 445  449         zero UID>) to reduce privileges to basic or less.
 446  450  
 447  451  
 448  452  
 449      -                                 June 6, 2016                    SMF_METHOD(5)
      453 +                               December 4, 2017                  SMF_METHOD(5)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX