sd(4)sd(4)NAMEsd - all objects that Software Distributor (SD) uses, their attributes
and storage formats
DESCRIPTION
The SD commands create, install, distribute and manage software objects
(bundles, products, subproducts and filesets). In addition, they
define and manage other objects in support of the software administra‐
tion tasks which users perform. This manual page describes the SD
software object classes, their attributes, and the file formats used to
store their definitions.
For an overview of all SD commands, see the sd(5) manual page by typ‐
ing:
The objects described here conform to of the IEEE Standard 1387.2:
Software Administration (POSIX). The previous SD layout_version 0.8 is
also supported. For more details, see swpackage(4) or the option in
sd(5).
OBJECT CLASSES
The SD object classes are:
host A machine at which software is installed, will be
installed, or is being managed. A host contains one
or more roots (installed filesystems) and zero or more
depots.
depot A directory location which contains software products
or bundles that are available for installation. It is
a customizable source of software used for direct
installation. It can also represent a distribution
medium (for example, tape or CD-ROM) which contains
products or bundles available for installation. Depot
corresponds to the class defined in POSIX.
media Vehicle for software delivery. When a depot is
located on one or more media in the unique sequence
number identifying each medium is in the media class.
root A set of installed software objects, usually the oper‐
ational software installed in the primary root
filesystem, "/". It also represents the set of soft‐
ware objects installed into an alternate root direc‐
tory. Root corresponds to the class defined in POSIX.
vendor The vendor who packaged and distributed a product or
bundle. It is an optional component of a product or a
bundle.
category A classification for a product or bundle, such as
"systems_management," "desktop," or "patch."
bundle A bundle is a way of encapsulating products, subprod‐
ucts and filesets into a single software object. More
than one bundle can contain the same software objects.
A bundle can be thought of as a particular "configura‐
tion" of software. It is a convenient way to group
software objects together for easy selection. Bundle
is NOT a superset of product.
product A software object which vendors package and distrib‐
ute, and which users purchase and install. A product
contains one or more filesets and zero or more sub‐
products. A product can also contain zero or more
control_files.
subproduct
A subset or partitioning of a software product. It is
an optional component of a product. and contains one
or more filesets.
fileset A grouping of one or more files contained in a product
or sub-product. It groups a subset of a product's
files into a manageable unit. A fileset can also con‐
tain zero or more control_files.
file The actual files that make up a fileset that get
installed, configured, and removed.
control_files
The scripts developed by vendors to perform product-
or fileset-specific operations during various software
management tasks. Often called control_scripts.
OBJECT ATTRIBUTES
The following tables summarize the valid attributes for each software
object class. A subset of these attributes can be defined for an
object when creating products or bundles with See swpackage(4) for
details on this subset.
The attribute value types are defined in the next section,
Vendor-Defined Attributes
You can create your own software attributes when packaging software.
Keywords in a product specification file that are not recognized by SD
are preserved, along with their associated values, by being transferred
to the resulting INDEX or INFO files created by or (Refer to swpack‐
age(4) for more information on INDEX and INFO files.)
The keyword is a filename character string. The value associated with
a keyword is processed as an attribute_value. It can be continued
across multiple input lines or can reference a file containing the
value for the keyword.
Vendor-defined attributes are noted during packaging or when modified
with These attributes can be listed with
Host Attributes
┌──────────────────┬──────────────────┬─────────┬──────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│machine_type │ uname_string │ 32 │ 9000/[78]* │
│ │ │ │ ia64 hp server g4000 │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│name │ one_line_string │ 64 │ dist.hp.com │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│os_name │ uname_string │ 32 │ HP-UX │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│os_release │ uname_string │ 32 │ B.11.11 │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│os_version │ uname_string │ 32 │ C │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│contained depots │ list of depot │ │ │
│ │ objects │ │ │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
│contained roots │ list of root │ │ │
│ │ directories │ │ │
├──────────────────┼──────────────────┼─────────┼──────────────────────┤
└──────────────────┴──────────────────┴─────────┴──────────────────────┘
The host's machine and architecture designation. (See output of
the
command.)
The official name of the network host.
The host's operating system name.
The host's operating system release.
The host's operating system version.
The depots registered at the host.
The root filesystems registered on this system.
Depot Attributes
┌─────────────────────┬───────────────────┬──────┬───────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│copyright │ multi_line_string │ 8K │ "This depot ..." │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│data_model_revision │ revision_string │ 64 │ 2.40 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│description │ multi_line_string │ 8K │ "This depot ..." │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│dfiles │ tag_string │ 64 │ dfiles │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│layout_version │ revision_string │ 64 │ 1.0 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│mod_date │ one_line_string │ 64 │ Tue Jun 22 12:52:09 │
│ │ │ │ 2001 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│mod_time │ unsigned_integer │ │ 740774837 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│name_max │ unsigned_integer │ │ 255 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│number │ one_line_string │ 64 │ B2358-13601 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│path_max │ unsigned_integer │ │ 1023 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│pfiles │ tag_string │ 64 │ pfiles │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│tag │ tag_string │ 64 │ APPLICATIONS_CD │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│title │ one_line_string │ 256 │ Applications Software │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│uuid │ one_line_string │ 64 │ 25CA7C86-6F0C-9353 │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│contained bundles │ list of bundle │ │ │
│ │ objects │ │ │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│contained products │ list of product │ │ │
│ │ objects │ │ │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│contained media │ media object │ │ │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│contained vendors │ vendor objects │ │ │
├─────────────────────┼───────────────────┼──────┼───────────────────────┤
│contained categories │ category objects │ │ │
└─────────────────────┴───────────────────┴──────┴───────────────────────┘
The copyright information for the depot or tape.
The HP specific format revision used to store the depot defini‐
tion.
The multi-paragraph description of the distribution depot/tape.
The name of a directory that contains any attributes that must
be
stored as files.
The version of the IEEE Standard 1387.2
or to which the HP-specific data_model_revision conforms.
The string format of the
The time of the last operation performed on the depot.
The maximum length of file basenames in the depot.
The part or manufacturing number of the depot/tape.
The maximum length of file pathnames in the depot.
The name of a directory that contains any product
or any product attributes that must be stored as files.
The identifier (short name) for the
distribution depot/tape.
The full name (one-line description)
of the distribution depot/tape.
The depot's Universal Unique Identifier (UUID).
The bundles available from the depot.
The products available from the depot.
The object defining the sequence number used to identify each
medium.
The objects defining a vendor object that is associated with
subsequent
bundle and product objects that define a attribute.
The objects defining a category object that is associated with
subsequent
software objects and define a attribute.
Media Attributes
Generated by
┌────────────────┬─────────────────┬──────┬─────────┐
│Attribute │ Value Type │ Size │ Example │
├────────────────┼─────────────────┼──────┼─────────┤
│sequence_number │ one_line_string │ 64 │ 1 │
├────────────────┼─────────────────┼──────┼─────────┤
└────────────────┴─────────────────┴──────┴─────────┘
For a multiple tape distribution,
this attribute defines the unique of each medium.
Root Attributes
┌─────────────────────┬───────────────────┬──────┬─────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│data_model_revision │ revision_string │ 64 │ 2.40 │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│description │ multi-line_string │ 2048 │ "This root is ..." │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│dfiles │ tag_string │ 64 │ dfiles │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│layout_version │ revision_string │ 64 │ 1.0 │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│mod_date │ one_line_string │ 64 │ Mon Jun 14 13:01:19 │
│ │ │ │ 2001 │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│mod_time │ unsigned_integer │ │ 740774837 │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│path │ one_line_string │ 256 │ /xx/xx/xx │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│pfiles │ tag_string │ 64 │ pfiles │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│root_type │ one_line_string │ 256 │ shared │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│contained bundles │ list of bundle │ │ │
│ │ objects │ │ │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│contained products │ list of product │ │ │
│ │ objects │ │ │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│contained vendors │ vendor objects │ │ │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
│contained categories │ category objects │ │ │
├─────────────────────┼───────────────────┼──────┼─────────────────────┤
└─────────────────────┴───────────────────┴──────┴─────────────────────┘
The HP specific format revision used to store the root defini‐
tion.
A multi-line description of the root.
The version of the IEEE Standard 1387.2
or to which the HP-specific data_model_revision conforms.
The string format of the
The time of the last operation performed on the root.
The path to the root.
The type of root: shared, private or none.
The bundles installed into the root.
The products installed into the root.
The object defining a vendor object that is associated
with subsequent bundle and product objects that define a
attribute.
The object defining a category object that is associated with
subsequent
software objects that define a attribute.
Vendor Attributes
┌─────────────┬────────────────────┬────────┬─────────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├─────────────┼────────────────────┼────────┼─────────────────────────┤
│description │ multi_line_string │ 8K │ "This vendor ..." │
├─────────────┼────────────────────┼────────┼─────────────────────────┤
│title │ one_line_string │ 256 │ Hewlett-Packard Company │
├─────────────┼────────────────────┼────────┼─────────────────────────┤
│tag │ tag_string │ 64 │ HP │
├─────────────┼────────────────────┼────────┼─────────────────────────┤
│uuid │ one_line_string │ 64 │ 1234567-CDEF-0123-4569 │
├─────────────┼────────────────────┼────────┼─────────────────────────┤
└─────────────┴────────────────────┴────────┴─────────────────────────┘
The multi-paragraph description of the vendor.
The identifier (short name) for the vendor. Used to associate a
vendor object with subsequent product or bundle objects
having a attribute of the same value.
The full name (one-line description)
for the vendor.
The vendor's
Universal Unique Identifier (UUID).
When listing the attributes of a vendor associated with the specified
product or bundle using the option lists all of the vendor attributes.
The option can be used to list specific vendor attributes (for example,
Note that the vendor specification is not the same as vendor-defined
attributes described in the section. Vendor specification describes
who is providing the software. Vendor-defined attributes associate
extra miscellaneous data with the software.
Category Attributes
┌─────────────┬─────────────────────┬────────┬─────────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├─────────────┼─────────────────────┼────────┼─────────────────────────┤
│description │ multi_line_string │ 8K │ normal patches │
├─────────────┼─────────────────────┼────────┼─────────────────────────┤
│revision │ revision_string │ 64 │ 0.0 │
├─────────────┼─────────────────────┼────────┼─────────────────────────┤
│tag │ tag_string │ 64 │ normal_patch │
├─────────────┼─────────────────────┼────────┼─────────────────────────┤
│title │ one_line_string │ 256 │ patches for normal use │
├─────────────┼─────────────────────┼────────┼─────────────────────────┤
└─────────────┴─────────────────────┴────────┴─────────────────────────┘
A more detailed description of the category.
A short name identifying the category. Each category must
have a unique tag. This attribute has no default value.
The category tag is reserved. When is set to for a soft‐
ware object, a built-in attribute of value is automati‐
cally included.
A longer name of the category used for presentation purposes.
Determines which category object definition to maintain in a
depot when a definition being installed or copied does
not match a definition already in the depot with the same
The category definition with the higher revision is main‐
tained.
Bundle and Product Attributes
· Attributes marked with a apply only to the class.
· Attributes marked with a apply only to the class.
· Attributes marked with a determine the uniqueness of a prod‐
uct or bundle object instance. Their values may also be of
the type when used in a version component of a software spec‐
ification.
┌─────────────────────┬─────────────────────┬───────┬───────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│+ all_filesets │ one-line list of │ │ commands agent │
│ │ tag_string values │ │ data man │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│* architecture │ one_line_string* │ 64 │ HP-UX_B.11.11_32/64 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ category_tag │ tag_string │ 64 │ normal │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│- contents │ repeatable list of │ 8K │ foo.bar,r=1.0,a=,v=HP │
│ │ software_specs │ │ x.y,r=2.0,a=,v= │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ control_directory │ path_string │ 255 │ SD │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ copyright │ multi_line_string │ 8K │ "This product ..." │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ create_date │ one_line_string │ 64 │ Mon Jun 14 13:01:19 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ create_time │ unsigned_integer │ │ 740084479 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ data_model_revision │ revision_string │ 64 │ 2.40 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ description │ multi_line_string │ 8K │ "This product ..." │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ directory │ path_string │ 1024 │ │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ install_date │ one_line_string │ 16 │ 200102241212.34 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ install_source │ one_line_string │ 1024 │ zook.com:/depot │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ install_type │ one_line_string │ 16 │ physical │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ instance_id │ tag_string │ 64 │ 1 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ is_locatable │ boolean │ 8 │ true │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ is_patch │ boolean │ 8 │ true │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ layout_version │ revision_string │ 64 │ 1.0 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│* location │ path_string │ 1024 │ / │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│machine_type │ uname_string │ 64 │ 9000/7*|9000/8* │
│ │ │ │ ia64* │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ mod_date │ one_line_string │ 64 │ Mon Jun 14 13:01:19 │
│ │ │ │ 2001 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ mod_time │ unsigned_integer │ │ 740084479 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ number │ one_line_string │ 64 │ J2326AA │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ os_name │ uname_string │ 64 │ HP-UX │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ os_release │ uname_string │ 64 │ ?.11.* │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ os_version │ uname_string │ 64 │ [A-Z] │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│+ postkernel │ path_string │ 255 │ /usr/bin/kernel_build │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ qualifier │ one_line_string │ 64 │ "My product" │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│+ readme │ multi_line_string │ 1024K │ < README │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│* revision │ revision_string │ 64 │ 2.0 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ share_link │ one_line_string │ 256 │ "sbin" │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ size │ unsigned_integer │ │ 14638872 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ software_spec │ software_spec │ │ SD,r=2.0 │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│* tag │ tag_string │ 64 │ SD │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│ title │ one_line_string │ 256 │ Software Distributor │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│* vendor_tag │ tag_string │ 64 │ HP │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│+ contained control │ list of control │ │ │
│ scripts │ script objects │ │ │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│+ contained │ list of fileset │ │ │
│ filesets │ objects │ │ │
├─────────────────────┼─────────────────────┼───────┼───────────────────────┤
│+ contained │ list of subproduct │ │ │
│ subproducts │ objects │ │ │
└─────────────────────┴─────────────────────┴───────┴───────────────────────┘
All the filesets originally packaged into the product.
The target system(s) on which the product will run.
A repeatable tag-based attribute identifying a set of
categories of which the software object is a member.
This is used as a selection mechanism and can be used
independent of patches. The default value is an empty
list or if the attribute is set to The category tag is
reserved.
Like this attribute associates this product or bundle
with a category object containing additional information
about the category (for example, a one-line title defini‐
tion and a description of the category).
The list of software_specs for a bundle. (Bundles can contain
other
bundles.) Fully qualified software specs at the fileset
level are recommended when defining packages. (Applies
to bundles only).
The relative pathname to the product catalog directory within
the
depot/root catalog that contains scripts for the product.
The copyright information for the product.
The string format of the
The time at which the bundle or product was created.
The format revision used to store the product definition.
The default pathname in which the
product's files will be installed.
The multi-paragraph description of the product.
The installation date of the product or bundle.
The source from which the product was installed.
The type of installation - "physical" or "NFS_mount".
The secondary identifier for products which have the same
(or truncated tag) value.
Defines whether (or not) the product can be installed into an
arbitrary directory.
Identifies a software object as a patch. The default value is
When set to a built-in attribute of value is automati‐
cally included.
The version of the IEEE Standard 1387.2
or to which the HP-specific data_model_revision conforms.
The installed pathname of the product.
The machine(s) on which the product will run.
The string format of the
The time of the last operation performed on the product.
The part or order number for the product.
The operating system(s) on which the product will run.
The operating system release(s) on which the product will run.
The operating system versions(s) on which the product will run.
The path to a script that is run after kernel filesets are
installed.
A user-specified name that identifies a product or set of prod‐
uct
versions. Can be set using and used in software_specs
with other commands.
The most recent information for the product.
The revision (release number, version number) of the product.
Sharing point(s) for product.
The size of the product in bytes.
The fully qualified software specification for the bundle or
product.
This attribute can be used to identify a unique bundle or
product.
The identifier (short name) for the
product.
The full name (one-line description)
of the product.
Associates this product or bundle with a vendor object contain‐
ing
additional attributes describing the vendor. The vendor
object must have a matching attribute.
The scripts defined for the product.
The fileset defined for the product.
The subproducts defined for the product.
Subproduct Attributes
┌───────────────┬─────────────────────────┬──────┬───────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
│contents │ repeatable list of │ │ commands data man │
│ │ tag_string values │ │ commands data man │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
│description │ multi_line_string │ 8K │ "This subproduct ..." │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
│size │ unsigned_integer │ │ 14638872 │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
│software_spec │ software_specification │ │ Networking.Run,r=1.0 │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
│tag │ tag_string │ 64 │ Manager │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
│title │ one_line_string │ 256 │ Management Utilities │
├───────────────┼─────────────────────────┼──────┼───────────────────────┤
└───────────────┴─────────────────────────┴──────┴───────────────────────┘
A list of the filesets or subproducts that make up the subprod‐
uct.
The multi-paragraph
description of the subproduct.
The size of the subproduct in bytes.
The full software specification for the subproduct. This
attribute
can be used to identify a unique subproduct.
The identifier (short name) for the subproduct.
The full name (one-line description)
of the subproduct.
Fileset Attributes
┌───────────────────┬──────────────────────┬───────┬────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│ancestor │ repeatable list of │ │ oldprod.fs │
│ │ software specs │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│applied_patches │ software_spec │ │ product.fileset, │
│ │ │ │ version │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│architecture │ one_line_string │ 64 │ HP-UX_B.11.11 │
│ │ │ │ _32/64 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│category_tag │ tag_string │ 64 │ patch_normal │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│control_directory │ path_string │ 255 │ SD │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│corequisites │ repeatable list of │ │ SD.man │
│ │ software_specs │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│create_date │ one_line_string │ 64 │ Mon Jun 14 │
│ │ │ │ 13:01:19 2001 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│create_time │ unsigned_integer │ │ 740084479 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│data_model_ │ revision_string │ 64 │ 2.40 │
│revision │ │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│description │ multi_line_string │ 8K │ "This fileset ..." │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│exrequisites │ repeatable list of │ │ SD.man │
│ │ software_specs │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│install_date │ one-line string │ 16 │ 200102241414.34 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│install_source │ one_line_string │ 1024 │ zook.com:/depot │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│instance_id │ tag_string │ │ 1 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_kernel │ boolean │ 8 │ false │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_locatable │ boolean │ 8 │ true │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_packaged_ │ boolean │ 8 │ false │
│in_place │ │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_patch │ boolean │ 8 │ true │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_reboot │ boolean │ 8 │ false │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_secure │ boolean │ 8 │ false │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│is_sparse │ boolean │ 8 │ false │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│location │ path_string │ 1024 │ / │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│machine_type │ uname_string │ 64 │ 9000/[78]* │
│ │ │ │ ia64* │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│media_sequence_ │ unsigned_integer │ │ 1 │
│number │ │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│mod_date │ one_line_string │ 64 │ Mon Jun 14 │
│ │ │ │ 13:01:19 2001 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│mod_time │ unsigned_integer │ │ 740084479 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│os_name │ uname_string │ 64 │ HP-UX │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│os_release │ uname_string │ 64 │ ?.11.* │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│os_version │ uname_string │ 64 │ ? │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│patch_state │ patch_state_string │ 16 │ applied │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│pose_as_os_name │ uname string │ 64 │ HP-UX:64 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│pose_as_os_ │ uname string │ 64 │ B.11.11 │
│release │ │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│prerequisites │ repeatable list of │ │ SD.agent │
│ │ software_specs │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│revision │ revision_string │ 64 │ 2.15 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│size │ unsigned_integer │ │ 14638872 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│state │ state_enumeration │ │ corrupt │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│software_spec │ software_spec │ │ Networking.Run, │
│ │ │ │ r=1.0 │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│superseded_by │ software_spec │ │ product.fileset, │
│ │ │ │ version │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│supersedes │ software_spec │ │ product.fileset, │
│ │ │ │ fr=revision │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│tag │ tag_string │ 64 │ commands │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│title │ one_line_string │ 256 │ Commands │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│contained control │ list of control │ │ │
│ scripts │ script objects │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
│contained files │ list of file objects │ │ │
├───────────────────┼──────────────────────┼───────┼────────────────────┤
└───────────────────┴──────────────────────┴───────┴────────────────────┘
A list of filesets that will match the current fileset when
installed
on a target system if the installation option is speci‐
fied. Also determines the base to which a patch is
applied. (Note that an attribute is not the same as a
Determines the list of patches that have been applied to a base
fileset. This attribute applies to installed base (non-
patch) software only.
Describes the target system(s) on which the fileset will run if
filesets for multiple architectures are included in a
single product. Provides a human-readable summary of the
four attributes which define the exact target system(s)
the fileset supports. Most filesets do not include an
architecture; only a product architecture need be
defined.
A repeatable tag-based attribute identifying a set of
categories of which the software object is a member.
This is used as a selection mechanism and can be used
independent of patches. The default value is an empty
list or if the attribute is set to The category tag is
reserved.
Like this attribute can be used as a pointer to a cate‐
gory object that contains additional information about
the category (for example, a one-line title definition
and a description of the category).
The relative pathname to the fileset catalog directory in the
product
catalog that contains the control_scripts for the file‐
set.
A list of dependencies on software that must be installed before
this
software is run.
The format revision used to store the fileset definition.
The multi-paragraph
description of the fileset.
A list of dependencies on software that may not be installed
when this
software is installed.
The date the fileset was installed.
The source from which the product was installed.
The secondary identifier for filesets which have the same
(or truncated tag) value.
Defines whether or not the fileset contains kernel files.
Defines whether or not the fileset can be installed into an
arbitrary
directory.
For a fileset within a depot, this attribute defines whether or
not the
fileset is packaged in place. If true, then the file‐
set's contents are actually references to the original
source files used to construct the fileset.
Identifies a software object as a patch.
The default value is When set to a built-in attribute of
value is automatically included.
Defines whether or not the fileset requires a reboot after
install.
Defines whether or not the fileset is encrypted on a CD-ROM
media,
requiring a codeword to install.
Indicates that a fileset contains only a subset of files in the
base (ancestor) fileset and that the contents are to be
merged with the base fileset. The default value is If
the attribute is is also set to for the fileset, although
it can be forced to false.
The installed pathname of the fileset, derived from the product
location.
Defines the machine(s) on which the product will run if a file‐
set
architecture has been defined. (If not specified,
assigns a value of "*", meaning the fileset runs on all
machines.) If there are multiple machine platforms, use
wildcards or the '|' character to identify them. This
attribute should pattern match the output of the command
on the supported target machine(s).
For a multiple tape distribution,
defines the tape on which the fileset is archived.
The string format of the
The time of the last operation performed on the fileset.
Defines the operating system(s) on which the product will run if
a
fileset architecture has been defined. (If not speci‐
fied, assigns a value of "*", meaning the fileset runs on
all operating systems.) If there are multiple operating
systems, use wildcards or the '|' character to identify
them. This attribute should pattern match to the value
of on the supported target system(s).
Defines the operating system release(s) on which the product
will run
if a fileset architecture has been defined. (If not
specified, assigns a value of "*", meaning the fileset
runs on all releases.) If there are multiple operating
system releases, use wildcards or the '|' character to
identify them. This attribute should pattern match to
the value of on the supported target system(s).
Defines the operating system version(s) on which the product
will run
if a fileset architecture has been defined. (If not
specified, assigns a value of "*", meaning the fileset
runs on all versions.) If there are multiple operating
system versions, use wildcards or the '|' character to
identify them. This attribute should pattern match to
the value of on the supported target system(s).
Lists the current state of an installed patch, either
or Applies to installed patches only.
Overrides the existing
attribute of any target to which the given fileset is
being installed. Used for filesets that define a new OS.
Overrides the existing
uname attribute of any target to which the given fileset
is being installed. Used for filesets that define a new
OS.
A list of dependencies on software that must be installed before
this
software can be installed.
The revision (release number, version number) of the fileset.
The size of the fileset in bytes.
The current state of the fileset (resulting from the most recent
operation performed on it).
The full software specification for the fileset. Used to iden‐
tify a
unique fileset.
Lists what patch superseded this patch. Applies to installed
patches
only.
Used when a patch is replaced by (or merged into) a later patch.
The attribute indicates which previous patches are
replaced by the patch being installed or copied. This
attribute value is a list of software specifications of
other patches that this patch "supersedes".
The identifier (short name) for the fileset.
The full name (one-line description)
of the fileset (or truncated tag) value.
The scripts defined for the fileset.
The files defined for the fileset.
Control_File Attributes
┌─────────────┬─────────────────────┬───────┬──────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├─────────────┼─────────────────────┼───────┼──────────────────────┤
│interpreter │ path_string │ │ /usr/package/scripts │
├─────────────┼─────────────────────┼───────┼──────────────────────┤
│path │ path_string │ 255 │ checkinstall │
├─────────────┼─────────────────────┼───────┼──────────────────────┤
│result │ result_enumeration │ │ success │
├─────────────┼─────────────────────┼───────┼──────────────────────┤
│tag │ tag_string │ 16 │ checkinstall │
└─────────────┴─────────────────────┴───────┴──────────────────────┘
Control_files can be defined for filesets and products.
The name of an interpreter used to execute
control_files. By default, SD interprets scripts with a
POSIX shell ( You can define a different interpreter, for
example:
SD checks that the interpreter is available. If not, the
script fails. If SD finds the interpreter, it processes
the script normally using the specified interpreter.
Control scripts can also define their own interpreter in
the first line of the script.
The relative pathname to the
control_script in the control_directory.
The result obtained from executing the
control_script.
The identifier (short name) for the
control_script.
File Attributes
┌───────────────────┬──────────────────────────┬───────┬─────────────────────┐
│Attribute │ Value Type │ Size │ Example │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│cksum │ unsigned_integer │ │ 18355158 │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│compressed_cksum │ unsigned_integer │ │ false │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│compressed_size │ unsigned_integer │ │ false │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│compression_state │ compression_enumeration │ │ compressed │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│compression_type │ tag_string │ 64 │ gzip │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│gid │ unsigned_integer │ │ 0 │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│group │ tag_string │ 64 │ sys │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│is_volatile │ boolean │ 8 │ false │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│link_source │ path_string │ 1024 │ /usr/sbin/swinstall │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│mode │ unsigned integer │ │ 04555 │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│mtime │ unsigned_integer │ │ 740084479 │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│owner │ tag_string │ 64 │ root │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│path │ path_string │ 255 │ /usr/sbin/swpackage │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│revision │ revision_string │ 64 │ 1 .3 │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│size │ unsigned_integer │ │ 2494464 │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│source │ path_string │ 1024 │ /mfg/sbin/swinstall │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│type │ file_type_enumeration │ │ f │
├───────────────────┼──────────────────────────┼───────┼─────────────────────┤
│uid │ unsigned_integer │ │ 0 │
└───────────────────┴──────────────────────────┴───────┴─────────────────────┘
The 32-bit checksum of the file.
The checksum of the compressed file.
The size of the compressed file.
The compression state of a file (compressed or not).
The type of compression used to store the file.
The GID of the file's owner.
The name of the file's group.
Defines whether the file can be modified or removed.
The path to which a hard or symbolic link points. (Note that
the INFO
file contains the only representation of a symbolic
link.)
The file permission mode.
The last modification time of the file.
The name of the file's owner.
The full pathname to the file.
The or revision of the file.
The size of the file in bytes.
The full path to the source file for files which have been
"packaged
in place"; see swpackage(1M).
The type of file.
The UID of the file's owner.
VALUE TYPES
The value for each attribute must be of a specific type. The types
are:
boolean Maximum length: 8 bytes
Examples: true, false
One of the following values:
compression_enu‐
meration
Maxi‐
mum
length:
none
One of
the
fol‐
lowing
val‐
ues:
file_type_enu‐
mer‐
a‐
tion
Max‐
i‐
mum
length:
none
One
of
the
fol‐
low‐
ing
val‐
ues:
ar‐
chive
blank
spe‐
cial
device
char‐
ac‐
ter
spe‐
cial
device
direc‐
tory
file
hard
link
named
pipe
(FIFO)
sym‐
bolic
link
multi_line_string
Max‐
i‐
mum
length:
8K
(1
Mbyte
for
Multi-
line
strings
sup‐
port
all
char‐
ac‐
ters.
They
rep‐
re‐
sent
one
or
more
para‐
graphs
of
text.
They
are
usu‐
ally
spec‐
i‐
fied
in-
line,
sur‐
rounded
by
dou‐
ble-
quotes.
(The
prod‐
uct
is
stored
in
a
file,
and
spec‐
i‐
fied
using
the
``for‐
mat).
one_line_string
Max‐
i‐
mum
length:
256
bytes
Exam‐
ples:
Hewlett-
Packard
Com‐
pany
One-
line
strings
sup‐
port
a
sub‐
set
of
char‐
ac‐
ters
only.
No
char‐
ac‐
ters,
except
for
space
and
tab,
are
allowed.
patch_state_string
Max‐
i‐
mum
length:
16
One
of
the
fol‐
low‐
ing
val‐
ues:
path_string
Max‐
i‐
mum
length:
255
bytes
for
tapes,
1024
bytes
for
depots
Exam‐
ples:
An
abso‐
lute
or
rel‐
a‐
tive
path
to
a
file.
result_enu‐
mer‐
a‐
tion
Max‐
i‐
mum
length:
none
One
of
the
fol‐
low‐
ing
val‐
ues:
revi‐
sion_string
Max‐
i‐
mum
length:
64
bytes
Exam‐
ples:
2.0,
B.11.11
Revi‐
sion
strings
con‐
tain
zero
or
more
dot-
sep‐
a‐
rated
one_line_strings
(above).
soft‐
ware_spec‐
i‐
fi‐
ca‐
tion
Max‐
i‐
mum
length:
none
Exam‐
ples:
SD.agent
or
SD,r=2.0,a=HP-
UX_B.11.11_32/64
Soft‐
ware
spec‐
i‐
fi‐
ca‐
tions
spec‐
ify
soft‐
ware
in
depen‐
den‐
cies,
ances‐
tors
and
other
attributes,
as
well
as
com‐
mand
line
selec‐
tions.
The
next
sec‐
tion
describes
soft‐
ware
spec‐
i‐
fi‐
ca‐
tion
syn‐
tax.
state_enu‐
mer‐
a‐
tion
Max‐
i‐
mum
length:
none
One
of
the
fol‐
low‐
ing
file‐
set
states:
tag_string
Max‐
i‐
mum
length:
64
bytes
Exam‐
ples:
HP,
SD
Tag
strings
con‐
tain
a
sub‐
set
of
char‐
ac‐
ters.
The
first
char‐
ac‐
ter
is
restricted
to:
A-Z,
a-z,
0-9
The
char‐
ac‐
ters
are
not
allowed;
see
ctype(3C).
Metachar‐
ac‐
ters
not
allowed:
Shell
metachar‐
ac‐
ters
not
allowed:
Shell
quot‐
ing
char‐
ac‐
ters
not
allowed:
Direc‐
tory
path
char‐
ac‐
ter
not
allowed:
uname_string
Max‐
i‐
mum
length:
64
bytes
Exam‐
ples:
9000/7*|9000/8*,
ia64*,
HP-
UX,
?.11.*,
[A-Z]
Uname
strings
con‐
tain‐
ing
a
sub‐
set
of
char‐
ac‐
ters
only.
No
char‐
ac‐
ters
are
allowed.
Shell
pat‐
tern
match‐
ing
nota‐
tion
allowed:
Pat‐
terns
can
be
"ORed"
together
using
the
sep‐
a‐
ra‐
tor:
unsigned_inte‐
ger
Max‐
i‐
mum
length:
none
An
inte‐
ger
in
the
range
>=
0
and
<=
2^32.
SOFT‐
WARE
SPEC‐
I‐
FI‐
CA‐
TION
SYN‐
TAX
The
SD
com‐
mands
and
attributes
sup‐
port
the
fol‐
low‐
ing
syn‐
tax
for
each
soft‐
ware_spec‐
i‐
fi‐
ca‐
tion:
· You
can
spec‐
ify
selec‐
tions
with
the
fol‐
low‐
ing
shell
wild‐
card
and
pat‐
tern-
match‐
ing
nota‐
tions:
For
exam‐
ple,
selects
all
bun‐
dles
and
prod‐
ucts
with
tags
that
end
with
"man".
· Bun‐
dles
and
sub‐
prod‐
ucts
are
recur‐
sive.
Bun‐
dles
can
con‐
tain
other
bun‐
dles
and
sub‐
prod‐
ucts
can
con‐
tain
other
sub‐
prod‐
ucts;
for
exam‐
ple:
or
(using
expres‐
sions):
· The
soft‐
ware
spec‐
i‐
fi‐
ca‐
tion
selects
all
prod‐
ucts.
Use
this
spec‐
i‐
fi‐
ca‐
tion
with
cau‐
tion.
The
com‐
po‐
nent
has
the
form:
· loca‐
tion
applies
only
to
installed
soft‐
ware
and
refers
to
soft‐
ware
installed
to
a
loca‐
tion
other
than
the
default
prod‐
uct
direc‐
tory.
· and
apply
only
to
file‐
sets.
· ,
,
,
,
and
apply
only
to
bun‐
dles
and
prod‐
ucts.
They
are
applied
to
the
left‐
most
bun‐
dle
or
prod‐
uct
in
a
soft‐
ware
spec‐
i‐
fi‐
ca‐
tion.
· The
<op>
(rela‐
tional
oper‐
a‐
tor)
com‐
po‐
nent
can
be
of
the
form:
or
which
per‐
forms
indi‐
vid‐
ual
com‐
par‐
isons
on
dot-
sep‐
a‐
rated
fields.
For
exam‐
ple,
chooses
all
revi‐
sions
greater
than
or
equal
to
The
sys‐
tem
com‐
pares
each
dot-
sep‐
a‐
rated
field
to
find
matches.
Shell
pat‐
terns
are
not
allowed
with
these
oper‐
a‐
tors.
· The
(equals)
rela‐
tional
oper‐
a‐
tor
lets
you
spec‐
ify
selec‐
tions
with
the
shell
wild‐
card
and
pat‐
tern-
match‐
ing
nota‐
tions:
For
exam‐
ple,
the
expres‐
sion
returns
any
revi‐
sion
in
ver‐
sion
10
or
ver‐
sion
11.
· All
ver‐
sion
com‐
po‐
nents
are
repeat‐
able
within
a
sin‐
gle
spec‐
i‐
fi‐
ca‐
tion
(for
exam‐
ple,
If
mul‐
ti‐
ple
com‐
po‐
nents
are
used,
the
selec‐
tion
must
match
all
com‐
po‐
nents.
· include
the
and
ver‐
sion
com‐
po‐
nents
even
if
they
con‐
tain
empty
strings.
For
installed
soft‐
ware,
is
also
included.
· No
space
or
tab
char‐
ac‐
ters
are
allowed
in
a
soft‐
ware
selec‐
tion.
· The
soft‐
ware
can
take
the
place
of
the
ver‐
sion
com‐
po‐
nent.
It
has
the
form:
[instance_id]
within
the
con‐
text
of
an
exported
cat‐
a‐
log,
where
is
an
inte‐
ger
that
dis‐
tin‐
guishes
ver‐
sions
of
prod‐
ucts
and
bun‐
dles
with
the
same
tag.
HOST
OBJECT
FOR‐
MAT
The
file
defines
the
soft‐
ware
depots
on
the
local
host
which
have
been
reg‐
is‐
tered
with
the
dae‐
mon
run‐
ning
on
the
host.
The
file
has
this
for‐
mat:
host
data_model_revision 2.40
distribution Defines a contained (registered) depot
path directory
distribution
path directory
...
DEPOT
(DIS‐
TRI‐
BU‐
TION)
FOR‐
MAT
A
depot
is
for‐
mat‐
ted
using
the
fol‐
low‐
ing
direc‐
tory
struc‐
ture:
catalog/ Catalog of depot's contents
INDEX Global index (table of contents)
swlock Controls simultaneous modification
dfiles/ Stores all depot-specific information
INDEX Defines depot-specific attributes
INFO Defines depot-specific files
_ACL Access Control List (ACL) for the depot
_OWNER Owner and group of the depot's creator
_LOCK_FILE Controls simultaneous ACL modification
_PROD_DFLT_ACL Default ACL for new products
product_directory/ Catalog for a product
pfiles/ Stores all product-specific information
INDEX Defines product attributes
INFO Defines product files and scripts
README The product's README attribute
scripts Zero or more product control files
_ACL ACL for the product
_OWNER Owner and group of the product's creator
_LOCK_FILE Controls simultaneous ACL modification
fileset_directory/ Catalog for a fileset
INDEX Defines fileset attributes
INFO Defines fileset files and scripts
scripts Zero or more fileset control files
fileset_directory/ Catalog for the next fileset
...
product_directory/ Catalog for the next product
...
product_directory/ Contents of a product
fileset_directory/ Contents of a fileset
... Contents of the next fileset
product_directory/ Contents of the next product
...
The
for‐
mat
is
divided
into
two
areas:
· the
which
con‐
tains
all
the
infor‐
ma‐
tion
which
describes
the
prod‐
ucts
con‐
tained
in
the
depot;
· the
which
stores
the
actual
files
con‐
tained
in
each
prod‐
uct
(one
prod‐
uct_direc‐
tory
per
prod‐
uct.)
Prod‐
uct
and
File‐
set
Con‐
trol
Direc‐
tory
Names
The
prod‐
uct.con‐
trol_direc‐
tory
and
file‐
set.con‐
trol_direc‐
tory
val‐
ues
are
unique
stor‐
age
direc‐
to‐
ries
for
a
given
prod‐
uct
and
file‐
set.
They
have
this
syn‐
tax:
tag[.instance_id]
The
tag
com‐
po‐
nent
is
the
prod‐
uct
or
file‐
set
attribute.
If
more
than
one
prod‐
uct
with
the
same
tag
exists
in
the
soft‐
ware
depot,
the
instance_id
com‐
po‐
nent
is
nec‐
es‐
sary.
This
com‐
po‐
nent
is
the
prod‐
uct
or
file‐
set
instance_id
attribute.
On
a
short-
file‐
name
filesys‐
tem,
the
tag
com‐
po‐
nent
is
trun‐
cated
to
the
first
9
char‐
ac‐
ters
(if
nec‐
es‐
sary).
All
prod‐
ucts
with
the
same
trun‐
cated
tag
will
also
have
a
unique
stor‐
age
direc‐
tory
based
on
the
instance_id
com‐
po‐
nent.
Dis‐
tri‐
bu‐
tion
Tape
For‐
mat
A
dis‐
tri‐
bu‐
tion
tape
con‐
tains
the
depot
for‐
mat
(above),
archived
to
one
or
more
tapes
in
or
for‐
mat.
The
entire
pre‐
cedes
the
depot
con‐
tents
on
a
dis‐
tri‐
bu‐
tion
tape.
If
the
dis‐
tri‐
bu‐
tion
spans
mul‐
ti‐
ple
tapes,
then
the
first
tape
con‐
tains
the
entire
cat‐
a‐
log,
and
as
many
file‐
set
con‐
tents
direc‐
to‐
ries
as
will
fit
on
the
tape.
Each
addi‐
tional
tape
con‐
tains
only
the
fol‐
lowed
by
as
many
file‐
set
con‐
tents
direc‐
to‐
ries
as
will
fit
on
the
tape.
INSTALLED
PROD‐
UCTS
DATA‐
BASE
FOR‐
MAT
An
Installed
Prod‐
ucts
Data‐
base
(IPD)
describes
the
soft‐
ware
installed
in
a
pri‐
mary
or
alter‐
nate
root
filesys‐
tem.
The
for‐
mat
of
an
IPD
is
sim‐
i‐
lar
to
the
for‐
mat
of
a
soft‐
ware
depot.
An
IPD
is
for‐
mat‐
ted
using
the
fol‐
low‐
ing
direc‐
tory
struc‐
ture:
var/adm/sw/products/ Catalog of root's contents
INDEX Global index (table of contents)
swlock Controls simultaneous modification
ifiles/ Stores all root-specific information
INDEX Defines root-specific attributes
INFO Defines root-specific files
_ACL Access Control List (ACL) for the root
_OWNER Owner and group of the root's creator
_LOCK_FILE Controls simultaneous ACL modification
product_directory/ Catalog for a product
pfiles/ Stores all product-specific information
INDEX Defines product attributes
INFO Defines product files and scripts
README The product's README attribute
scripts Zero or more product control files
fileset_directory/ Catalog for a fileset
INDEX Defines fileset attributes
INFO Defines fileset files and scripts
SAVE Defines file attributes for a fileset that
has been patched.
SAVEIPD Defines file attributes for a fileset that
has been patched. To permit potential patch
rollback, SD saves copies of patched files
under /var/adm/sw/save/patch_name/fileset
scripts Zero or more fileset control files
fileset_directory/ Catalog for the next fileset
...
product_directory/ Catalog for the next product
...
Prod‐
uct
and
File‐
set
Direc‐
tory
Names
The
prod‐
uct_direc‐
tory
and
file‐
set_direc‐
tory
val‐
ues
are
as
described
for
the
depot
for‐
mat
above.
INDEX
FOR‐
MAT
An
INDEX
file
describes
all
of
the
attributes
(except
for
con‐
tained
scripts
and
con‐
tained
files)
of
a
file‐
set,
prod‐
uct,
depot,
or
root.
In
a
depot,
the
file‐
set,
prod‐
uct,
and
depot
INDEX
files
are
con‐
cate‐
nated
together
to
form
the
file.
In
a
root,
the
file‐
set,
prod‐
uct,
and
root
INDEX
files
are
con‐
cate‐
nated
together
to
form
the
file.
This
sec‐
tion
describes
the
key‐
word
syn‐
tax
used
in
an
INDEX
file.
The
value
for
each
must
meet
the
type
restric‐
tions
described
in
the
sec‐
tion.
Depot
INDEX
For‐
mat
tag tag_value
copyright copyright_value
data_model_revision revision_value
description description_value
dfiles dfiles_value
layout_version revision_value
mod_date date_value
mod_time time_value
name_max name_max_value
number number_value
path_max path_max_value
pfiles tag_value
title title_value
uuid uuid_value
sequence_number sequence_number_value
No
attributes
are
required.
Root
INDEX
For‐
mat
data_model_revision revision_value
description description_value
dfiles dfiles_value
layout_version revision_value
mod_date date_value
mod_time time_value
path path_value
pfiles tag_value
root_type root_value
No
attributes
are
required.
Bun‐
dle
or
Prod‐
uct
INDEX
For‐
mat
NOTE:
· The
attribute
is
always
required
for
all
objects.
· The
attribute
is
required
for
· Key‐
words
marked
with
a
apply
only
to
INDEX
for‐
mat.
· Key‐
words
marked
with
a
apply
only
to
INDEX
for‐
mat.
tag tag_value
description description_value
title title_value
uuid uuid_value
tag tag_value
description description_value
revision revision_value
title title_value
tag tag_value
+ all_filesets all_filesets_value
architecture architecture_value
category_tag tag_value
- contents contents_value
control_directory control_directory_value
copyright copyright_value
create_date date_value
create_time time_value
data_model_revision revision_value
description description_value
directory directory_value
install_date install_date_value
install_source install_source_value
install_type install_type_value
instance_id id_value
is_locatable boolean_value
is_patch boolean_value
+ job_file job_file_value
location location_value
machine_type machine_type_value
mod_date date_value
mod_time time_value
number number_value
os_name os_name_value
os_release os_release_value
os_version os_version_value
+ postkernel postkernel_value
qualifier qualifier_value
+ readme readme_value
revision revision_value
share_link share_link_value
size size_value
software_spec software_specification_value
title title_value
vendor_tag vendor_tag_value
tag tag_value
contents contents_value
description description_value
size size_value
software_spec software_specification_value
title title_value
File‐
set
INDEX
For‐
mat
NOTE:
· The
attribute
is
always
required.
· The
attribute
is
required
for
file‐
sets
within
a
mul‐
ti‐
ple
tape
dis‐
tri‐
bu‐
tion.
· Mul‐
ti‐
ple
def‐
i‐
ni‐
tions
of
and
are
allowed.
tag tag_value
ancestor ancestor_value
applied_patches software_specification_value
architecture architecture_value
category_tag tag_value
control_directory control_directory_value
corequisites corequisites_value
create_date date_value
create_time time_value
data_model_revision revision_value
description description_value
exrequisites exrequisites_value
install_date date_value
install_source install_source_value
instance_id id_value
is_kernel boolean_value
is_locatable boolean_value
is_packaged_in_place boolean_value
is_patch boolean_value
is_reboot boolean_value
is_secure boolean_value
is_sparse boolean_value
location location_value
machine_type machine_type_value
media_sequence_number sequence_value
mod_date date_value
mod_time time_value
os_name os_name_value
os_release os_release_value
os_version os_version_value
patch_state patch_state_value
pose_as_os_release release_value
prerequisites prerequisites_value
revision revision_value
size size_value
state state_value
software_spec software_specification_value
superseded_by software_specification_value
supersedes software_specification_value
title title_value
INFO
FOR‐
MAT
An
INFO
file
describes
all
of
the
con‐
trol
scripts
and
other
files
con‐
tained
within
a
file‐
set
or
prod‐
uct.
This
sec‐
tion
describes
the
key‐
word
syn‐
tax
used
in
an
INFO
file.
Con‐
trol
File
For‐
mat
tag tag_value
interpreter interpreter_value
path path_value
result result_value
The
and
attributes
are
required.
File
For‐
mat
cksum cksum_value
compressed_cksum cksum_value
compressed_size size_value
compression_state compression_state_value
compression_type type_value
file_attrs file_attrs_value
gid gid_value
group group_value
is_volatile boolean_value
link_source source_value
mode mode_value
mtime mtime_value
owner owner_value
path path_value
revision revision_value
size size_value
source_path source_value
type file_type_value
uid uid_value
The
and
attributes
are
always
required.
The
attribute
is
required
for
hard
link
and
sym‐
bolic
link
files.
NOTE:
The
INFO
file
con‐
tains
the
only
rep‐
re‐
sen‐
ta‐
tion
of
a
sym‐
bolic
link.
ACL
FOR‐
MAT
An
Access
Con‐
trol
List
(ACL)
has
this
for‐
mat:
entry_type:[key:]permissions
entry_type:[key:]permissions
entry_type:[key:]permissions
See
the
swacl(1M)
man‐
ual
page
for
details
on
the
fields
in
an
ACL
entry.
Note
that
the
per‐
mis‐
sions
of
a
stored
ACL
are
lit‐
eral
octal
strings,
but
the
per‐
mis‐
sions
dis‐
played
by
are
sym‐
bolic.
The
file
uses
a
sub‐
set
of
the
ACL
for‐
mat.
It
con‐
tains
an
entry
for
the
and
names
of
the
user
who
cre‐
ated
the
cor‐
re‐
spond‐
ing
object.
LOCK‐
ING
These
com‐
mands
use
a
com‐
mon
lock‐
ing
mech‐
a‐
nism
for
read‐
ing
and
mod‐
i‐
fy‐
ing
both
root
direc‐
to‐
ries
and
soft‐
ware
depots.
This
mech‐
a‐
nism
allows
mul‐
ti‐
ple
read‐
ers
but
only
one
writer
on
a
root
or
depot.
The
com‐
mands
which
mod‐
ify
soft‐
ware
in
an
(alter‐
nate)
root
direc‐
tory
are
restricted
from
simul‐
ta‐
ne‐
ous
mod‐
i‐
fi‐
ca‐
tion
using
lock‐
ing
on
the
file
rel‐
a‐
tive
to
the
root
direc‐
tory
(for
exam‐
ple,
The
com‐
mands
which
mod‐
ify
soft‐
ware
in
a
depot
are
restricted
from
simul‐
ta‐
ne‐
ous
mod‐
i‐
fi‐
ca‐
tion
using
lock‐
ing
on
the
file
rel‐
a‐
tive
to
the
depot
direc‐
tory
(for
exam‐
ple,
All
com‐
mands
set
read
locks
on
roots
and
depots
using
the
file
men‐
tioned
above.
When
a
read
lock
is
set,
it
pre‐
vents
other
com‐
mands
from
per‐
form‐
ing
mod‐
i‐
fi‐
ca‐
tions
(that
is,
from
set‐
ting
write
locks).
The
com‐
mand
is
restricted
from
simul‐
ta‐
ne‐
ous
mod‐
i‐
fi‐
ca‐
tion
of
an
ACL
using
read
and
write
locks
on
the
asso‐
ci‐
ated
with
each
ACL.
AUTHOR
Soft‐
ware
Dis‐
trib‐
u‐
tor
was
devel‐
oped
by
the
Hewlett-
Packard
Com‐
pany.
and
were
devel‐
oped
by
the
Hewlett-
Packard
Com‐
pany
and
Mark
H.
Col‐
burn
(see
pax(1)).
SEE
ALSO
swacl(1M),
swa‐
gentd(1M),
swask(1M),
swcon‐
fig(1M),
swcopy(1M),
swin‐
stall(1M),
swjob(1M),
swlist(1M),
swmod‐
ify(1M),
swpack‐
age(1M),
swreg(1M),
swre‐
move(1M),
swver‐
ify(1M),
swpack‐
age(4),
sd(5).
avail‐
able
at
sd(4)