Index Index for
Section 1
Index Alphabetical
listing for K
Bottom of page Bottom of
page		 

kits(1)


NAME

  kits - Generates setld format distribution kits


SYNOPSIS

  /usr/bin/kits key-file input-path output-path [subset...]


OPERANDS

  key-file
      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.

  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 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.


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 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.


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 program is
  invoked.  If no subset control program is found for a subset, an empty one
  is created.


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 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
      content 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 kits program
      again.


EXAMPLES

  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

  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, but create only the OATDCB100 subset.

       kits OAT100.k /var/kits/input /var/kits/output OATDCB100


FILES

  stderr
      Log of subset packaging activity


SEE ALSO

  Commands:
      invcutter(1), newinv(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

Index Index for
Section 1
Index Alphabetical
listing for K
Top of page Top of
page