NAME

ClearCase::Ct - general-purpose wrapper for cleartool program

SYNOPSIS

See also "perldoc ClearCase::Ct::Profile" and "perldoc `whence ct`".

ClearCase::Ct provides service functions and global constants to the ct wrapper program and the ClearCase::Ct::Profile module.

DESCRIPTION

Exported functions:

• Dbg($string, $level)

  Standard debugging routine. Takes two scalar args: a string to print, plus an optional number of stack frames to go backwards before reporting line number and file data.

• Die($string)

  Die with a standard error msg format. Same behavior as die() otherwise.

• Warn($string)

  Warn with a standard error msg format. Same behavior as warn() otherwise.

• Exec(LIST)

  A wrapper for exec() which handles printing of debug and exec-fail msgs. Also works around a Win32/5.004 bug in exec().

• System(LIST)

  A wrapper for system() which handles printing of debug tracing. Dies automatically on command failure in void context.

• Qx(LIST)

  A replacement for `cmd` with no shell needed, as suggested in Camel5. Also more secure in setuid usage. Made available here for use in profiles.

• Prompt(LIST)

  Run clearprompt with specified args and return results. Temp file creation/removal is handled here automatically. NOTE: the -prompt <string> argument must come last so we can quote it appropriately to deal with the remarkably lame NT shell.

• Option Parsing

  This is a set of functions based on Getopt::Long::GetOptions():

  1. ReadOptions(\@ARGV, LIST)

  Works much like GetOptions but does not modify the referenced \@ARGV - it's a lookahead option processor.

  2. StripOptions(\@ARGV, LIST)

  Parse and strip the specified options from the referenced \@ARGV, returning the stripped elements as a list (retaining order).

  3. RemainingOptions(\@ARGV, LIST)

  Like GetOptions but does not modify the current @ARGV; instead it returns an array containing the subset of unparsed elements of ARGV.