NAME

par.pl - Run Perl Archives

SYNOPSIS

To use Hello.pm, lib/Hello.pm or arch/Hello.pm from ./foo.par:

    % par.pl -A./foo.par -MHello 
    % par.pl -A./foo -MHello    # the .par part is optional

Same thing, but search foo.par in the @INC;

    % par.pl -Ifoo.par -MHello 
    % par.pl -Ifoo -MHello      # ditto

Run test.pl or script/test.pl from foo.par:

    % par.pl foo.par test.pl    # only when $ARGV[0] ends in '.par'
    % par.pl foo.par            # looks for 'main.pl' by default

You can also make a self-reading script containing a PAR file :

    % par.pl -O./foo.pl foo.par
    % ./foo.pl test.pl          # same as above

DESCRIPTION

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.

The main purpose of this utility is to be feed to perlcc:

    % perlcc -o par par.pl

and use the resulting stand-alone executable par to run .par files:

    # runs script/run.pl in archive, uses its lib/* as libraries
    % par myapp.par run.pl      # runs run.pl or script/run.pl in myapp.par

However, if the .par archive contains either main.pl or script/main.pl, it is used instead:

    % par myapp.par run.pl      # runs main.pl, with 'run.pl' as @ARGV

Finally, as an alternative to perl2exe or PerlApp, the -o option makes a stand-alone binary from a PAR file:

    % par -Omyapp myapp.par     # makes a stand-alone executable
    % ./myapp run.pl            # same as above
    % ./myapp -Omyap2 myapp.par # makes a ./myap2, identical to ./myapp
    % ./myapp -Omyap3 myap3.par # makes another app with different PAR

The format for the stand-alone executable is simply concatenating the PAR file after par or par.pl, followed by the PAR file's length, packed in 4 bytes as an unsigned long number in network order (i.e. pack('N')), then the magic string "\x0APAR.pm\x0A".

NOTES

After installation, if you want to enable stand-alone binary support, please apply the included patch to the B::C module first (5.8.0 only, 5.6.1 does not need this):

    % patch `perl -MB::C -e'print $INC{"B/C.pm"}'` < patches/perl580.diff

and then:

    % perlcc -o /usr/local/bin/par script/par.pl

Afterwards, you can generate self-executable PAR files by:

    # put a main.pl inside myapp.par to run it automatically
    % par -O./myapp myapp.par

SEE ALSO

PAR, perlcc

AUTHORS

Autrijus Tang <autrijus@autrijus.org>

COPYRIGHT

Copyright 2002 by Autrijus Tang <autrijus@autrijus.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html

cpanm PAR

perl -MCPAN -e shell
install PAR