NAME

ClearCase::Argv - ClearCase-specific subclass of Argv

SYNOPSIS

use ClearCase::Argv;
my $describe = ClearCase::Argv->new('desc', [qw(-fmt %c)], "filename");
$describe->parse(qw(fmt=s));
$describe->system;

DESCRIPTION

This is a subclass of Argv for use with ClearCase. It basically overrides the prog() method to recognize the fact that ClearCase commands have two words, e.g. "cleartool checkout' or 'multitool lsepoch'.

It also provides a special method 'ipc_cleartool' which, as the name implies, enables use of the IPC::ClearTool module such that all cleartool commands are run as a coprocess. Attempts to use this method on platforms where IPC::ClearTool is not available will result in a warning and execution will continue using traditional fork/exec.

Functionally ClearCase::Argv is identical to its base class, so see "perldoc Argv" and/or "perldoc IPC::ChildSafe" for all other documentation.

BUGS

I believe there are still some special cleartool quoting situations unaccounted for in the quote method. This will need to be refined over time. Patches gratefully accepted.

PORTABILITY

This module should work on all ClearCase platforms. It was primarily tested on Solaris 7 and NT 4.0, with CC 3.2.1 and 4.0.

AUTHOR

David Boyce <dsb@world.std.com>

Copyright (c) 1999,19100 David Boyce. All rights reserved. This Perl program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

perl(1), Argv, IPC::ClearTool, IPC::ChildSafe