This appendix describes:
Details of package FMRI version strings
How incorporate dependencies, facet.version-lock.* facets, group dependencies, and action tags are used to define working package sets for the Oracle Solaris OS
Package Identifier: FMRI described the pkg.fmri attribute and the different parts of the version field, including how the version field can be used to support different models of software development. This section explains how the Oracle Solaris OS uses the version field, and provides insight into the reasons that a fine-grained versioning scheme can be useful. In your packages, you do not need to follow the same versioning scheme that the Oracle Solaris OS uses.
The meaning of each part of the version string in the following sample package FMRI is given below:
pkg://solaris/system/library/storage/suri@0.5.11,5.11-0.175.3.0.0.19.0:20150329T164922Z
Component version. For packages that are part of the Oracle Solaris OS, this is the OS major.minor version. For other packages, this is the upstream version. For example, the component version of the following Apache Web Server package is 2.2.29:
pkg:/web/server/apache-22@2.2.29,5.11-0.175.3.0.0.19.0:20150329T181125Z
Release. This is used to define the OS release that this package was built for. The release should always be 5.11 for packages created for Oracle Solaris 11.
Branch version. Oracle Solaris packages show the following information in the branch version portion of the version string of a package FMRI:
Major release number. The major or marketing development release build number. In this example, 0.175 indicates Oracle Solaris 11.
Update release number. The update release number for this Oracle Solaris release. The update value is 0 for the first customer shipment of an Oracle Solaris release, 1 for the first update of that release, 2 for the second update of that release, and so forth. In this example, 3 indicates Oracle Solaris 11.3.
SRU number. The Support Repository Update (SRU) number for this update release. SRUs are approximately monthly updates that fix bugs, fix security issues, or provide support for new hardware. SRUs do not include new features. The Oracle Support Repository is available only to systems under a support contract.
Reserved. This field is not currently used for Oracle Solaris packages.
Release or SRU build number. The build number of the SRU, or the respin number for the major release.
Nightly build number. The build number for the individual nightly builds.
If the package is an Interim Diagnostic Relief (IDR), then the branch version of the package FMRI contains the following two additional fields. IDRs are package updates that help diagnose customer issues or provide temporary relief for a problem until a formal package update is issued. The following examples are for idr824, which has FMRI pkg://solaris/idr824@4,5.11:20131114T034951Z and contains packages such as pkg:/system/library@0.5.11-0.175.1.6.0.4.2.824.4:
Name of the IDR.
Version of the IDR.
Time stamp. The time stamp is defined when the package is published.