This is a DistributionDocument
. This document is generated, please do not change it
. Put questions, error notes, and suggestions concerning the documentation
of this topic in the comments section below
. Use the Support
web for problems you are having using
This object provides an interface to the outside world. All calls to
system functions, or handling of file names, should be brokered by
Construct a new sandbox suitable for $os, setting
flags for platform features that help. $realOS distinguishes
Perl variants on platforms such as Windows.
StaticMethod untaintUnchecked ($string) -> $untainted
Untaints $string without any checks (dangerous). If $string is
undefined, return undef.
The intent is to use this routine to be able to find all untainting
places using grep.
StaticMethod normalizeFileName ($string) -> $filename
STATIC Errors out if $string contains filtered characters.
The returned string is not tainted, but it may contain shell
metacharacters and even control characters.
ObjectMethod sysCommand ($template,@params) -> ($data,$exit)
Invokes the program described by $template
, and returns the output of the program and an exit code.
STDOUT is returned. STDERR is THROWN AWAY.
The caller has to ensure that the invoked program does not react in a
harmful way to the passed arguments. sysCommand merely
ensures that the shell does not interpret any of the passed arguments.
Comments & Questions about this Distribution Document Topic