Name

invcutter − generate subset inventory files

Syntax

/usr/sys/dist/invcutter [ −d ] [ −f root-path ] [ −f version-code ]

Description

The invcutter command reads master inventory records from standard input. A subset inventory record is written to standard output for every record read from the input. The information contained in the output record is derived from the input record and the file attribute information in the file hierarchy rooted in the current directory.

Options

−dEnable debugging. No useful diagnostics are printed. 

−f root-pathSpecify an alternate root path for finding file attribute information. 

−v version-codeSpecify a 3-digit version code for use in the version field of the output records. The default version code is 010. 

Restrictions

All input records must be sorted in ascending order on the pathname field. 

Files described in an input record which exist as sockets in the file hierarchy are not processable. 

If a file is described in an input record has a link count greater than 1, all other links to the file must be represented in the input. 

Examples

The following command will generate inventory records for the master inventory entries in PDS020.mi containing version fields set to 020:

    invcutter −v 020 < PDS020.mi

Return Values

An exit status of 0 is returned if all goes well. An exit status of 1 is returned if an error occurs. See Diagnostics. 

Diagnostics

"cannot chdir to pathname (error-message)"
The program cannot change directories to the pathname directory specified with the −f option. The error-message will provide 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 colating sequence on the pathname field. 

"cannot stat filename (error-message)"
An error has occurred attempting to read the attributes of filename.  The error-message explains exactly what happened. 

"pathname: illegal file type code 0140000"
The file pathname is a socket. Sockets are not supported as valid file types for distribution. 

"unresolved nlink n: pathname"
This indicates that file pathname in the master inventory is linked to n files which do not appear in the master inventory. Check inventory for validity with the newinv program.

"n unresolved hard links"
This is an informational message stating how many files were detected in the input inventory which had unresolved links.

See Also

newinv(1), stl_inv(5), stl_mi(5)
Guide to Preparing Software for Distribution on ULTRIX Systems