PERLCC(1) Perl Programmers Reference Guide PERLCC(1)NAMEperlcc - generate executables from Perl programs
SYNOPSIS
$ perlcc hello # Compiles into executable 'a.out'
$ perlcc-o hello hello.pl # Compiles into executable 'hello'
$ perlcc-O file # Compiles using the optimised C backend
$ perlcc-B file # Compiles using the bytecode backend
$ perlcc-c file # Creates a C file, 'file.c'
$ perlcc-S -o hello file # Creates a C file, 'file.c',
# then compiles it to executable 'hello'
$ perlcc-c out.c file # Creates a C file, 'out.c' from 'file'
$ perlcc-e 'print q//' # Compiles a one-liner into 'a.out'
$ perlcc-c -e 'print q//' # Creates a C file 'a.out.c'
$ perlcc-I /foo hello # extra headers (notice the space after -I)
$ perlcc-L /foo hello # extra libraries (notice the space after -L)
$ perlcc-r hello # compiles 'hello' into 'a.out', runs 'a.out'.
$ perlcc-r hello a b c # compiles 'hello' into 'a.out', runs 'a.out'.
# with arguments 'a b c'
$ perlcc hello -log c # compiles 'hello' into 'a.out' logs compile
# log into 'c'.
DESCRIPTIONperlcc creates standalone executables from Perl programs,
using the code generators provided by the B module. At
present, you may either create executable Perl bytecode,
using the "-B" option, or generate and compile C files using
the standard and 'optimised' C backends.
The code generated in this way is not guaranteed to work.
The whole codegen suite ("perlcc" included) should be con-
sidered very experimental. Use for production purposes is
strongly discouraged.
OPTIONS-Llibrary directories
Adds the given directories to the library search path
when C code is passed to your C compiler.
-Iinclude directories
Adds the given directories to the include file search
path when C code is passed to your C compiler; when
using the Perl bytecode option, adds the given direc-
tories to Perl's include path.
-o output file name
perl v5.8.8 2006-06-30 1
PERLCC(1) Perl Programmers Reference Guide PERLCC(1)
Specifies the file name for the final compiled execut-
able.
-c C file name
Create C code only; do not compile to a standalone
binary.
-e perl code
Compile a one-liner, much the same as "perl -e '...'"
-S Do not delete generated C code after compilation.
-B Use the Perl bytecode code generator.
-O Use the 'optimised' C code generator. This is more
experimental than everything else put together, and the
code created is not guaranteed to compile in finite time
and memory, or indeed, at all.
-v Increase verbosity of output; can be repeated for more
verbose output.
-r Run the resulting compiled script after compiling it.
-log
Log the output of compiling to a file rather than to
stdout.
perl v5.8.8 2006-06-30 2