Print this page
12071 clarify implementation of single_instance in SMF services
Reviewed by: Robert Mustacchi <rm@fingolfin.org>
   1 <?xml version="1.0"?>
   2 <!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
   3 <!--
   4  Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
   5  Copyright 2016 Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org>

   6 
   7  CDDL HEADER START
   8 
   9  The contents of this file are subject to the terms of the
  10  Common Development and Distribution License (the "License").
  11  You may not use this file except in compliance with the License.
  12 
  13  You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  14  or http://www.opensolaris.org/os/licensing.
  15  See the License for the specific language governing permissions
  16  and limitations under the License.
  17 
  18  When distributing Covered Code, include this CDDL HEADER in each
  19  file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  20  If applicable, add the following below this CDDL HEADER, with the
  21  fields enclosed by brackets "[]" replaced with your own identifying
  22  information: Portions Copyright [yyyy] [name of copyright owner]
  23 
  24  CDDL HEADER END
  25 


  85                                 <description>
  86                                         <loctext xml:lang='C'>
  87 The service instance is expected to be started once all of its dependencies are satisfied.  If this property is not defined, the restarter will not be notified about this service instance.
  88                                         </loctext>
  89                                 </description>
  90                                 <cardinality min='1' max='1'/>
  91                         </prop_pattern>
  92                         <prop_pattern name='restarter' type='fmri'
  93                             required='false'>
  94                                 <description>
  95                                         <loctext xml:lang='C'>
  96 The restarter responsible for managing this service instance.  If the property is unset, the default restarter, svc.startd, is assumed.
  97                                         </loctext>
  98                                 </description>
  99                                 <cardinality min='1' max='1'/>
 100                         </prop_pattern>
 101                         <prop_pattern name='single_instance' type='boolean'
 102                             required='false'>
 103                                 <description>
 104                                         <loctext xml:lang='C'>
 105 Only one instance of this service may be run.  This property is currently unenforced, but will be at some point in the future.
 106                                         </loctext>
 107                                 </description>
 108                                 <cardinality min='1' max='1'/>
 109                         </prop_pattern>
 110                 </pg_pattern>
 111 
 112                 <pg_pattern type='dependency' target='all' required='false'>
 113                         <description>
 114                                 <loctext xml:lang='C'>
 115 A dependency declares a required condition for a service instance to start or stay running.  It is defined by the service author and consumed by SMF.
 116                                 </loctext>
 117                         </description>
 118                         <prop_pattern name='entities' type='fmri'
 119                             required='true'>
 120                                 <description>
 121                                         <loctext xml:lang='C'>
 122 The services, service instances, or files used to calculate this dependency.
 123                                         </loctext>
 124                                 </description>
 125                                 <cardinality min='1'/>


   1 <?xml version="1.0"?>
   2 <!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
   3 <!--
   4  Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
   5  Copyright 2016 Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org>
   6  Copyright 2019 Joyent, Inc.
   7 
   8  CDDL HEADER START
   9 
  10  The contents of this file are subject to the terms of the
  11  Common Development and Distribution License (the "License").
  12  You may not use this file except in compliance with the License.
  13 
  14  You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  15  or http://www.opensolaris.org/os/licensing.
  16  See the License for the specific language governing permissions
  17  and limitations under the License.
  18 
  19  When distributing Covered Code, include this CDDL HEADER in each
  20  file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  21  If applicable, add the following below this CDDL HEADER, with the
  22  fields enclosed by brackets "[]" replaced with your own identifying
  23  information: Portions Copyright [yyyy] [name of copyright owner]
  24 
  25  CDDL HEADER END
  26 


  86                                 <description>
  87                                         <loctext xml:lang='C'>
  88 The service instance is expected to be started once all of its dependencies are satisfied.  If this property is not defined, the restarter will not be notified about this service instance.
  89                                         </loctext>
  90                                 </description>
  91                                 <cardinality min='1' max='1'/>
  92                         </prop_pattern>
  93                         <prop_pattern name='restarter' type='fmri'
  94                             required='false'>
  95                                 <description>
  96                                         <loctext xml:lang='C'>
  97 The restarter responsible for managing this service instance.  If the property is unset, the default restarter, svc.startd, is assumed.
  98                                         </loctext>
  99                                 </description>
 100                                 <cardinality min='1' max='1'/>
 101                         </prop_pattern>
 102                         <prop_pattern name='single_instance' type='boolean'
 103                             required='false'>
 104                                 <description>
 105                                         <loctext xml:lang='C'>
 106 Only one instance of this service may be run.  This behavior is unimplemented, and obsolete.
 107                                         </loctext>
 108                                 </description>
 109                                 <cardinality min='1' max='1'/>
 110                         </prop_pattern>
 111                 </pg_pattern>
 112 
 113                 <pg_pattern type='dependency' target='all' required='false'>
 114                         <description>
 115                                 <loctext xml:lang='C'>
 116 A dependency declares a required condition for a service instance to start or stay running.  It is defined by the service author and consumed by SMF.
 117                                 </loctext>
 118                         </description>
 119                         <prop_pattern name='entities' type='fmri'
 120                             required='true'>
 121                                 <description>
 122                                         <loctext xml:lang='C'>
 123 The services, service instances, or files used to calculate this dependency.
 124                                         </loctext>
 125                                 </description>
 126                                 <cardinality min='1'/>