invcutter(1)invcutter(1)NAMEinvcutter - 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 hier‐
archy 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 hap‐
pened. The file named by pathname is a socket. Sockets are not sup‐
ported as valid file types for distribution. File pathname in the mas‐
ter 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 inven‐
tory 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)