.TH kits 1.SH Namekits \- generate setld format distribution kits.SH Syntax.B /usr/sys/dist/kits .I key-file.I input-path.I output-path[.I subset...].SH Description.NX R "setld" "format distribution kits".NX R "kits" "setld format distribution kits"The.PN kitscommand produces subset images, inventories, and control filesfor an installation using the.PN setldcommand. 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 tobe taken, and a destination directory into which the kit information is tobe placed..PPThe.PN kitscommand produces a subset image and a .image filein the.I output-pathdirectory for each subset. In the.I instctrlsubdirectory of.I output-path,.PN kitsproduces an inventory file and a control file. Any subsetcontrol program for the subset is transferred to.I output-path/instctrl.An.I instctrldirectory is created if none existed..SH Arguments.TP 15.I key-fileThe path name of the manufacturing key file which describes theproduct to be kitted. Unless optional.I subsetarguments are specified, all subsets listed in the descriptorsection of the.I key-fileare kitted..TP.I input-pathThe path name which specifies the top of a hierarchy of files. Thishierarchy contains the files which are to be kitted into subsets..TP.I output-pathThe name of the directory to be used to store the subset image anddata files produced by the command..TP.I subset...The names of individual subsets can be specified by optionally listing themon the command line. If they are specified,only those subsets will be kitted. The.PN kitsprogram assumes that all other subsets for the product have been kittedand that their images are in the directory specified by.I output-path.The key file specified must contain descriptors for each of theoptional named subsets..SH RestrictionsAny subset control programs to be provided with the kit must be locatedin a directory.I scpsin the working directory where the.PN kitsprogram is invoked. If no subset control program is found for a subset,an empty one is created..SH ExamplesThe following example shows the command used to produce a kit usingkey file.I ULT400.kin the current directoryto package files from the hierarchy.I /var/kits/inputand place the results in.I /var/kits/output..EX    kits ULT400.k /var/kits/input /var/kits/output.EEThe next example shows the same usage, but specifies that only theULTACCT400 subset is to be created..EX    kits ULT400.k /var/kits/input /var/kits/output ULTACCT400.EE.SH Diagnostics.B kits: .I key-file.B not found.brThe.PN kitsprogram was unable to find the.I key-filespecified on the command line..PP.B kits: .I input-path.B not found.brThe.PN kitsprogram was unable to find the specified.I input-path..PP.B kits: .I output-path.B not found.brThe.PN kitsprogram was unable to find the  specified.I output-path..PP.B kits: cannot create instctrl directory..brThe.PN kitsprogram cannot create an instctrl directory under.I output-path.Check that the user has write permission to.I output-path..PP.B kits: .I key-file.B format error.brOne of the NAME, CODE, VERS, MI or ROOT values in the specified.I key-fileis either missing or has a null value..PP.B Inventory file.I pathname.B not found.brThe master inventory file.I pathnamespecified in the MI entry of the.I key-filecannot be found. Verify that the.I pathnameis accessible from the current directory..PP.B "Generating media creation information...failed.".brThere are no records in the masterinventory file for a subset which is being kitted.Check the master inventory file for correctness of contentand format..PP.B No such subset in.I key-file.B subset.I subset.brA subset name specified on the command line does not havea descriptor line in the.I key-file.Check the spelling of the subset name on the command line.Check the contents of the.I key-file..PP.B "compression failed. status =".I status.brThe compression option was specified in the.I key-fileand an attempt to compress a subset failed. Thisshould not happen. Run the.PN kitsprogram once more..SH Files.TP 15.PN ts.subset*temporary files..TP.PN stderrlog of subset packaging activity.SH 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).br\fIGuide to Preparing Software for Distribution on ULTRIX Systems\fP