Index SD-UX Mkpkg Mkbdl Glossary
SD-UX elements: bundle product subproduct fileset vendor

Filesets

  1. Overview
  2. Fields
    1. SD-UX Attributes
    2. Mkpkg Attributes
    3. Control Scripts

Overview

Filesets are the atomic unit of installation in Software Distributor. A fileset contains three basic types of information: meta-data, control scripts, and files.

Fields

There are two types of fields displayed by mkpkg: Software distributor attributes, and Mkpkg attributes. Software distributor attributes are simply passed trough to swpackage by mkpkg. Mkpkg attributes are used by mkpkg to assist it in the various stages of package development and are used to compute various software distributor attributes.

SD-UX Attributes

tag
The identifier for the fileset. It appears on the Software Selection window as the basic name for the fileset.

There are conventions for fileset names which should be followed. A brief description of the conventions is included here, but for more information please see the HP Guidelines or the HP-UX Porting and Archive Centre Guidelines.

base-RUN The run-time fileset for base. If base is entirely in the execution environment, the -RUN suffix may be omitted (just name the fileset base). If the product's execution environment mus tbe broken into smaller pieces for configurability, use -MIN and -AUX as follows.
base-MIN The minimum runtime fileset for base
base-AUX Auxiliary files for base other than those in base-MIN
base-SHLIBS Shared library files for base
base-HELP On-line help files.
base-KRN Files need only to build a kernel. Can be removed after a kernel is built
base-PRG Programming environment for base, exluding the files in base-KRN. If the header files base programming are small in size, include them in this fileset
base-INC If the header files for base programming must be placed in a separate fileset, use base-INC
base-MAN The manual entries associated with base. If the release notes for this product are small in size, include them in this fileset
base-DEMO Files neede to run a demo for base
base-NOTES The release notes for this product (if any). This fileset should only be defined if the release notes are fairly large, otherwise include the release notes in the base-MAN fileset
limit 16 characters. Type tag_string/version_component
title
The one-line, more detailed name for the fileset. It appears on the Software Selection window. This attribute will be seen often so it should clearly and consisely describe the fileset.

limit 80 characters. Type one_line_string

description
A file or text string describing the fileset. The free-form ASCII style allows for a detailed description of your software.

limit 2kB characters. limit 72 characters/line. Do not use <TAB> characters. Type multi_line_string

copyright
A file or text string describing the copyright restrictions for the product. This is required for legal reasons.

limit 8kB characters. limit 72 characters/line. Do not use <TAB> characters. Type multi_line_string

readme
A file describing the fileset.

limit 1MB characters. limit 72 characters/line. Do not use <TAB> characters. Type multi_line_string

revision
The revision (release) number of the fileset. The revision field is a string consisting of a series of dot-separated fields. Revision numbers are often compared to determine relative position within release cycles. The basic strategy for comparison is:
  1. field by field, left to right
  2. smaller "numbers" specify older revisions
  3. ASCII comparison (0 number comparison (shorter numbers padded with trailing 0s), if the revision number contains only digits
Type revision_string/version_component
ancestor
List of filesets that have the same functionality but different names in previous software product revision(s). Unsed only when product's fileset structure changes. This information is used by the Match What I Have feature of SD-UX to select the filesets from the new version of the product that will make the system look as close to the old one as possible.

Type software_specification

is_kernel
Boolean attribute that is TRUE iff the fileset contains OS kernel files.

Type boolean

is_reboot
Boolean attribute that is TRUE iff the fileset requires a reboot after installation.

Type boolean

is_secure
Boolean attribute that is true iff the fileset is secured by encrypting every file in the fileset. If the fileset is contained in any CPL-product bundle for which is_protected is set to FALSE, then is_secure must also be FALSE.

Type boolean

prerequisite
List of filesets that which must be installed (configured) before this fileset can be installed (configured).

NOTE: Please specify all prerequisites as filesets. Do not depend on a subproduct, product, or bundle. There are some auxiliary tools that require all dependencies to be expressed as filesets.

Type software_specification

corequisite
List of filesets that which must be configured before this fileset can operate correctly. Filesets that include executables utilized by this package are an example of a corequisite dependency. For example, a fileset including perl would depend on perl as a corequisite.

Shared library dependencies are a form of corequisite dependency. Mkpkg automatically detects these dependencies and includes them in the package. See shared_libraries for more information.

NOTE: Please specify all corequisites as filesets. Do not depend on a subproduct, product, or bundle. There are some auxiliary tools that require all dependencies to be expressed as filesets.

Type software_specification

Mkpkg Attributes

files
List of files to be installed by the fileset
links
List of files which are hard-linked. Each pair of files shows a link. This is useful for examining the fileset to see if hard links span directories and are likely to cause problems on remote machines with different physical file system partitioning.
symlinks
List of files which are symlinks along with their targets. This is useful for finding symlinks which are likely to break if the software is relocated by the user.
shared_libraries
List of shared libraries distributed as part of this fileset. This list is later utilized by mkpkgduring the automatic detection of shared library dependencies
shared_library
List of dependencies caused by executables linking with shared libraries in other filesets. This list is automatically generated by mkpkg.

Control Scripts

Filesets may have control scripts which are executed during various phases of software installation/deinstallation. Both products and filesets may have associated control scripts. SD-UX defines a standard set of control script attributes and functions. For more information, please see Control Scripts.
(C) Copyright 1994, 1995, 1996 Hewlett-Packard Company