NAME
IPC::System::Options - Perl's system() replacement/wrapper, with options
VERSION
This document describes version 0.01 of IPC::System::Options (from Perl distribution IPC-System-Options), released on 2015-01-04.
SYNOPSIS
use IPC::System::Options qw(system);
# use exactly like system()
system(...);
# but it accepts an optional hash first argument to specify options
system({...}, ...);
# run without shell, even though there is only one argument
system({shell=>0}, "ls");
system({shell=>0}, "ls -lR"); # will fail, as there is no 'ls -lR' binary
# set LC_ALL/LANGUAGE/LANG environment variable
system({lang=>"de_DE.UTF-8"}, "df");
DESCRIPTION
FUNCTIONS
system([ \%opts ], @args)
Just like perl's system()
except that it accepts an optional hash first argument to specify options. Currently known options:
shell => bool
Can be set to 0 to always avoid invoking the shell. The default is to use the shell under certain conditions, like Perl's
system()
.lang => str
Set locale-related environment variables:
LC_ALL
(this is the highest precedence, even higher than the otherLC_*
variables includingLC_MESSAGES
),LANGUAGE
(this is used in Linux, with precedence higher thanLANG
but lower thanLC_*
), andLANG
.Of course you can set the environment variables manually, this option is just for convenience.
HOMEPAGE
Please visit the project's homepage at https://metacpan.org/release/IPC-System-Options.
SOURCE
Source repository is at https://github.com/perlancar/perl-IPC-System-Options.
BUGS
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=IPC-System-Options
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
AUTHOR
perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.