Index for Section 1

Alphabetical listing for N

Bottom of page

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
      master 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
  inventory.  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
  hierarchy 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

Index for Section 1

Alphabetical listing for N

Top of page