Modules

  • ABCDE
  • FGHIL
  • MNOPS
  • TUX

Tools

perlcc

Perl 5 version 8.8 documentation
Recently read

perlcc

NAME

perlcc - generate executables from Perl programs

SYNOPSIS

  1. $ perlcc hello # Compiles into executable 'a.out'
  2. $ perlcc -o hello hello.pl # Compiles into executable 'hello'
  3. $ perlcc -O file # Compiles using the optimised C backend
  4. $ perlcc -B file # Compiles using the bytecode backend
  5. $ perlcc -c file # Creates a C file, 'file.c'
  6. $ perlcc -S -o hello file # Creates a C file, 'file.c',
  7. # then compiles it to executable 'hello'
  8. $ perlcc -c out.c file # Creates a C file, 'out.c' from 'file'
  9. $ perlcc -e 'print q//' # Compiles a one-liner into 'a.out'
  10. $ perlcc -c -e 'print q//' # Creates a C file 'a.out.c'
  11. $ perlcc -I /foo hello # extra headers (notice the space after -I)
  12. $ perlcc -L /foo hello # extra libraries (notice the space after -L)
  13. $ perlcc -r hello # compiles 'hello' into 'a.out', runs 'a.out'.
  14. $ perlcc -r hello a b c # compiles 'hello' into 'a.out', runs 'a.out'.
  15. # with arguments 'a b c'
  16. $ perlcc hello -log c # compiles 'hello' into 'a.out' logs compile
  17. # 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.