kits - Generates setld format distribution kits
/usr/bin/kits key-file input-path output-path [subset...]
The pathname of the manufacturing key file which describes
the product to be kitted. Unless optional subset arguments
are specified, all subsets listed in the descriptor
section of the key-file are kitted. The pathname which
specifies the top of a hierarchy of files. This hierarchy
contains the files which are to be kitted into subsets.
The name of the directory to be used to store the subset
image and data files produced by the command. The names
of individual subsets can be specified by optionally listing
them on the command line. If they are specified, only
those subsets are kitted. The kits program assumes that
all other subsets for the product have been kitted and
that their images are in the directory specified by output-path.
The key file specified must contain descriptors
for each of the optional named subsets.
The kits command produces subset images, inventories, and
control files for an installation using the setld command.
You need to know the key file which describes the product
to be built, a hierarchy from which the component files to
be kitted are to be taken, and a destination directory
into which the kit information is to be placed.
In the output-path directory, the kits command produces a
subset image file for each subset and a product_code.image
file listing all the kit's subsets. In the instctrl subdirectory
of output-path, kits produces an inventory file
and a control file. The optional subset control program
for any subset in the kit is transferred to outputpath/instctrl.
An instctrl directory is created if none
existed.
Any subset control programs to be provided with the kit
must be located in a directory named scps in the working
directory where the kits program is invoked. If no subset
control program is found for a subset, an empty one is
created.
The kits program was unable to find the key-file specified
on the command line. The kits program was unable to find
the specified input-path. The kits program was unable to
find the specified output-path. The kits program cannot
create an instctrl directory under output-path. Check that
the user has write permission to output-path. One of the
NAME, CODE, VERS, MI or ROOT values in the specified keyfile
is either missing or has a null value. The master
inventory file pathname specified in the MI entry of the
key-file cannot be found. Verify that the pathname is
accessible from the current directory. There are no
records in the master inventory file for a subset which is
being kitted. Check the master inventory file for
correctness of content and format. A subset name specified
on the command line does not have a descriptor line
in the key-file. Check the spelling of the subset name on
the command line. Check the contents of the key-file.
The compression option was specified in the key-file and
an attempt to compress a subset failed. This should not
happen. Run the kits program again.
Produce a kit using key file ULT400.k in the current
directory to package files from the hierarchy
/var/kits/input, and place the results in /var/kits/output.
kits OAT100.k /var/kits/input /var/kits/output
Produce a kit using key file ULT400.k in the current
directory to package files from the hierarchy
/var/kits/input, and place the results in /var/kits/output,
but create only the OATDCB100 subset. kits OAT100.k
/var/kits/input /var/kits/output OATDCB100
Log of subset packaging activity
invcutter(1), newinv(1), tarsets(1), setld(8) stl_comp(4),
stl_ctrl(4), stl_image(4), stl_key(4), stl_mi(4),
stl_scp(4) Guide to Preparing Product Kits
kits(1)
[ Back ] | 