service_bundle(4) File Formats service_bundle(4)NAMEservice_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 bun‐
dle. The primary form of a service bundle is the inventory of services
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. 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.
service_bundle documents can also use the XML Inclusions (XInclude)
facility to merge multiple documents into one. A service_bundle docu‐
ment 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 frame‐
work'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 ser‐
vice, such as the <create_default_instance> tag.
Manifest Handling During Packaging Operations
Service manifests within packages should be identified with the class
manifest. Class action scripts that install and remove service mani‐
fests are included in the packaging subsystem. When pkgadd(1M) is
invoked, the service manifest is imported.
When pkgrm(1M) is invoked, instances in the manifest that are disabled
are deleted. Any services in the manifest with no remaining instances
are also deleted.
If the -R option is supplied to pkgadd(1M) or pkgrm(1M), the actions
described in this section will be done when the system is next rebooted
with that alternate root path.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcsu │
├─────────────────────────────┼─────────────────────────────┤
│Stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOpkgadd(1M), pkgrm(1M), svcadm(1M), svccfg(1M), svc.startd(1M), lib‐
scf(3LIB), attributes(5), locale(5), smf(5)NOTES
Nested service_bundle elements must be of the same type.
SunOS 5.10 3 May 2008 service_bundle(4)
