Unix/Linux Go Back    

OpenSolaris 2009.06 - man page for service_bundle (opensolaris section 4)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

service_bundle(4)			   File Formats 			service_bundle(4)

       service_bundle - service manifest file format


       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 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_bun-
       dle.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 mul-
       tiple 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  dele-
		  gated 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, links to documentation, and metadata  about  property  groups  and

       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 reg-
       ular features in describing a service, 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 manifests 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 are done when the system is next rebooted with that alternate root path.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWcsu			   |
       |Stability		     |Committed 		   |

       pkgadd(1M),    pkgrm(1M),    svcadm(1M),    svccfg(1M),	  svc.startd(1M),   libscf(3LIB),
       attributes(5), locale(5), smf(5), smf_method(5), smf_template(5)

       Nested service_bundle elements must be of the same type.

SunOS 5.11				    6 Mar 2009				service_bundle(4)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 07:33 PM.