1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
4
5 CDDL HEADER START
6
7 The contents of this file are subject to the terms of the
8 Common Development and Distribution License (the "License").
9 You may not use this file except in compliance with the License.
10
11 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
12 or http://www.opensolaris.org/os/licensing.
13 See the License for the specific language governing permissions
14 and limitations under the License.
15
16 When distributing Covered Code, include this CDDL HEADER in each
17 file and include the License file at usr/src/OPENSOLARIS.LICENSE.
18 If applicable, add the following below this CDDL HEADER, with the
19 fields enclosed by brackets "[]" replaced with your own identifying
20 information: Portions Copyright [yyyy] [name of copyright owner]
21
22 CDDL HEADER END
23-->
24
25<!--
26  Service description DTD
27
28    Most attributes are string values (or an individual string from a
29    restricted set), but attributes with a specific type requirement are
30    noted in the comment describing the element.
31-->
32
33<!--
34  XInclude support
35
36    A series of service bundles may be composed via the xi:include tag.
37    smf(5) tools enforce that all bundles be of the same type.
38-->
39
40<!--
41     These entities are used for the property, propval and property_group
42     elements, that require type attributes for manifest, while for profiles
43     the type attributes are only implied.
44-->
45
46<!ENTITY % profile "IGNORE">
47<!ENTITY % manifest "INCLUDE">
48
49<!ELEMENT xi:include
50  (xi:fallback)
51  >
52<!ATTLIST xi:include
53  href CDATA #REQUIRED
54  parse (xml|text) "xml"
55  encoding CDATA #IMPLIED
56  xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude"
57  >
58
59<!ELEMENT xi:fallback
60  ANY
61  >
62<!ATTLIST xi:fallback
63  xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude"
64  >
65
66<!--
67  stability
68
69    This element associates an SMI stability level with the parent
70    element.  See attributes(5) for an explanation of interface
71    stability levels.
72
73    Its attribute is
74
75	value	The stability level of the parent element.
76-->
77
78<!ELEMENT stability EMPTY>
79
80<!ATTLIST stability
81	value		( Standard | Stable | Evolving | Unstable |
82			External | Obsolete ) #REQUIRED >
83
84<!-- Property value lists -->
85
86<!--
87  value_node
88
89    This element represents a single value within any of the typed
90    property value lists.
91
92    Its attribute is
93
94	value	The value for this node in the list.
95-->
96
97<!ELEMENT value_node EMPTY>
98
99<!ATTLIST value_node
100	value CDATA #REQUIRED>
101
102<!--
103  count_list
104  integer_list
105  opaque_list
106  host_list
107  hostname_list
108  net_address_list
109  net_address_v4_list
110  net_address_v6_list
111  time_list
112  astring_list
113  ustring_list
114  boolean_list
115  fmri_list
116  uri_list
117
118    These elements represent the typed lists of values for a property.
119    Each contains one or more value_node elements representing each
120    value on the list.
121
122    None of these elements has attributes.
123-->
124
125<!ELEMENT count_list
126	( value_node+ )>
127
128<!ATTLIST count_list>
129
130<!ELEMENT integer_list
131	( value_node+ )>
132
133<!ATTLIST integer_list>
134
135<!ELEMENT opaque_list
136	( value_node+ )>
137
138<!ATTLIST opaque_list>
139
140<!ELEMENT host_list
141	( value_node+ )>
142
143<!ATTLIST host_list>
144
145<!ELEMENT hostname_list
146	( value_node+ )>
147
148<!ATTLIST hostname_list>
149
150<!ELEMENT net_address_list
151	( value_node+ )>
152
153<!ATTLIST net_address_list>
154
155<!ELEMENT net_address_v4_list
156	( value_node+ )>
157
158<!ATTLIST net_address_v4_list>
159
160<!ELEMENT net_address_v6_list
161	( value_node+ )>
162
163<!ATTLIST net_address_v6_list>
164
165<!ELEMENT time_list
166	( value_node+ )>
167
168<!ATTLIST time_list>
169
170<!ELEMENT astring_list
171	( value_node+ )>
172
173<!ATTLIST astring_list>
174
175<!ELEMENT ustring_list
176	( value_node+ )>
177
178<!ATTLIST ustring_list>
179
180<!ELEMENT boolean_list
181	( value_node+ )>
182
183<!ATTLIST boolean_list>
184
185<!ELEMENT fmri_list
186	( value_node+ )>
187
188<!ATTLIST fmri_list>
189
190<!ELEMENT uri_list
191	( value_node+ )>
192
193<!ATTLIST uri_list>
194
195<!-- Properties and property groups -->
196
197<!--
198   property
199
200     This element is for a singly or multiply valued property within a
201     property group.  It contains an appropriate value list element,
202     which is expected to be consistent with the type attribute.
203
204     Its attributes are
205
206	name	The name of this property.
207
208	type	The data type for this property.
209
210	override These values should replace values already in the
211		repository.
212-->
213
214<![%profile;[
215<!ELEMENT property
216	( count_list | integer_list | opaque_list | host_list | hostname_list |
217	net_address_list | net_address_v4_list | net_address_v6_list |
218	time_list | astring_list | ustring_list | boolean_list | fmri_list |
219	uri_list )? >
220
221<!ATTLIST property
222	name		CDATA #REQUIRED
223	type		( count | integer | opaque | host | hostname |
224			net_address | net_address_v4 | net_address_v6 | time |
225			astring | ustring | boolean | fmri | uri ) #IMPLIED
226	override	( true | false ) "false" >
227]]>
228
229<![%manifest;[
230<!ELEMENT property
231	( count_list | integer_list | opaque_list | host_list | hostname_list |
232	net_address_list | net_address_v4_list | net_address_v6_list |
233	time_list | astring_list | ustring_list | boolean_list | fmri_list |
234	uri_list )? >
235
236<!ATTLIST property
237	name		CDATA #REQUIRED
238	type		( count | integer | opaque | host | hostname |
239			net_address | net_address_v4 | net_address_v6 | time |
240			astring | ustring | boolean | fmri | uri ) #REQUIRED
241	override	( true | false ) "false" >
242]]>
243
244<!--
245   propval
246
247     This element is for a singly valued property within a property
248     group.  List-valued properties must use the property element above.
249
250     Its attributes are
251
252	name	The name of this property.
253
254	type	The data type for this property.
255
256	value	The value for this property.  Must match type
257		restriction of type attribute.
258
259	override This value should replace any values already in the
260		repository.
261-->
262
263<![%profile;[
264<!ELEMENT propval EMPTY>
265
266<!ATTLIST propval
267	name		CDATA #REQUIRED
268	type		( count | integer | opaque | host | hostname |
269			net_address | net_address_v4 | net_address_v6 | time |
270			astring | ustring | boolean | fmri | uri ) #IMPLIED
271	value		CDATA #REQUIRED
272	override	( true | false ) "false" >
273]]>
274
275<![%manifest;[
276<!ELEMENT propval EMPTY>
277
278<!ATTLIST propval
279	name		CDATA #REQUIRED
280	type		( count | integer | opaque | host | hostname |
281			net_address | net_address_v4 | net_address_v6 | time |
282			astring | ustring | boolean | fmri | uri ) #REQUIRED
283	value		CDATA #REQUIRED
284	override	( true | false ) "false" >
285]]>
286
287<!--
288  property_group
289
290    This element is for a set of related properties on a service or
291    instance.  It contains an optional stability element, as well as
292    zero or more property-containing elements.
293
294    Its attributes are
295
296	name	The name of this property group.
297
298	type	A category for this property group.  Groups of type
299		"framework", "implementation" or "template" are primarily
300		of interest to the service management facility, while
301		groups of type "application" are expected to be only of
302		interest to the service to which this group is attached.
303		Other types may be introduced using the service symbol
304		namespace conventions.
305
306	delete	If in the repository, this property group should be removed.
307-->
308
309<![%profile;[
310<!ELEMENT property_group
311	( stability?, ( propval | property )* )>
312
313<!ATTLIST property_group
314	name		CDATA #REQUIRED
315	type		CDATA #IMPLIED
316	delete		( true | false ) "false" >
317]]>
318
319<![%manifest;[
320<!ELEMENT property_group
321	( stability?, ( propval | property )* )>
322
323<!ATTLIST property_group
324	name		CDATA #REQUIRED
325	type		CDATA #REQUIRED
326	delete		( true | false ) "false" >
327]]>
328
329<!--
330  service_fmri
331
332    This element defines a reference to a service FMRI (for either a
333    service or an instance).
334
335    Its attribute is
336
337	value	The FMRI.
338-->
339
340<!ELEMENT service_fmri EMPTY>
341
342<!ATTLIST service_fmri
343	value		CDATA #REQUIRED>
344
345<!-- Dependencies -->
346
347<!--
348  dependency
349
350    This element identifies a group of FMRIs upon which the service is
351    in some sense dependent.  Its interpretation is left to the
352    restarter to which a particular service instance is delegated.  It
353    contains a group of service FMRIs, as well as a block of properties.
354
355    Its attributes are
356
357	name	The name of this dependency.
358
359	grouping The relationship between the various FMRIs grouped
360		here; "require_all" of the FMRIs to be online, "require_any"
361		of the FMRIs to be online, or "exclude_all" of the FMRIs
362		from being online or in maintenance for the dependency to
363		be satisfied.  "optional_all" dependencies are satisfied
364		when all of the FMRIs are either online or unable to come
365		online (because they are disabled, misconfigured, or one
366		of their dependencies is unable to come online).
367
368	restart_on The type of events from the FMRIs that the service should
369		be restarted for.  "error" restarts the service if the
370		dependency is restarted due to hardware fault.  "restart"
371		restarts the service if the dependency is restarted for
372		any reason, including hardware fault.  "refresh" restarts
373		the service if the dependency is refreshed or restarted for
374		any reason.  "none" will never restart the service due to
375		dependency state changes.
376
377	type	The type of dependency: on another service ('service'), on
378		a filesystem path ('path'), or another dependency type.
379
380	delete	This dependency should be deleted.
381-->
382
383<!ELEMENT dependency
384	( service_fmri*, stability?, ( propval | property )* ) >
385
386<!ATTLIST dependency
387	name		CDATA #REQUIRED
388	grouping	( require_all | require_any | exclude_all |
389			optional_all ) #REQUIRED
390	restart_on	( error | restart | refresh | none ) #REQUIRED
391	type		CDATA #REQUIRED
392	delete		( true | false ) "false" >
393
394<!-- Dependents -->
395
396<!--
397  dependent
398
399    This element identifies a service which should depend on this service.  It
400    corresponds to a dependency in the named service.  The grouping and type
401    attributes of that dependency are implied to be "require_all" and
402    "service", respectively.
403
404    Its attributes are
405
406	name	The name of the dependency property group to create in the
407		dependent entity.
408
409	grouping The grouping relationship of the dependency property
410		group to create in the dependent entity.  See "grouping"
411		attribute on the dependency element.
412
413	restart_on The type of events from this service that the named service
414		should be restarted for.
415
416	delete	True if this dependent should be deleted.
417
418	override Whether to replace an existing dependent of the same name.
419
420-->
421
422<!ELEMENT dependent
423	( service_fmri, stability?, ( propval | property )* ) >
424
425<!ATTLIST dependent
426	name		CDATA #REQUIRED
427	grouping	( require_all | require_any | exclude_all |
428			optional_all) #REQUIRED
429	restart_on	( error | restart | refresh | none) #REQUIRED
430	delete		( true | false ) "false"
431	override	( true | false ) "false" >
432
433<!-- Method execution context, security profile, and credential definitions -->
434
435<!--
436  envvar
437
438    An environment variable. It has two attributes:
439
440	name	The name of the environment variable.
441	value	The value of the environment variable.
442-->
443
444<!ELEMENT envvar EMPTY>
445
446<!ATTLIST envvar
447	name		CDATA #REQUIRED
448	value		CDATA #REQUIRED >
449
450<!--
451  method_environment
452
453    This element defines the environment for a method. It has no
454    attributes, and one or more envvar child elements.
455-->
456
457<!ELEMENT method_environment (envvar+) >
458
459<!ATTLIST method_environment>
460
461<!--
462  method_profile
463
464    This element indicates which exec_attr(5) profile applies to the
465    method context being defined.
466
467    Its attribute is
468
469	name	The name of the profile.
470-->
471
472<!ELEMENT method_profile EMPTY>
473
474<!ATTLIST method_profile
475	name		CDATA #REQUIRED >
476
477<!--
478  method_credential
479
480    This element specifies credential attributes for the execution
481    method to use.
482
483    Its attributes are
484
485	user	The user ID, in numeric or text form.
486
487	group	The group ID, in numeric or text form.  If absent or
488		":default", the group associated with the user in the
489		passwd database.
490
491	supp_groups Supplementary group IDs to be associated with the
492		method, separated by commas or spaces.  If absent or
493		":default", initgroups(3C) will be used.
494
495	privileges An optional string specifying the privilege set.
496
497	limit_privileges An optional string specifying the limit
498		privilege set.
499-->
500
501<!ELEMENT method_credential EMPTY>
502
503<!ATTLIST method_credential
504	user		CDATA #REQUIRED
505	group		CDATA #IMPLIED
506	supp_groups	CDATA #IMPLIED
507	privileges	CDATA #IMPLIED
508	limit_privileges CDATA #IMPLIED >
509
510<!--
511  method_context
512
513    This element combines credential and resource management attributes
514    for execution methods.  It may contain a method_environment, or
515    a method_profile or method_credential element.
516
517    Its attributes are
518
519	working_directory The home directory to launch the method from.
520		":default" can be used as a token to indicate use of the
521		user specified by the credential or profile specified.
522
523	project	The project ID, in numeric or text form.  ":default" can
524		be used as a token to indicate use of the project
525		identified by getdefaultproj(3PROJECT) for the non-root
526		user specified by the credential or profile specified.
527		If the user is root, ":default" designates the project
528		the restarter is running in.
529
530	resource_pool The resource pool name to launch the method on.
531		":default" can be used as a token to indicate use of the
532		pool specified in the project(4) entry given in the
533		"project" attribute above.
534-->
535<!ELEMENT method_context
536	( (method_profile | method_credential)?, method_environment? ) >
537
538<!ATTLIST method_context
539	security_flags		CDATA #IMPLIED
540	working_directory	CDATA #IMPLIED
541	project			CDATA #IMPLIED
542	resource_pool		CDATA #IMPLIED >
543
544<!-- Restarter delegation, methods, and monitors -->
545
546<!--
547  exec_method
548
549    This element describes one of the methods used by the designated
550    restarter to act on the service instance.  Its interpretation is
551    left to the restarter to which a particular service instance is
552    delegated.  It contains a set of attributes, an optional method
553    context, and an optional stability element for the optional
554    properties that can be included.
555
556    Its attributes are
557
558	type	The type of method, either "method" or "monitor".
559
560	name	Name of this execution method.  The method names are
561		usually a defined interface of the restarter to which an
562		instance of this service is delegated.
563
564	exec	The string identifying the action to take.  For
565		svc.startd(1M), this is a string suitable to pass to
566		exec(2).
567
568	timeout_seconds [integer] Duration, in seconds, to wait for this
569		method to complete.  A '0' or '-1' denotes an infinite
570		timeout.
571
572	delete	If in the repository, the property group for this method
573		should be removed.
574-->
575
576<!ELEMENT exec_method
577	( method_context?, stability?, ( propval | property )* ) >
578
579<!ATTLIST exec_method
580	type		( method | monitor ) #REQUIRED
581	name		CDATA #REQUIRED
582	exec		CDATA #REQUIRED
583	timeout_seconds	CDATA #REQUIRED
584	delete		( true | false ) "false" >
585
586<!--
587  restarter
588
589    A flag element identifying the restarter to which this service or
590    service instance is delegated.  Contains the FMRI naming the
591    delegated restarter.
592
593    This element has no attributes.
594-->
595
596<!ELEMENT restarter
597	( service_fmri ) >
598
599<!ATTLIST restarter>
600
601<!--
602  Templates
603-->
604
605<!--
606  doc_link
607
608    The doc_link relates a resource described by the given URI to the
609    service described by the containing template.  The resource is
610    expected to be a documentation or elucidatory reference of some
611    kind.
612
613    Its attributes are
614
615      name      A label for this resource.
616
617      uri       A URI to the resource.
618-->
619
620<!ELEMENT doc_link EMPTY>
621
622<!ATTLIST doc_link
623	name		CDATA #REQUIRED
624	uri		CDATA #REQUIRED >
625
626<!--
627  manpage
628
629    The manpage element connects the reference manual page to the
630    template's service.
631
632    Its attributes are
633
634      title     The manual page title.
635
636      section   The manual page's section.
637
638      manpath   The MANPATH environment variable, as described in man(1)
639                that is required to reach the named manual page
640-->
641
642<!ELEMENT manpage EMPTY>
643
644<!ATTLIST manpage
645	title		CDATA #REQUIRED
646	section		CDATA #REQUIRED
647	manpath		CDATA ":default" >
648
649<!--
650  documentation
651
652    The documentation element groups an arbitrary number of doc_link
653    and manpage references.
654
655    It has no attributes.
656-->
657
658<!ELEMENT documentation
659	( doc_link | manpage )* >
660
661<!ATTLIST documentation>
662
663<!--
664  loctext
665
666    The loctext element is a container for localized text.
667
668    Its sole attribute is
669
670	xml:lang The name of the locale, in the form accepted by LC_ALL,
671		etc.  See locale(5).
672-->
673<!ELEMENT loctext
674        (#PCDATA) >
675
676<!ATTLIST loctext
677        xml:lang	CDATA #REQUIRED >
678
679<!--
680  description
681
682    The description holds a set of potentially longer, localized strings that
683    consist of a short description of the service.
684
685    The description has no attributes.
686-->
687<!ELEMENT description
688        ( loctext+ ) >
689
690<!ATTLIST description>
691
692<!--
693  common_name
694
695    The common_name holds a set of short, localized strings that
696    represent a well-known name for the service in the given locale.
697
698    The common_name has no attributes.
699-->
700<!ELEMENT common_name
701        ( loctext+ ) >
702
703<!ATTLIST common_name>
704
705<!--
706  units
707
708    The units a numerical property is expressed in.
709-->
710
711<!ELEMENT units
712	( loctext+ ) >
713
714<!ATTLIST units>
715
716<!--
717  visibility
718
719    Expresses how a property is typically accessed.  This isn't
720    intended as access control, but as an indicator as to how a
721    property is used.
722
723    Its attributes are:
724
725      value     'hidden', 'readonly', or 'readwrite' indicating that
726		the property should be hidden from the user, shown but
727		read-only, or modifiable.
728-->
729
730<!ELEMENT visibility EMPTY>
731
732<!ATTLIST visibility
733	value	( hidden | readonly | readwrite ) #REQUIRED >
734
735<!--
736  value
737
738    Describes a legal value for a property value, and optionally contains a
739    human-readable name and description for the specified property
740    value.
741
742    Its attributes are:
743
744      name	A string representation of the value.
745-->
746
747<!ELEMENT value
748	( common_name?, description? ) >
749
750<!ATTLIST value
751	name	CDATA #REQUIRED >
752
753<!--
754  values
755
756    Human-readable names and descriptions for valid values of a property.
757-->
758
759<!ELEMENT values
760	(value+) >
761
762<!ATTLIST values>
763
764<!--
765  cardinality
766
767    Places a constraint on the number of values the property can take
768    on.
769
770    Its attributes are:
771	min	minimum number of values
772	max	maximum number of values
773
774    Both attributes are optional.  If min is not specified, it defaults to
775    0.  If max is not specified it indicates an unlimited number of values.
776    If neither is specified this indicates 0 or more values.
777-->
778
779<!ELEMENT cardinality EMPTY>
780
781<!ATTLIST cardinality
782	min	CDATA "0"
783	max	CDATA "18446744073709551615">
784
785<!--
786  internal_separators
787
788    Indicates the separators used within a property's value used to
789    separate the actual values.  Used in situations where multiple
790    values are packed into a single property value instead of using a
791    multi-valued property.
792-->
793
794<!ELEMENT internal_separators
795	(#PCDATA) >
796
797<!ATTLIST internal_separators>
798
799<!--
800  range
801
802    Indicates a range of possible integer values.
803
804    Its attributes are:
805
806      min	The minimum value of the range (inclusive).
807      max	The maximum value of the range (inclusive).
808-->
809
810<!ELEMENT range EMPTY>
811
812<!ATTLIST range
813	min	CDATA #REQUIRED
814	max	CDATA #REQUIRED >
815
816<!--
817  constraints
818
819    Provides a set of constraints on the values a property can take on.
820-->
821
822<!ELEMENT constraints
823	( value*, range* ) >
824<!ATTLIST constraints>
825
826<!--
827  include_values
828
829    Includes an entire set of values in the choices block.
830
831    Its attributes are:
832
833	type    Either "constraints" or "values", indicating an
834		inclusion of all values allowed by the property's
835		constraints or all values for which there are
836		human-readable names and descriptions, respectively.
837-->
838
839<!ELEMENT include_values EMPTY>
840
841<!ATTLIST include_values
842	type	( constraints | values ) #REQUIRED >
843
844<!--
845  choices
846
847    Provides a set of common choices for the values a property can take
848    on.  Useful in those cases where the possibilities are unenumerable
849    or merely inconveniently legion, and a manageable subset is desired
850    for presentation in a user interface.
851-->
852
853<!ELEMENT choices
854	( value*, range*, include_values* ) >
855
856<!ATTLIST choices>
857
858<!--
859  prop_pattern
860
861
862    The prop_pattern describes one property of the enclosing property group
863    pattern.
864
865    Its attributes are:
866
867	name    The property's name.
868	type    The property's type.
869	required
870		If the property group is present, this property is required.
871
872	type can be omitted if required is false.
873-->
874
875<!ELEMENT prop_pattern
876	( common_name?, description?, units?, visibility?, cardinality?,
877	  internal_separators?, values?, constraints?, choices? ) >
878
879<!ATTLIST prop_pattern
880	name		CDATA	#REQUIRED
881	type		( count | integer | opaque | host | hostname |
882			net_address | net_address_v4 | net_address_v6 | time |
883			astring | ustring | boolean | fmri | uri ) #IMPLIED
884	required	( true | false )	"false" >
885
886<!--
887  pg_pattern
888
889    The pg_pattern describes one property group.
890    Depending on the element's attributes, these descriptions may apply
891    to just the enclosing service/instance, instances of the enclosing
892    service, delegates of the service (assuming it is a restarter), or
893    all services.
894
895    Its attributes are:
896
897	name    The property group's name.  If not specified, it
898		matches all property groups with the specified type.
899	type    The property group's type.  If not specified, it
900		matches all property groups with the specified name.
901	required
902		If the property group is required.
903	target	The scope of the pattern, which may be all, delegate,
904		instance, or this.  'all' is reserved for framework use
905		and applies the template to all services on the system.
906		'delegate' is reserved for restarters, and means the
907		template applies to all services which use the restarter.
908		'this' would refer to the defining service or instance.
909		'instance' can only be used in a service's template block,
910		and means the definition applies to all instances of this
911		service.
912
913-->
914
915<!ELEMENT pg_pattern
916	( common_name?, description?, prop_pattern* ) >
917
918<!ATTLIST pg_pattern
919	name		CDATA	""
920	type		CDATA	""
921	required	( true | false )	"false"
922	target		( this | instance | delegate | all )	"this" >
923
924<!--
925  template
926
927    The template contains a collection of metadata about the service.
928    It contains a localizable string that serves as a common,
929    human-readable name for the service.  (This name should be less than
930    60 characters in a single byte locale.)  The template may optionally
931    contain a longer localizable description of the service, a
932    collection of links to documentation, either in the form of manual
933    pages or in the form of URI specifications to external documentation
934    sources (such as docs.sun.com).
935
936    The template has no attributes.
937-->
938<!ELEMENT template
939        ( common_name, description?, documentation?, pg_pattern* ) >
940
941<!ATTLIST template>
942
943<!-- Notification Parameters -->
944
945<!ELEMENT paramval EMPTY>
946
947<!ATTLIST paramval
948	name		CDATA #REQUIRED
949	value		CDATA #REQUIRED>
950
951<!ELEMENT parameter
952	( value_node* )>
953
954<!ATTLIST parameter
955	name		CDATA #REQUIRED>
956
957<!ELEMENT event EMPTY>
958
959<!ATTLIST event
960	value		CDATA #REQUIRED>
961
962<!ELEMENT type
963	( ( parameter | paramval )* )>
964
965<!ATTLIST type
966	name		CDATA #REQUIRED
967	active		( true | false ) "true" >
968
969<!--
970  notification parameters
971
972    This element sets the notification parameters for Software Events and
973    Fault Management problem lifecycle events.
974-->
975
976<!ELEMENT notification_parameters
977	( event, type+ )>
978
979<!ATTLIST notification_parameters>
980
981<!-- Services and instances -->
982
983<!--
984  create_default_instance
985
986    A flag element indicating that an otherwise empty default instance
987    of this service (named "default") should be created at install, with
988    its enabled property set as given.
989
990    Its attribute is
991
992	enabled	[boolean] The initial value for the enabled state of
993		this instance.
994-->
995
996<!ELEMENT create_default_instance EMPTY >
997
998<!ATTLIST create_default_instance
999	enabled		( true | false ) #REQUIRED >
1000
1001<!--
1002  single_instance
1003
1004    A flag element stating that this service can only have a single
1005    instance on a particular system.
1006-->
1007
1008<!ELEMENT single_instance EMPTY>
1009
1010<!ATTLIST single_instance>
1011
1012<!--
1013  instance
1014
1015    The service instance is the object representing a software component
1016    that will run on the system if enabled.  It contains an enabled
1017    element, a set of dependencies on other services, potentially
1018    customized methods or configuration data, an optional method
1019    context, and a pointer to its restarter.  (If no restarter is
1020    specified, the master restarter, svc.startd(1M), is assumed to be
1021    responsible for the service.)
1022
1023    Its attributes are
1024
1025	name	The canonical name for this instance of the service.
1026
1027	enabled	[boolean] The initial value for the enabled state of
1028		this instance.
1029-->
1030
1031<!ELEMENT instance
1032	( restarter?, dependency*, dependent*, method_context?,
1033	exec_method*, notification_parameters*, property_group*,
1034	template? ) >
1035
1036<!ATTLIST instance
1037	name		CDATA #REQUIRED
1038	enabled		( true | false ) #REQUIRED >
1039
1040<!--
1041  service
1042
1043    The service contains the set of instances defined by default for
1044    this service, an optional method execution context, any default
1045    methods, the template, and various restrictions or advice applicable
1046    at installation.  The method execution context and template elements
1047    are required for service_bundle documents with type "manifest", but
1048    are optional for "profile" or "archive" documents.
1049
1050    Its attributes are
1051
1052	name	The canonical name for the service.
1053
1054	version	[integer] The integer version for this service.
1055
1056	type	Whether this service is a simple service, a delegated
1057		restarter, or a milestone (a synthetic service that
1058		collects a group of dependencies).
1059-->
1060
1061<!ELEMENT service
1062	( create_default_instance?, single_instance?, restarter?,
1063	dependency*, dependent*, method_context?, exec_method*,
1064	notification_parameters*, property_group*, instance*,
1065	stability?, template? ) >
1066
1067<!ATTLIST service
1068	name		CDATA #REQUIRED
1069	version		CDATA #REQUIRED
1070	type		( service | restarter | milestone ) #REQUIRED >
1071
1072<!--
1073  service_bundle
1074
1075    The bundle possesses two attributes:
1076
1077	type	How this file is to be understood by the framework (or
1078		used in a non-framework compliant way). Standard types
1079		are 'archive', 'manifest', and 'profile'.
1080
1081	name	A name for the bundle.  Manifests should be named after
1082		the package which delivered them; profiles should be
1083		named after the "feature set nickname" they intend to
1084		enable.
1085-->
1086
1087<!ELEMENT service_bundle
1088	( service_bundle* | service* | xi:include* )>
1089
1090<!ATTLIST service_bundle
1091	type		CDATA #REQUIRED
1092	name		CDATA #REQUIRED>
1093