unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



newinv(1)							    newinv(1)



NAME

  newinv - Updates distribution	kit master inventory

SYNOPSIS

  /usr/bin/newinv mi-file input-path...

OPERANDS

  mi-file
      The pathname of the master inventory file	to be processed.  If no	mas-
      ter inventory file exists, you must create an empty one before using
      the newinv command.

  input-path
      The name of the product hierarchy	to be scanned for files	belonging in
      the inventory.  All files	and directories	found below the	input-path
      are processed as belonging in the	inventory.

DESCRIPTION

  The newinv command interactively maintains the master	inventory files	used
  for producing	distribution kits in setld format.  The	program	updates	the
  master inventory for a product when changes are made to the hierarchy	of
  files	that are to be packaged	in the subsets which constitute	the product.

  The product hierarchy	is scanned to produce a	list of	component path names
  relative to input-path. The list of pathnames	is processed against the mi-
  file to produce a list of files that have been removed from the product
  hierarchy and	a list of files	that have been added.

  The user is then given an opportunity	to intervene and direct	the inventory
  maintenance by editing these lists.  The user	is placed in the editor	with
  each list available for editing.  The	editor used is the one specified by
  the EDITOR environment variable.  If EDITOR is not set, vi is	used.  When
  editing the list of files that have been removed from	the product, the user
  is expected to verify	that the removals were intentional and confirm the
  intent by removing the associated records from the file.  When editing the
  list of added	files, the user	is expected to provide options and subset
  information for each new file, transforming the elements of the list into
  master inventory records.

  To produce a new copy	of the master inventory	file, both of these lists are
  merged with the records for the files	which existed in the previous version
  and are still	included.








RESTRICTIONS

  The default text editor, if not specified in $EDITOR,	is /usr/ucb/vi.


  Files	in the product hierarchy cannot	be excluded from the master inven-
  tory.	 Files can be blocked from being kitted	in the final distribution kit
  by setting the subset	field of the master inventory record to	a minus	sign
  (-).

ERRORS

  newinv: where	is mi-file?
      The mi-file specified on the command line	cannot be found.

  input-path: bad directory.
      The input-path directory specified on the	command	line does not exist.

EXAMPLES

  To update the	hypothetical master inventory file OAT100.mi from the hierar-
  chy beginning	at /var/kits/input, type:

       newinv OAT100.mi	/var/kits/input

FILES

  mi-file.bkp
      Backup copy of master inventory

  mi-file.dead
      The list of files	missing	from the product

  mi-file.extra
      The list of files	new to the product

  mi-file.join
      Intermediate join	file

  mi-file.tmp
      List of all files	in the product

SEE ALSO

  Commands:
      invcutter(1), kits(1), vi(1), setld(8)

  Files:
      stl_mi(4)

  Conventions:
      environ(5)

  Documents:
      Guide to Preparing Product Kits