README
1NAME
2
3System::Command - Object for running system commands
4
5SYNOPSIS
6
7 use System::Command;
8
9 # invoke an external command, and return an object
10 $cmd = System::Command->new( @cmd );
11
12 # options can be passed as a hashref
13 $cmd = System::Command->new( @cmd, \%option );
14
15 # $cmd is basically a hash, with keys / accessors
16 $cmd->stdin(); # filehandle to the process stdin (write)
17 $cmd->stdout(); # filehandle to the process stdout (read)
18 $cmd->stderr(); # filehandle to the process stdout (read)
19 $cmd->pid(); # pid of the child process
20
21 # done!
22 $cmd->close();
23
24 # exit information
25 $cmd->exit(); # exit status
26 $cmd->signal(); # signal
27 $cmd->core(); # core dumped? (boolean)
28
29DESCRIPTION
30
31System::Command is a class that launches external system commands and
32return an object representing them, allowing to interact with them
33through their "STDIN", "STDOUT" and "STDERR" handles.
34
35
36INSTALLATION
37
38To install this module, run the following commands:
39
40 perl Makefile.PL
41 make
42 make test
43 make install
44
45Alternatively, to install with Module::Build, you can use the following commands:
46
47 perl Build.PL
48 ./Build
49 ./Build test
50 ./Build install
51
52SUPPORT AND DOCUMENTATION
53
54After installing, you can find documentation for this module with the
55perldoc command.
56
57 perldoc System::Command
58
59You can also look for information at:
60
61 RT, CPAN's request tracker
62 http://rt.cpan.org/NoAuth/Bugs.html?Dist=System-Command
63
64 AnnoCPAN, Annotated CPAN documentation
65 http://annocpan.org/dist/System-Command
66
67 CPAN Ratings
68 http://cpanratings.perl.org/d/System-Command
69
70 Search CPAN
71 http://search.cpan.org/dist/System-Command/
72
73
74LICENSE AND COPYRIGHT
75
76Copyright (C) 2010-2016 Philippe Bruhat (BooK)
77
78This program is free software; you can redistribute it and/or modify it
79under the terms of either: the GNU General Public License as published
80by the Free Software Foundation; or the Artistic License.
81
82See http://dev.perl.org/licenses/ for more information.
83
84