Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

invcutter(1) [ultrix man page]

invcutter(1)						      General Commands Manual						      invcutter(1)

Name
       invcutter - 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 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
       -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 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 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

																      invcutter(1)

Check Out this Related Man Page

tarsets(1)						      General Commands Manual							tarsets(1)

Name
       tarsets - subset kitting command file generator

Syntax
       /usr/sys/dist/tarsets [ -d ] pathname

Arguments
       pathname

       Specify the root directory for the file hierarchy containing the files to be kitted in the subset.

Description
       The  command  reads subset inventory records from standard input and writes a command procedure to standard output.  This command procedure
       contains the commands required to create subset images for the subset described in the input.

       The command is used by the utility to produce software kits for use with the utility.

       All error diagnostics are written to the file stderr in the current directory.

Options
       -d     Enable debugging. Debug trace diagnostics are written to ts.dbg in the current directory.

Restrictions
       The output command procedure produces multiple tar files.  Each tar file has a goal size of 400Kb. This is an anachronism from the days	of
       software  distribution  on RX50 diskettes.  The command procedure is modified automatically to produce a single subset image when is called
       from the utility.

Return Values
       The exit status from the command is zero unless a hard link referenced in the input inventory cannot be found in the  input  inventory,	in
       which case the status is 1.

Diagnostics
       Invalid Record on line n
	      The input record on line n is not in subset inventory format.

       path1 -> path2 link reference unresolved.
	      The  input record for path1 contains a pointer to path2 in the referent field and path2 does not appear in the inventory. This indi-
	      cates that path2 was deleted from the inventory after being created by the invcutter command.

       Warning: file filename is n blocks too large for diskette
	      This is an obsolete message. It can be ignored.

       Writing Oversized File Volume...
	      This is an obsolete message. It can be ignored.

       i Blocks, j Chars on Volume k
	      This is an informational message. The number j is the number of characters in the command written to the output to produce volume k.

Files
       stderr Diagnostic output.

       ts.dbg Debug diagnostic output.

See Also
       invcutter(1), kits(1), stl_inv(5), setld(8)
       Guide to Preparing Software for Distribution on ULTRIX Systems

																	tarsets(1)
Man Page