unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



tarsets(1)							   tarsets(1)



NAME

  tarsets - subset kitting command file	generator

SYNOPSIS

  /usr/lbin/tarsets [-d] pathname

OPTIONS

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

DESCRIPTION

  The tarsets command is used by the kits utility to produce software kits
  for use with the setld(8) utility.  The tarsets command reads	subset inven-
  tory 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 pathname argument	specifies the root directory for the file hierarchy
  containing the files to be kitted in the subset.

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

RESTRICTIONS

  The output command procedure produces	multiple tar files.  Each tar file
  has a	goal size of 400 Kb.  The command procedure is modified	automatically
  to produce a single subset image when	the tarsets utility is called from
  the kits utility.

RETURN VALUES

  0   The tarsets utility has successfully completed.

  1   A	hard link referenced in	the inventory cannot be	found in the input
      hierarchy.

ERRORS

  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 error indicates
      that path2 was deleted from the inventory	after being created by the
      invcutter	command.

  Warning: file	filename is n blocks too large for diskette

  Writing Oversized File Volume...
      These are	obsolete messages and 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

  Commands:
      invcutter(1), kits(1), setld(8)

  Files:
      stl_inv(4)

  Documents:
      Programming Support Tools