unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



kits(1)								      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 sub-
      sets 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 descrip-
      tors 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 com-
  ponent 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 sub-
  sets.	 In the	instctrl subdirectory of output-path, kits produces an inven-
  tory 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	com-
      mand 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	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 com-
      mand 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