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>