HP-UX Reference (11i v3 07/02) - 4 File Formats (vol 8)

s
swpackage(4) swpackage(4)
NAME
swpackage - product specification file (PSF) format
DESCRIPTION
Introduction
The swpackage command packages software into:
• a distribution directory (which can be accessed directly or copied onto a CD-ROM),
• a distribution tape, such as DDS, nine-track or cartridge tapes.
Both directory and tape distributions use the same format. SD can read both
tar and cpio tape depots.
See sd(4) for details on tape format.
The software is organized into a four-level hierarchy of software objects: bundles, products, subpro-
ducts, and filesets. Bundles and subproducts are recursive: a bundle can contain other bundles, and a
subproduct can contain other subproducts. The files that make up a software package are contained in
filesets. Filesets are contained in subproducts and/or products. Currently, HP does not support customer
creation of software bundles to contain the entire application. The attribute tables that follow show the
attributes of each level of the software packaging hierarchy.
A Product Specification File (PSF) defines how a product is structured and the attributes that apply to
it. This manual page describes the syntax and semantics of a PSF.
Layout Version
SD object and attribute syntax conforms to the layout_version 1.0 specification of the IEEE POSIX 1387.2
Software Administration standard. The previous SD layout_version 0.8 is also supported. SD for HP-UX
version 10.10 and later can read or write either layout version. SD commands still accept the keyword
names associated with the older layout version, but you should use layout_version 0.8 only to create distri-
butions readable by older versions of SD.
What layout_version the SD commands write is controlled by the
layout_version option for swpack-
age
, swmodify, swcopy, and swlist.
The version used by swpackage can be also controlled by specifying the layout_version attribute in the
PSF. However, if the layout_version attribute in the PSF is 1.0, the is_locatable attribute defaults to true
in all cases, and must be explicitly set to false.
For a full description of the
swpackage command, see the swpackage(1M) manual page.
Layout version 1.0 adds significant functionality not recognized by systems supporting only 0.8, including:
• Category class objects (formerly the category and category_title
attributes within the
bundle or product class).
• Patch-handling attributes, including
applied_patches, is_patch, and patch_state .
• The fileset
architecture attribute, which permits you to specify the architecture of the target
system on which the product will run.
In addition to adding new attributes and objects, layout_version 1.0 changes the following preexisting 0.8
objects and attributes as follows:
• Replaces the depot media_sequence_number with the media object with a
sequence_number attribute.
• Replaces the vendor definition within products and bundles with a vendor_tag attribute and a
corresponding vendor object defined outside the product or bundle.
• Pluralizes the corequisite and prerequisite fileset attributes (to corequisites and
prerequisites ).
• Changes the timestamp attribute to mod_time.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 441