newinv(1)newinv(1)NAMEnewinv - Updates distribution kit master inventory
SYNOPSIS
/usr/bin/newinv mi-file input-path...
OPERANDS
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. 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 consti‐
tute 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 distri‐
bution kit by setting the subset field of the master inventory record
to a minus sign (-).
ERRORS
The mi-file specified on the command line cannot be found. 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
Backup copy of master inventory The list of files missing from the
product The list of files new to the product Intermediate join file
List of all files in the product
SEE ALSOinvcutter(1), kits(1), vi(1), setld(8)stl_mi(4)environ(5) Guide to
Preparing Product Kits
newinv(1)