swpackage.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

swpackage(1M) swpackage(1M)

NAME

swpackage - package software products into a target depot or tape

SYNOPSIS

swpackage [-p][-v][

-V][-C session_ﬁle ][-d directory |device ][-f software_ﬁle ]

[

-s product_speciﬁcation_ﬁle|directory ][

-S session_ﬁle ][

-x option=value ][-X option_ﬁle ]

[software_selections][

@ directory |device ]

Remarks

• For a description of the Product Speciﬁcation File (PSF) used as input to the

swpackage command,

see the swpackage (4) man page by typing

man 4 swpackage on the command line.

• For an overview of all SD commands, see the sd(5) man page by typing

man5sdon the command

line.

• For descriptions of all SD objects, attributes and data formats, see the sd(4) man page by typing

man

4sdon the command line.

DESCRIPTION

The

swpackage command is not distributed; it only operates on the local host. It packages software

products 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.

NOTE:

swpackage treats everything following -d and @ as the path to the directory |device .If

swpackage -d string1:/string2 -s <psf>

swpackage -s <psf> @ string1:/string2

is entered, swpackage will not treat string1 as if it is a hostname as other Software Distributor

commands do. string1 is treated as part of the path.

A software product is organized into a three-level hierarchy: products , subproducts , and ﬁlesets . The

actual ﬁles that make up a product are packaged into ﬁlesets. Subproducts can be used to partition or

subset the ﬁlesets into logical groupings. (Subproducts are optional.) A product, subproduct, and ﬁleset

also have attributes associated with them.

Both directory and tape distributions use the same format. The

swpackage command:

• Organizes the software to be packaged into products, subproducts, and ﬁlesets,

• Provides ﬂexible mechanisms to package source ﬁles into ﬁlesets,

• Modiﬁes existing products in a distribution directory,

• Copies products in a distribution directory to a distribution tape.

Both the

swpackage and swcopy commands create or modify a target depot. The differences between

these commands are:

• The

swcopy command copies products from an existing depot to another depot. The swpackage

command creates products based on the user’s speciﬁcation, and packages these products into a depot.

•

swpackage can be used to re-package software_selections from an existing distribution directory to a

distribution tape.

• The

swcopy command can copy from a local or remote source to a set of local or remote targets. The

swpackage command packages source ﬁles from the local ﬁlesystem into a product, for insertion into

a local distribution directory or tape.

• After creating a target depot,

swcopy registers that directory with the local swagentd so that it

can be found by swlist, swinstall, etc. With swpackage, the depot is not registered; the user

must explicitly invoke the swreg command.

Layout Version

By default, SD object and attribute syntax conforms to the layout_version 1.0 speciﬁcation of the IEEE

POSIX 1387.2 Software Administration standard. SD commands still accept the keyword names associ-

ated with the older layout version 0.8, but you should use the older version only to create distributions

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (12 pages)

PAGE 1
swpackage(1M) swpackage(1M) NAME swpackage - package software products into a target depot or tape SYNOPSIS swpackage [-p] [-v] [-V] [-C session_file ] [-d directory |device ] [-f software_file ] [-s product_specification_file |directory ] [-S session_file ] [-x option=value ] [-X option_file ] [software_selections] [@ directory |device ] Remarks • For a description of the Product Specification File (PSF) used as input to the swpackage command, see the swpackage (4) man page by typing man 4 swpackage on
PAGE 2
swpackage(1M) swpackage(1M) readable by older versions of SD. Which layout_version the SD commands write is controlled by the layout_version option or by specifying the layout_version attribute in the PSF file. See sd(4), the description of the layout_version option in the following section and in sd(5) for more information. See sd(4) for more information on PSF files.
PAGE 3
swpackage(1M) swpackage(1M) bundle [.product [.subproduct ][.fileset ]][,version ] product [.subproduct ][.fileset ][,version ] • You can specify selections with the following shell wildcard and pattern-matching notations: [ ], *, ? • Bundles and subproducts are recursive. Bundles can contain other bundles and subproducts can contain other subproducts . • The \* software specification selects all products. Use this specification with caution.
PAGE 4
swpackage(1M) swpackage(1M) $HOME/.swdefaults the user-specific default values. Values must be specified in the defaults file using this syntax: [command_name .]option =value The optional command_name prefix denotes one of the SD commands. You can also override default values from the command line with the -x or -X options: command -x option =value command -X option_file The following section lists all of the keywords supported by swpackage and swcopy.
PAGE 5
swpackage(1M) swpackage(1M) compress_cmd=/usr/contrib/bin/gzip Defines the command called to compress files before installing, copying or packaging. If the compression_type option is set to other than gzip or compress, this path must be changed. compress_files=false If set to true, uncompressed files are compressed before transfer from a source.
PAGE 6
swpackage(1M) swpackage(1M) the packaged products. A value of true for this keyword causes swpackage to follow symbolic links in the package source files and include the files they reference in the packaged products. include_file_revisions=false Do not include each source file’s revision attribute in the products being packaged. Because this operation is time consuming, by default the revision attributes are not included.
PAGE 7
swpackage(1M) swpackage(1M) the disk up to minfree for a disk file. SD uses the same format across multiple directory media as it does for multiple serial media, including calculations of the correct size based partitioning of filesets and setting of the media_sequence_number attributes. media_type=directory Defines the type of distribution to create. The recognized types are directory and tape.
PAGE 8
swpackage(1M) swpackage(1M) source_file=psf Defines the default location of the source product specification file (PSF). The host:path syntax is not allowed, only a valid path can be specified. The -s option overrides this value. source_type=directory Defines the default source type: cdrom, file, directory, or tape. The source type derived from the -s option overrides this value. targets= Defines the default target_selections. There is no supplied default.
PAGE 9
swpackage(1M) swpackage(1M) LC_ALL Determines the locale to be used to override any values for locale categories specified by the settings of LANG or any environment variables beginning with LC_. LC_CTYPE Determines the interpretation of sequences of bytes of text data as characters (for example, single versus multibyte characters in values for vendor-defined attributes). LC_MESSAGES Determines the language in which messages should be written.
PAGE 10
swpackage(1M) swpackage(1M) ... If errors encountered while parsing the PSF result in no valid product definitions, swpackage terminates. All errors are logged to both stderr and the logfile. In summary, the swpackage user can: • • • • • • • • • Specify one or more products; For each product, specify one or more filesets. For each fileset, specify one or more files.
PAGE 11
swpackage(1M) swpackage(1M) $HOME/.sw/sessions/ Contains session files automatically saved by the SD commands, or explicitly saved by the user. /usr/lib/sw/sys.defaults Contains the master list of current SD options with their default values. /var/adm/sw/ The directory which contains all of the configurable and non-configurable data for SD. This directory is also the default location of logfiles. /var/adm/sw/defaults Contains the active system-wide default values for some or all SD options.
PAGE 12
(Notes) A (Notes) sA 12 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010