perltobin - turn your perl script into a binary executable


NAME

perltobin - turn your perl script into a binary executable

__top


DESCRIPTION

Do you have a perl script you'd like to distribute in executable form?

Then PerlBin is for you, whatever your OS may be, as long as there is a perl port for it (you can run perl on it).

__top


SYNOPSIS

    PerlBin [-?] [-o outdir] [-a mod] Script.pl

__top


OPTIONS

[-?]

help! help! help! to see more help, try --man.

[-a mod]

Add a module to be scanned (must be in @INC). You can specify multiple by doing -a foo -a bar -a gahZbo.

-o outdir

A directory where to place all the stuff. Defaults to Script_perlbined.

__top


CAVEATS

None I can see. Beware of -s __FILE__ cause it will return the filesize of the exe, not your source.

The global $PerlBin::skipTo holds the size of the binary before your script was appended, and you can use it as an offset.

pod2usage/perldoc don't like binary files for some reason.

See sub pod2usage in here for a workaround.

__top


SEE ALSO (RESOURCES)

All of the software listed here is really useful, so check it out, before you ask ``why doesn't perlbin do x?'' ;D

Module::CryptSource

Since neither perlbin, nor PAR, nor App::Packer even attempt to obscure the source code Autrijus Tang developed this one for use with PAR and others like it.

PAR

Kinda like perlbin (same idea), except uses lots and lots of perl magic and requires perl 5.6.

http://search.cpan.org/author/AUTRIJUS/PAR/

App::Packer

Kinda like perlbin (same idea), except packs ALL the file into this one, uses lots and lots of perl magic, and requires perl 5.6.

http://search.cpan.org/author/MBARBON/App-Packer/

exetype

Change the nature of your win32 perlbin generated executable. By default all are console executables (dos window).

I distribute this one with perlbin.

NSIS

Nullsoft (SuperPiMP|Scriptable) Install System

http://www.nullsoft.com/free/nsis/

Win32 only. For other os's you can use RPM ;) or family, and there ain't never nothing wrong with a neat-o tarball ;D

UPX

http://upx.sf.net - you can pack individual .dll/.so's with this to save space (smaller sizes).

Pod::Stripper

Gets rid of pod in modules, cause you don't need it. http://search.cpan.org/author/PODMASTER/Pod-Stripper/

Works pretty well but please use at your own risk.

And while i'm talking about pod, Holy Getopt::Long, Pod::Usage Man! (http://perlmonks.org/index.pl?node_id=155288;) cause you gotta have documentation.

Programmer's Tools

Lots of neat-o utilities and interesting reading here.

    http://www.programmerstools.org
    http://protools.owns.it
    http://protools.cjb.net

__top


COPYRIGHT

Copyright (c) 2002-2003 by the http://perlbin.sf.net/ team.

Original code by Graciliano M. P.

Original idea not so original ;)

This here program and all enclosed *schtuff* is distributed under the same terms as perl itself. See perl.com for more info on that.

__top

 perltobin - turn your perl script into a binary executable