kits(1)kits(1)Namekits - generate setld format distribution kitsSyntax
/usr/sys/dist/kits key-file input-path output-path [ subset... ]
Description
The command produces subset images, inventories, and control files for
an installation using the 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.
The command produces a subset image and a .image file in the output-
path directory for each subset. In the instctrl subdirectory of output-
path, produces an inventory file and a control file. Any subset control
program for the subset is transferred to output-path/instctrl. An
instctrl directory is created if none existed.
Arguments
key-file The path name of the manufacturing key file which
describes the product to be kitted. Unless optional sub‐
set arguments are specified, all subsets listed in the
descriptor section of the key-file are kitted.
input-path The path name which specifies the top of a hierarchy of
files. This hierarchy contains the files which are to be
kitted into subsets.
output-path The name of the directory to be used to store the subset
image and data files produced by the command.
subset... The names of individual subsets can be specified by
optionally listing them on the command line. If they are
specified, only those subsets will be kitted. The pro‐
gram 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.
Restrictions
Any subset control programs to be provided with the kit must be located
in a directory scps in the working directory where the program is
invoked. If no subset control program is found for a subset, an empty
one is created.
Examples
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 hier‐
archy /var/kits/input and place the results in /var/kits/output.
kits ULT400.k /var/kits/input /var/kits/output
The next example shows the same usage, but specifies that only the
ULTACCT400 subset is to be created.
kits ULT400.k /var/kits/input /var/kits/output ULTACCT400
Diagnostics
kits: key-file not found
The program was unable to find the key-file specified on the command
line.
kits: input-path not found
The program was unable to find the specified input-path.
kits: output-path not found
The program was unable to find the specified output-path.
kits: cannot create instctrl directory.
The program cannot create an instctrl directory under output-path.
Check that the user has write permission to output-path.
kits: key-file format error
One of the NAME, CODE, VERS, MI or ROOT values in the specified key-
file is either missing or has a null value.
Inventory file pathname not found
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.
Generating media creation information...failed.
There are no records in the master inventory file for a subset which is
being kitted. Check the master inventory file for correctness of con‐
tent and format.
No such subset in key-file subset subset
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.
compression failed. status = status
The compression option was specified in the key-file and an attempt to
compress a subset failed. This should not happen. Run the program once
more.
Files
temporary files.
log of subset packaging activity
See Alsoinvcutter(1), tarsets(1), stl_comp(5), stl_ctrl(5), stl_image(5),
stl_key(5), stl_mi(5), stl_scp(5), setld(8)
Guide to Preparing Software for Distribution on ULTRIX Systems
kits(1)
