*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> perlcc (1)              



NAME    [Toc]    [Back]

       perlcc - generate executables from Perl programs

SYNOPSIS    [Toc]    [Back]

           $ perlcc hello              # Compiles into executable
           $ perlcc -o hello hello.pl  # Compiles into executable

           $ perlcc -O file            # Compiles using the optimised C backend
           $ perlcc -B file            # Compiles using the bytecode backend

           $ perlcc  -c  file             #  Creates  a  C  file,
           $  perlcc  -S  -o  hello  file    #  Creates a C file,
                                       # 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

           $ 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    [Toc]    [Back]

       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    [Toc]    [Back]

       -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

       -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 the output of compiling to a file rather than to

perl v5.8.5                 2002-11-06                          2
[ Back ]
 Similar pages
Name OS Title
lex IRIX generate programs for simple lexical tasks
perljp OpenBSD AEuEU,i Perl Y~YxYE `A^a`I`A Perl xIAx3|xOxex|x3x1/2! Perl 5.8.0 xexeicUni- _ codeYuYYi1/4YEx~AcEyxE...
chkdupexe Linux find duplicate executables
libstand FreeBSD support library for standalone executables
gzexe OpenBSD create auto-decompressing executables
pixdump IRIX print out the tables in SpeedShop instrumented executables
rqsall IRIX requickstarts out-of-sync ELF shared objects/executables on a system
dh_strip Linux strip executables, shared libraries, and some static libraries
whereis OpenBSD locate programs
whereis FreeBSD locate programs
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service