Content-type: text/html
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
output-path/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
key-file
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.
The following example shows the command used to 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 The next example shows the same usage, but specifies that only the OATDCB100 subset is to be created. kits OAT100.k /var/kits/input /var/kits/output OATDCB100
Log of subset packaging activity
Commands: invcutter(1), tarsets(1), setld(8)
Files: stl_comp(4), stl_ctrl(4), stl_image(4), stl_key(4), stl_mi(4), stl_scp(4)
Guide to Preparing Product Kits