*** UNIX MANUAL PAGE BROWSER ***

kits(1) General Commands Manual kits(1) NAME kits - Generates setld format distribution kits SYNOPSIS /usr/bin/kits key-file input-path output-path [ subset... ] 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 di- rectory 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. PARAMETERS key-file The pathname of the manufacturing key file which de- scribes 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 pathname 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 op- tionally listing them on the command line. If they are specified, only those subsets are kitted. The kits 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 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. 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 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 cre- ated. kits OAT100.k /var/kits/input /var/kits/output OATDCB100 ERRORS kits: key-file not found The kits program was unable to find the key-file specified on the command line. kits: input-path not found The kits program was unable to find the specified input-path. kits: output-path not found The kits program was unable to find the specified output-path. kits: cannot create instctrl directory The kits 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 acces- sible 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 cor- rectness of content and format. No such subset in key-file subset subset A subset name specified on the command line does not have a de- scriptor 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 at- tempt to compress a subset failed. This should not happen. Run the kits program again. FILES stderr Log of subset packaging activity RELATED INFORMATION 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) Documents: Guide to Preparing Product Kits delim off kits(1)