stl_inv(4) [osf1 man page]
stl_inv(4) Kernel Interfaces Manual stl_inv(4) NAME
stl_inv - setld inventory file format DESCRIPTION
Each software product that is distributed as subsets for the setld(8) command has an associated inventory file. This inventory file is created by the kits(1) utility. The inventory file's name consists of the product's unique 3-letter name with the string .inv for a suf- fix. The inventory file contains one record for each subset in the kit. Each record contains the following twelve fields in order, sepa- rated by TAB characters: Flags The per-file software management flag, a 16-bit unsigned integer Size The actual number of bytes in the file Checksum The modulo-65536 checksum of the file. Hard links, directories, FIFOs, and sockets have 00000 in this field. uid The user ID of the file's owner gid The group ID of the file's owner Mode The 6-digit octal representation of the file's mode Date The file's last modification date Revision The version code of the product that includes the file Type A letter that describes the file: b Block device c Character device d Directory containing one or more files f Regular file. For regular files with a link count greater than one, see file type l. l Hard link. There are other files in the same inventory which have the same inum. The first of these files in ASCII collating sequence is listed in the referent field. p Named pipe (FIFO) s Symbolic link = UNIX domain socket Pathname The dot-relative (./) pathname of the file Link-to For file types l and s, the path to which the file is linked; for types b and c, an integer representing the major and minor num- bers of the device; for all other types, none Subset name The name of the subset containing the file RESTRICTIONS
Fields must be separated by TAB characters. RELATED INFORMATION
Commands: setld(8) Functions: stat(2) Documents: Guide to Preparing Product Kits delim off stl_inv(4)
Check Out this Related Man Page
newinv(1) General Commands Manual newinv(1) NAME
newinv - 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 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
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 pre- vious 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 distribu- tion 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 ALSO
invcutter(1), kits(1), vi(1), setld(8) stl_mi(4) environ(5) Guide to Preparing Product Kits newinv(1)