Index Click this button to go to the index for this section.


newinv(1)

NAME

newinv - Updates distribution kit master inventory

SYNOPSIS

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

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

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

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

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.

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

RELATED INFORMATION

Commands: kits(1), vi(1), setld(8) Files: stl_mi(4) Conventions: environ(5) Documents: Guide to Preparing Product Kits