PAR(1)                User Contributed Perl Documentation               PAR(1)


<?><?><?> (NAME)
       par.pl - <?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> Perl

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       (<?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> PAR <?><?>
       <?><?><?><?><?><?><?><?><?><?> perl<?> <?><?><?><?><?> pp <?><?>
       <?><?><?><?><?><?>.)

       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> PAR <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> CPAN:

           % par.pl -p                 # make a PAR dist under the current path
           % par.pl -p Foo-0.01        # assume unpacked CPAN dist in Foo-0.01/

       <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?> PAR:

           % par.pl -i Foo-0.01-i386-freebsd-5.8.0.par # install
           % par.pl -i http://foo.com/Foo-0.01         # auto-appends archname + perlver
           % par.pl -i cpan://AUTRIJUS/PAR-0.74        # uses CPAN author directory
           % par.pl -u Foo-0.01-i386-freebsd-5.8.0.par # uninstall
           % par.pl -s Foo-0.01-i386-freebsd-5.8.0.par # sign
           % par.pl -v Foo-0.01-i386-freebsd-5.8.0.par # verify

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> Hello.pm <?><?><?><?><?>
       <?><?> ./foo.par:

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

       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> foo.par
       <?><?> @INC<?>

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

       <?><?><?><?><?> test.pl <?><?> script/test.pl <?><?> <?><?><?><?>
       foo.par:

           % par.pl foo.par test.pl    # looks for 'main.pl' by default,
                                       # otherwise run 'test.pl'

       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> PAR:

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

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> (non-core) <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> PAR
       (<?><?><?><?><?> "Zlib"<?> "IO"<?> "Cwd" <?> <?><?><?><?>)<?> <?><?>
       <?><?><?><?> -b <?><?><?><?><?><?><?> <?><?><?><?>:

           % par.pl -b -O./foo.pl foo.par
           % ./foo.pl test.pl          # runs anywhere with core modules installed

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (core) <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?> -B <?><?><?><?><?><?><?> <?><?><?><?>:

           % par.pl -B -O./foo.pl foo.par
           % ./foo.pl test.pl          # runs anywhere with the perl interpreter

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> pp <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> "perl -MPAR" <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> .par <?><?> <?><?> <?><?><?>
       "-MPAR=foo.par"<?> <?><?> <?><?><?><?> "-Afoo.par" <?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> CPAN <?><?> <?><?> <?><?>
       <?><?><?><?><?> PAR <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> PAR<?> <?><?>
       PAR::Dist <?><?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?><?><?> PAR (parl)
       <?><?><?> <?><?><?><?><?><?><?><?> C <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> PAR <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> par.pl <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> parl <?><?><?> <?><?><?><?><?>
       <?><?>. <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> .par <?><?><?><?><?><?><?>
       <?><?><?><?>:

           # 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

       <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> .par
       <?><?><?><?> <?><?><?><?> main.pl <?><?> script/main.pl <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>:

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

       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> "-O" <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> PAR <?><?><?><?><?> <?><?><?><?><?><?>:

           % parl -B -Omyapp myapp.par
           % ./myapp                   # run it anywhere without perl binaries

       <?><?> <?><?><?><?> "--par-options"<?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       "parl" <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>:

           % ./myapp --par-options -Omyap2 myapp.par   # identical to ./myapp
           % ./myapp --par-options -Omyap3 myap3.par   # now with different PAR

   <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?>:

       o   <?><?><?> <?><?><?><?> <?><?><?><?><?><?>

           <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> (par.pl) <?>
           <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> (parl <?><?> parl.exe).

       o   <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>

           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> XS <?><?>
           PAR <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>:

           <?><?><?><?><?> <?><?><?><?><?><?> ""FILE""
           <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> pack('N')
           <?><?> <?><?><?><?><?> <?>
           <?> <?><?><?><?> <?><?> CRC32 <?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> (""/"")
           <?><?><?> <?><?><?><?> (<?><?><?><?> <?><?><?><?>)
           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> pack('N')
           <?><?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?><?><?><?><?>)

       o   <?><?> <?><?><?><?> PAR

           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> zip
           <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           ""PK\003\004"" <?><?><?><?> <?><?><?><?><?><?>.

       o   <?><?><?> <?><?><?><?><?><?>

           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> (cache) <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?> pack('Z40')
           <?><?> <?><?><?><?><?> -T (--tempcache) <?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?> "\0CACHE"
           <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?> Digest::SHA
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?> <?><?><?> pack('N') <?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?> FILE <?> PAR<?> <?><?> <?><?> <?><?> <?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>: ""\012PAR.pm\012"".

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       PAR, PAR::Dist, parl, pp

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Audrey Tang <cpan@audreyt.org>, Steffen Mueller <smueller@cpan.org>

       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <par@perl.org> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <par-subscribe@perl.org> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?>
       <https://www.mail-archive.com/par@perl.org> <?><?>
       <https://groups.google.com/g/perl.par> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <https://github.com/rschupp/PAR-Packer/issues> <?><?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       <?><?> <?><?><?> <?><?><?><?>-<?><?><?><?> <?><?><?><?> Audrey Tang
       <cpan@audreyt.org>.

       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       Artistic License<?> <?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> parl <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>:

           "Aggregation of this Package with a commercial distribution is
           always permitted provided that the use of this Package is embedded;
           that is, when no overt attempt is made to make this Package's
           interfaces visible to the end user of the commercial distribution.
           Such use shall not be construed as a distribution of this Package."

       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?> Artistic License <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> Perl
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>.

       LICENSE <?><?> <?><?><?><?><?><?>.

perl v5.42.2                      2026-04-05                            PAR(1)