service_bundle(4)						   File Formats 						 service_bundle(4)

NAME
service_bundle - service manifest file format
SYNOPSIS
/usr/share/lib/xml/dtd/service_bundle.dtd.1
DESCRIPTION
The service management facility, described in smf(5), utilizes an XML-based file format to marshal the description of a set of services or service instances between systems. This file is known as a service bundle. The primary form of a service bundle is the inventory of ser- vices that are provided by a package, which is called a "service manifest". The DTD describing the service_bundle is provided at /usr/share/lib/xml/dtd/service_bundle.dtd.1. service_bundle documents can also use the XML Inclusions (XInclude) facility to merge multiple documents into one. A service_bundle document manipulator must therefore support the functionality defined by the XInclude specification. A complete service description consists of the following: o A set of properties that identify the service and identify its restarter o A set of properties that identify each instance o A set of framework property groups that describe the framework's understanding of each instance o A set of method property groups as required by svc.startd(1M), or by a delegated restarter o Additional optional method property groups o A set of dependency property groups o An optional group of properties that indicate services to which dependencies on the described service were added o A set of application property groups or application-specific typed property groups containing application configuration data o A template that describes supporting information about this service, such as a description and links to documentation. The document type definition for the service bundle provides markup to define each of these aspects of a service description, as well as a number of entities that identify regular features in describing a service, such as the <create_default_instance> tag. The attributes and tags are fully described in the commented DTD. The services supplied with the operating system, stored under /var/svc/manifest, provide examples of correctly formed service descriptions. Localization in the Template Element The description tags in the template element for a service are internationalizable. Service developers wishing to provided localized descriptions of their services can elect to deliver a set of loctext element in the description, like <common_name> <loctext xml:lang="C">extended accounting<loctext> <loctext xml:lang="fr_CA">...</loctext> <loctext xml:lang="ja">...</loctext> .... </common_name> Alternatively, service developers can choose to deliver multiple manifests in the naming scheme /var/svc/manifest/[category]/[service].[locale].xml which define only the localized template elements for that service. For instance /var/svc/manifest/system/accounting.ja.xml would contain, inside the template element, the following for the service's common name <common_name> <loctext xml:lang="ja">...</loctext> </common_name> Importing this file would create the service if not defined, or augment the existing template with the additional localized entries.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Stability |Evolving | +-----------------------------+-----------------------------+
SEE ALSO
svcadm(1M), svccfg(1M), svc.startd(1M), libscf(3LIB), attributes(5), locale(5), smf(5)
NOTES
Nested service_bundle elements must be of the same type. SunOS 5.10 30 Aug 2004 service_bundle(4)

Featured Tech Videos