invcutter(1)invcutter(1)Nameinvcutter - generate subset inventory files
Syntax
/usr/sys/dist/invcutter [ -d ] [ -f root-path ] [ -f version-code ]
Description
The command reads master inventory records from standard input. A sub‐
set 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-d Enable debugging. No useful diagnostics are
printed.
-f root-path Specify an alternate root path for finding file
attribute information.
-v version-code Specify a 3-digit version code for use in the ver‐
sion field of the output records. The default ver‐
sion 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 speci‐
fied 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 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 Alsonewinv(1), stl_inv(5), stl_mi(5)
Guide to Preparing Software for Distribution on ULTRIX Systems
invcutter(1)