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-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 the B manpage
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
Specifies the file name for the final compiled exe
cutable.
-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.
2002-06-25 perl v5.6.1 PERLCC(1)