kits(1)kits(1)NAMEkits - Generates setld format distribution kitsSYNOPSIS
/usr/bin/kits key-file input-path output-path [subset...]
OPERANDS
The pathname of the manufacturing key file which describes the product
to be kitted. Unless optional subset arguments are specified, all sub‐
sets listed in the descriptor section of the key-file are kitted. The
pathname which specifies the top of a hierarchy of files. This hierar‐
chy 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 speci‐
fied by optionally listing them on the command line. If they are spec‐
ified, 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 sub‐
sets.
DESCRIPTION
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 pro‐
duces an inventory file and a control file. The optional subset con‐
trol program for any subset in the kit is transferred to output-
path/instctrl. An instctrl directory is created if none existed.
RESTRICTIONS
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 pro‐
gram is invoked. If no subset control program is found for a subset,
an empty one is created.
ERRORS
The kits program was unable to find the key-file specified on the com‐
mand 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 speci‐
fied 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 kit‐
ted. 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 compres‐
sion option was specified in the key-file and an attempt to compress a
subset failed. This should not happen. Run the kits program again.
EXAMPLES
Produce a kit using key file ULT400.k in the current directory to pack‐
age 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 pack‐
age 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
FILES
Log of subset packaging activity
SEE ALSOinvcutter(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)