Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

newinv(1) [ultrix man page]

newinv(1)						      General Commands Manual							 newinv(1)

Name
       newinv - update distribution kit master inventory

Syntax
       /usr/sys/dist/newinv mi-file input-path

Description
       The  command  interactively maintains the master inventory files used for producing distributions in format. The program updates the master
       inventory for a product when changes are made to the hierarchy of files which are to be packaged in the subsets which constitute the  prod-
       uct.

       The  product  hierarchy	is  scanned to produce a list of component path names relative to input-path.  The list of path names is processed
       against the mi-file to produce a list of those files which have been removed from the product hierarchy and a list  of  those  files  which
       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,  is  used.	 When editing the list of files which 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 record from the file. When editing the list of files  which	have  been
       added to the product, the user is expected to provide flags and subset information for each new file, transforming the elements of the list
       into master inventory records.

       Both of these lists are merged with the records for the files which have not been changed to produce a new copy	of  the  master  inventory
       file.

   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 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 will be processed as belonging in the inventory.

Restrictions
       The default text editor if not specified in $EDITOR is

       Files  in the product hierarchy cannot be excluded from the master inventory. Files can be blocked from being kitted in the final distribu-
       tion kit by setting the subset field of the master inventory record to NOSHIP.

Examples
       To update the master inventory file ULT400.mi from the hierarchy beginning at /var/kits/input, type:
	   newinv ULT400.mi /var/kits/input

Diagnostics
       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
       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
       kits(1), vi(1), stl_mi(5), environ(7), setld(8)
       Guide to Preparing Software for Distribution on ULTRIX Systems

																	 newinv(1)

Check Out this Related Man Page

invcutter(1)						      General Commands Manual						      invcutter(1)

NAME
invcutter - Generates a subset inventory file SYNOPSIS
/usr/lbin/invcutter [-d] [-f root-path] [-v version-code] OPTIONS
Enables debugging. No useful diagnostics are printed. Specifies an alternate root path for finding file attribute information. Specifies a 3-digit version code for use in the version field of the output records. The default version code is 010. DESCRIPTION
The contents of a software product kit for the setld(8) command are specified by a master inventory file whose format is described in the stl_mi(4) reference page. The invcutter command processes a master inventory file by reading inventory records from standard input and writing one record to standard output for each record read. The information contained in the output record is derived from the input record and from the file attribute information in the file hierar- chy rooted in the current directory. RESTRICTIONS
Input records must be sorted in ascending ASCII order on the pathname field. The invcutter command cannot process input-specified files which exist as sockets in the file hierarchy. If an input-specified file has a link count greater than 1, all other links to the file must be represented in the input. RETURN VALUES
An exit status of 0 indicates success. An exit status of 1 indicates an error. See ERRORS. ERRORS
The program cannot set its working directory to the pathname directory specified with the -f option. The error-message provides additional information. The nth input record is not in the correct sort order. All input records must be in ascending ASCII collating sequence on the pathname field. An error has occurred attempting to read the attributes of filename. The error-message explains exactly what happened. The file named by pathname is a socket. Sockets are not supported as valid file types for distribution. File pathname in the master inventory is linked to n files which do not appear in the master inventory. Check the inventory for validity with the newinv program. This informational message states how many files with unresolved links were detected in the input inventory. EXAMPLES
The following command generates inventory records for the master inventory entries in PDS020.mi. Output records contain version fields set to 020: invcutter -v 020 < PDS020.mi SEE ALSO
Commands: kits(1), newinv(1) Files: stl_inv(4), stl_mi(4) Guide to Preparing Product Kits invcutter(1)
Man Page