CONTENTS

• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS

#NAME

perlcc - 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'. 

#DESCRIPTION

perlcc 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 considered 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 directories to Perl's include path.

#-o output file name

Specifies the file name for the final compiled executable.

#-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.

Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via the GitHub issue tracker or email regarding any issues with the site itself, search, or rendering of documentation.

The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the Perl issue tracker, the mailing list, or IRC to report any issues with the contents or format of the documentation.