*** UNIX MANUAL PAGE BROWSER ***

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 ] FLAGS -d Enables debugging. No useful diagnostics are printed. -f root-path Specifies an alternate root path for finding file at- tribute information. -v version-code Specifies a 3-digit version code for use in the ver- sion field of the output records. The default ver- sion 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 in- ventory file by reading inventory records from standard input and writ- ing one record to standard output for each record read. The information contained in the output record is derived from the in- put 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. EXAMPLES The following command generates inventory records for the master inven- tory entries in PDS020.mi. Output records contain version fields set to 020: invcutter -v 020 < PDS020.mi RETURN VALUES An exit status of 0 indicates success. An exit status of 1 indicates an error. See ERRORS. ERRORS cannot chdir to pathname (error-message) The program cannot set its working directory to the pathname di- rectory specified with the -f flag. The error-message provides additional information. sort error, record #n The nth input record is not in the correct sort order. All input records must be in ascending ASCII collating sequence on the path- name field. cannot stat filename (error-message) An error has occurred attempting to read the attributes of file- name. The error-message explains exactly what happened. pathname: illegal file type code 0140000 The file named by pathname is a socket. Sockets are not supported as valid file types for distribution. unresolved nlink n : pathname 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. n unresolved hard links This informational message states how many files with unresolved links were detected in the input inventory. RELATED INFORMATION Commands: newinv(1) Files: stl_inv(4), stl_mi(4) Documents: Guide to Preparing Product Kits delim off invcutter(1)