/System-Command

Object for running system commands

Primary LanguagePerl

NAME

System::Command - Object for running system commands

SYNOPSIS

    use System::Command;

    # invoke an external command, and return an object
    $cmd = System::Command->new( @cmd );

    # options can be passed as a hashref
    $cmd = System::Command->new( @cmd, \%option );

    # $cmd is basically a hash, with keys / accessors
    $cmd->stdin();     # filehandle to the process' stdin (write)
    $cmd->stdout();    # filehandle to the process' stdout (read)
    $cmd->stderr();    # filehandle to the process' stdout (read)
    $cmd->pid();       # pid of the child process

    # done!
    $cmd->close();

    # exit information
    $cmd->exit();      # exit status
    $cmd->signal();    # signal
    $cmd->core();      # core dumped? (boolean)

DESCRIPTION

System::Command is a class that launches external system commands and
return an object representing them, allowing to interact with them
through their "STDIN", "STDOUT" and "STDERR" handles.


INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

Alternatively, to install with Module::Build, you can use the following commands:

	perl Build.PL
	./Build
	./Build test
	./Build install

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc System::Command

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=System-Command

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/System-Command

    CPAN Ratings
        http://cpanratings.perl.org/d/System-Command

    Search CPAN
        http://search.cpan.org/dist/System-Command/


LICENSE AND COPYRIGHT

Copyright (C) 2010 Philippe Bruhat (BooK)

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.