parl1
Binary par loader
Usage
To make
a
PAR
distribution
from
a
CPAN
module
distribution:
To manipulate
a
PAR
distribution:
To use
Hello.pm
from
./foo.par:
Run test.pl
or
script/test.pl
from
foo.par:
To make
a
self-containing
executable
containing
a
PAR
file
:
To embed
the
necessary
non-core
modules
and
shared
objects
for
PAR's
execution
(like
"Zlib",
"IO",
"Cwd",
etc),
use
the
-b
flag:
Overview
This stand-alone command offers roughly the same feature as "perl -MPAR", except that it takes the pre-loaded .par files via "-Afoo.par" instead of "-MPAR=foo.par".
Additionally, it lets you convert a CPAN distribution to a PAR distribution, as well as manipulate such distributions. For more information about PAR distributions, see PAR::Dist.
You can use it to run .par files:
# runs script/run.pl in archive, uses its lib/* as libraries% parl myapp.par run.pl # runs run.pl or script/run.pl in myapp.par% parl otherapp.pl # also runs normal perl scripts
However, if the .par archive contains either main.pl or script/main.pl, it is used instead:
% parl myapp.par run.pl # runs main.pl, with 'run.pl' as @ARGVFinally, the "-O" option makes a stand-alone binary executable from a PAR file:
% parl -B -Omyapp myapp.par% ./myapp # run it anywhere without perl binaries
With the "--par-options" flag, generated binaries can act as "parl" to pack new binaries:
% ./myapp --par-options -Omyap2 myapp.par # identical to ./myapp% ./myapp --par-options -Omyap3 myap3.par # now with different PAR
For an explanation of stand-alone executable format, please see par.pl.