NAME    [Toc]    [Back]

       newinv - Updates distribution kit master inventory

SYNOPSIS    [Toc]    [Back]

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

OPERANDS    [Toc]    [Back]

       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.  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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The mi-file specified on the command line cannot be found.
       The  input-path  directory  specified  on the command line
       does not exist.

EXAMPLES    [Toc]    [Back]

       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    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

       invcutter(1),  kits(1),  vi(1),  setld(8)  stl_mi(4) environ(5) Guide to Preparing Product Kits



                                                        newinv(1)