home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 December (Special) / PCWorld_2005-12_Special_cd.bin / Bezpecnost / lsti / lsti.exe / framework-2.5.exe / perlcc < prev    next >
Text File  |  2005-01-27  |  18KB  |  651 lines

  1. #!/usr/bin/perl
  2.     eval 'exec /usr/bin/perl -S $0 ${1+"$@"}'
  3.     if $running_under_some_shell;
  4. --$running_under_some_shell;
  5.  
  6. # Version 2.0, Simon Cozens, Thu Mar 30 17:52:45 JST 2000 
  7. # Version 2.01, Tom Christiansen, Thu Mar 30 08:25:14 MST 2000
  8. # Version 2.02, Simon Cozens, Sun Apr 16 01:53:36 JST 2000
  9. # Version 2.03, Edward Peschko, Mon Feb 26 12:04:17 PST 2001
  10. # Version 2.04, Enache Adrian,Fri, 18 Jul 2003 23:15:37 +0300
  11.  
  12. use strict;
  13. use warnings;
  14. use 5.006_000;
  15.  
  16. use FileHandle;
  17. use Config;
  18. use Fcntl qw(:DEFAULT :flock);
  19. use File::Temp qw(tempfile);
  20. use Cwd;
  21. our $VERSION = 2.04;
  22. $| = 1;
  23.  
  24. $SIG{INT} = sub { exit(); }; # exit gracefully and clean up after ourselves.
  25.  
  26. use subs qw{
  27.     cc_harness check_read check_write checkopts_byte choose_backend
  28.     compile_byte compile_cstyle compile_module generate_code
  29.     grab_stash parse_argv sanity_check vprint yclept spawnit
  30. };
  31. sub opt(*); # imal quoting
  32. sub is_win32();
  33. sub is_msvc();
  34.  
  35. our ($Options, $BinPerl, $Backend);
  36. our ($Input => $Output);
  37. our ($logfh);
  38. our ($cfile);
  39. our (@begin_output); # output from BEGIN {}, for testsuite
  40.  
  41. # eval { main(); 1 } or die;
  42.  
  43. main();
  44.  
  45. sub main {
  46.     parse_argv();
  47.     check_write($Output);
  48.     choose_backend();
  49.     generate_code();
  50.     run_code();
  51.     _die("XXX: Not reached?");
  52. }
  53.  
  54. #######################################################################
  55.  
  56. sub choose_backend {
  57.     # Choose the backend.
  58.     $Backend = 'C';
  59.     if (opt(B)) {
  60.         checkopts_byte();
  61.         $Backend = 'Bytecode';
  62.     }
  63.     if (opt(S) && opt(c)) {
  64.         # die "$0: Do you want me to compile this or not?\n";
  65.         delete $Options->{S};
  66.     }
  67.     $Backend = 'CC' if opt(O);
  68. }
  69.  
  70.  
  71. sub generate_code { 
  72.  
  73.     vprint 0, "Compiling $Input";
  74.  
  75.     $BinPerl  = yclept();  # Calling convention for perl.
  76.  
  77.     if (opt(shared)) {
  78.         compile_module();
  79.     } else {
  80.         if ($Backend eq 'Bytecode') {
  81.             compile_byte();
  82.         } else {
  83.             compile_cstyle();
  84.         }
  85.     }
  86.     exit(0) if (!opt('r'));
  87. }
  88.  
  89. sub run_code {
  90.     vprint 0, "Running code";
  91.     run("$Output @ARGV");
  92.     exit(0);
  93. }
  94.  
  95. # usage: vprint [level] msg args
  96. sub vprint {
  97.     my $level;
  98.     if (@_ == 1) {
  99.         $level = 1;
  100.     } elsif ($_[0] =~ /^\d$/) {
  101.         $level = shift;
  102.     } else {
  103.         # well, they forgot to use a number; means >0
  104.         $level = 0;
  105.     } 
  106.     my $msg = "@_";
  107.     $msg .= "\n" unless substr($msg, -1) eq "\n";
  108.     if (opt(v) > $level)
  109.     {
  110.          print        "$0: $msg" if !opt('log');
  111.      print $logfh "$0: $msg" if  opt('log');
  112.     }
  113. }
  114.  
  115. sub parse_argv {
  116.  
  117.     use Getopt::Long; 
  118.  
  119.     # disallows using long arguments
  120.     # Getopt::Long::Configure("bundling");
  121.  
  122.     Getopt::Long::Configure("no_ignore_case");
  123.  
  124.     # no difference in exists and defined for %ENV; also, a "0"
  125.     # argument or a "" would not help cc, so skip
  126.     unshift @ARGV, split ' ', $ENV{PERLCC_OPTS} if $ENV{PERLCC_OPTS};
  127.  
  128.     $Options = {};
  129.     Getopt::Long::GetOptions( $Options,
  130.         'L:s',          # lib directory
  131.         'I:s',          # include directories (FOR C, NOT FOR PERL)
  132.         'o:s',          # Output executable
  133.         'v:i',          # Verbosity level
  134.         'e:s',          # One-liner
  135.     'r',            # run resulting executable
  136.         'B',            # Byte compiler backend
  137.         'O',            # Optimised C backend
  138.         'c',            # Compile only
  139.         'h',            # Help me
  140.         'S',            # Dump C files
  141.     'r',            # run the resulting executable
  142.         'T',            # run the backend using perl -T
  143.         't',            # run the backend using perl -t
  144.         'static',       # Dirty hack to enable -shared/-static
  145.         'shared',       # Create a shared library (--shared for compat.)
  146.     'log:s',        # where to log compilation process information
  147.         'Wb:s',         # pass (comma-sepearated) options to backend
  148.         'testsuite',    # try to be nice to testsuite
  149.     );
  150.  
  151.     $Options->{v} += 0;
  152.  
  153.     if( opt(t) && opt(T) ) {
  154.         warn "Can't specify both -T and -t, -t ignored";
  155.         $Options->{t} = 0;
  156.     }
  157.  
  158.     helpme() if opt(h); # And exit
  159.  
  160.     $Output = opt(o) || ( is_win32 ? 'a.exe' : 'a.out' );
  161.     $Output = is_win32() ? $Output : relativize($Output);
  162.     $logfh  = new FileHandle(">> " . opt('log')) if (opt('log'));
  163.  
  164.     if (opt(e)) {
  165.         warn "$0: using -e 'code' as input file, ignoring @ARGV\n" if @ARGV;
  166.         # We don't use a temporary file here; why bother?
  167.         # XXX: this is not bullet proof -- spaces or quotes in name!
  168.         $Input = is_win32() ? # Quotes eaten by shell
  169.             '-e "'.opt(e).'"' :
  170.             "-e '".opt(e)."'";
  171.     } else {
  172.         $Input = shift @ARGV;  # XXX: more files?
  173.         _usage_and_die("$0: No input file specified\n") unless $Input;
  174.         # DWIM modules. This is bad but necessary.
  175.         $Options->{shared}++ if $Input =~ /\.pm\z/;
  176.         warn "$0: using $Input as input file, ignoring @ARGV\n" if @ARGV;
  177.         check_read($Input);
  178.         check_perl($Input);
  179.         sanity_check();
  180.     }
  181.  
  182. }
  183.  
  184. sub opt(*) {
  185.     my $opt = shift;
  186.     return exists($Options->{$opt}) && ($Options->{$opt} || 0);
  187.  
  188. sub compile_module { 
  189.     die "$0: Compiling to shared libraries is currently disabled\n";
  190. }
  191.  
  192. sub compile_byte {
  193.     my $command = "$BinPerl -MO=Bytecode,-H,-o$Output $Input";
  194.     $Input =~ s/^-e.*$/-e/;
  195.  
  196.     my ($output_r, $error_r) = spawnit($command);
  197.  
  198.     if (@$error_r && $? != 0) {
  199.     _die("$0: $Input did not compile:\n@$error_r\n");
  200.     } else {
  201.     my @error = grep { !/^$Input syntax OK$/o } @$error_r;
  202.     warn "$0: Unexpected compiler output:\n@error" if @error;
  203.     }
  204.  
  205.     chmod 0777 & ~umask, $Output    or _die("can't chmod $Output: $!");
  206.     exit 0;
  207. }
  208.  
  209. sub compile_cstyle {
  210.     my $stash = grab_stash();
  211.     my $taint = opt(T) ? '-T' :
  212.                 opt(t) ? '-t' : '';
  213.  
  214.     # What are we going to call our output C file?
  215.     my $lose = 0;
  216.     my ($cfh);
  217.     my $testsuite = '';
  218.     my $addoptions = opt(Wb);
  219.  
  220.     if( $addoptions ) {
  221.         $addoptions .= ',' if $addoptions !~ m/,$/;
  222.     }
  223.  
  224.     if (opt(testsuite)) {
  225.         my $bo = join '', @begin_output;
  226.         $bo =~ s/\\/\\\\\\\\/gs;
  227.         $bo =~ s/\n/\\n/gs;
  228.         $bo =~ s/,/\\054/gs;
  229.         # don't look at that: it hurts
  230.         $testsuite = q{-fuse-script-name,-fsave-data,-fsave-sig-hash,}.
  231.             qq[-e"print q{$bo}",] .
  232.             q{-e"open(Test::Builder::TESTOUT\054 '>&STDOUT') or die $!",} .
  233.             q{-e"open(Test::Builder::TESTERR\054 '>&STDERR') or die $!",};
  234.     }
  235.     if (opt(S) || opt(c)) {
  236.         # We need to keep it.
  237.         if (opt(e)) {
  238.             $cfile = "a.out.c";
  239.         } else {
  240.             $cfile = $Input;
  241.             # File off extension if present
  242.             # hold on: plx is executable; also, careful of ordering!
  243.             $cfile =~ s/\.(?:p(?:lx|l|h)|m)\z//i;
  244.             $cfile .= ".c";
  245.             $cfile = $Output if opt(c) && $Output =~ /\.c\z/i;
  246.         }
  247.         check_write($cfile);
  248.     } else {
  249.         # Don't need to keep it, be safe with a tempfile.
  250.         $lose = 1;
  251.         ($cfh, $cfile) = tempfile("pccXXXXX", SUFFIX => ".c"); 
  252.         close $cfh; # See comment just below
  253.     }
  254.     vprint 1, "Writing C on $cfile";
  255.  
  256.     my $max_line_len = '';
  257.     if ($^O eq 'MSWin32' && $Config{cc} =~ /^cl/i) {
  258.         $max_line_len = '-l2000,';
  259.     }
  260.  
  261.     # This has to do the write itself, so we can't keep a lock. Life
  262.     # sucks.
  263.     my $command = "$BinPerl $taint -MO=$Backend,$addoptions$testsuite$max_line_len$stash,-o$cfile $Input";
  264.     vprint 1, "Compiling...";
  265.     vprint 1, "Calling $command";
  266.  
  267.     my ($output_r, $error_r) = spawnit($command);
  268.     my @output = @$output_r;
  269.     my @error = @$error_r;
  270.  
  271.     if (@error && $? != 0) {
  272.         _die("$0: $Input did not compile, which can't happen:\n@error\n");
  273.     }
  274.  
  275.     is_msvc ?
  276.         cc_harness_msvc($cfile,$stash) :
  277.         cc_harness($cfile,$stash) unless opt(c);
  278.  
  279.     if ($lose) {
  280.         vprint 2, "unlinking $cfile";
  281.         unlink $cfile or _die("can't unlink $cfile: $!"); 
  282.     }
  283. }
  284.  
  285. sub cc_harness_msvc {
  286.     my ($cfile,$stash)=@_;
  287.     use ExtUtils::Embed ();
  288.     my $obj = "${Output}.obj";
  289.     my $compile = ExtUtils::Embed::ccopts." -c -Fo$obj $cfile ";
  290.     my $link = "-out:$Output $obj";
  291.     $compile .= " -I".$_ for split /\s+/, opt(I);
  292.     $link .= " -libpath:".$_ for split /\s+/, opt(L);
  293.     my @mods = split /-?u /, $stash;
  294.     $link .= " ".ExtUtils::Embed::ldopts("-std", \@mods);
  295.     $link .= " perl5$Config{PERL_VERSION}.lib kernel32.lib msvcrt.lib";
  296.     vprint 3, "running $Config{cc} $compile";
  297.     system("$Config{cc} $compile");
  298.     vprint 3, "running $Config{ld} $link";
  299.     system("$Config{ld} $link");
  300. }
  301.  
  302. sub cc_harness {
  303.     my ($cfile,$stash)=@_;
  304.     use ExtUtils::Embed ();
  305.     my $command = ExtUtils::Embed::ccopts." -o $Output $cfile ";
  306.     $command .= " -I".$_ for split /\s+/, opt(I);
  307.     $command .= " -L".$_ for split /\s+/, opt(L);
  308.     my @mods = split /-?u /, $stash;
  309.     $command .= " ".ExtUtils::Embed::ldopts("-std", \@mods);
  310.         $command .= " -lperl";
  311.     vprint 3, "running $Config{cc} $command";
  312.     system("$Config{cc} $command");
  313. }
  314.  
  315. # Where Perl is, and which include path to give it.
  316. sub yclept {
  317.     my $command = "$^X ";
  318.  
  319.     # DWIM the -I to be Perl, not C, include directories.
  320.     if (opt(I) && $Backend eq "Bytecode") {
  321.         for (split /\s+/, opt(I)) {
  322.             if (-d $_) {
  323.                 push @INC, $_;
  324.             } else {
  325.                 warn "$0: Include directory $_ not found, skipping\n";
  326.             }
  327.         }
  328.     }
  329.             
  330.     $command .= "-I$_ " for @INC;
  331.     return $command;
  332. }
  333.  
  334. # Use B::Stash to find additional modules and stuff.
  335. {
  336.     my $_stash;
  337.     sub grab_stash {
  338.  
  339.         warn "already called get_stash once" if $_stash;
  340.  
  341.         my $taint = opt(T) ? '-T' :
  342.                     opt(t) ? '-t' : '';
  343.         my $command = "$BinPerl $taint -MB::Stash -c $Input";
  344.         # Filename here is perfectly sanitised.
  345.         vprint 3, "Calling $command\n";
  346.  
  347.         my ($stash_r, $error_r) = spawnit($command);
  348.         my @stash = @$stash_r;
  349.         my @error = @$error_r;
  350.  
  351.         if (@error && $? != 0) {
  352.             _die("$0: $Input did not compile:\n@error\n");
  353.         }
  354.  
  355.         # band-aid for modules with noisy BEGIN {}
  356.         foreach my $i ( @stash ) {
  357.             $i =~ m/-u(?:[\w:]+|\<none\>)$/ and $stash[0] = $i and next;
  358.             push @begin_output, $i;
  359.         }
  360.         chomp $stash[0];
  361.         $stash[0] =~ s/,-u\<none\>//;
  362.         $stash[0] =~ s/^.*?-u/-u/s;
  363.         vprint 2, "Stash: ", join " ", split /,?-u/, $stash[0];
  364.         chomp $stash[0];
  365.         return $_stash = $stash[0];
  366.     }
  367.  
  368. }
  369.  
  370. # Check the consistency of options if -B is selected.
  371. # To wit, (-B|-O) ==> no -shared, no -S, no -c
  372. sub checkopts_byte {
  373.  
  374.     _die("$0: Please choose one of either -B and -O.\n") if opt(O);
  375.  
  376.     if (opt(shared)) {
  377.         warn "$0: Will not create a shared library for bytecode\n";
  378.         delete $Options->{shared};
  379.     }
  380.  
  381.     for my $o ( qw[c S] ) { 
  382.         if (opt($o)) { 
  383.             warn "$0: Compiling to bytecode is a one-pass process--",
  384.                   "-$o ignored\n";
  385.             delete $Options->{$o};
  386.         }
  387.     }
  388.  
  389. }
  390.  
  391. # Check the input and output files make sense, are read/writeable.
  392. sub sanity_check {
  393.     if ($Input eq $Output) {
  394.         if ($Input eq 'a.out') {
  395.             _die("$0: Compiling a.out is probably not what you want to do.\n");
  396.             # You fully deserve what you get now. No you *don't*. typos happen.
  397.         } else {
  398.             warn "$0: Will not write output on top of input file, ",
  399.                 "compiling to a.out instead\n";
  400.             $Output = "a.out";
  401.         }
  402.     }
  403. }
  404.  
  405. sub check_read { 
  406.     my $file = shift;
  407.     unless (-r $file) {
  408.         _die("$0: Input file $file is a directory, not a file\n") if -d _;
  409.         unless (-e _) {
  410.             _die("$0: Input file $file was not found\n");
  411.         } else {
  412.             _die("$0: Cannot read input file $file: $!\n");
  413.         }
  414.     }
  415.     unless (-f _) {
  416.         # XXX: die?  don't try this on /dev/tty
  417.         warn "$0: WARNING: input $file is not a plain file\n";
  418.     } 
  419. }
  420.  
  421. sub check_write {
  422.     my $file = shift;
  423.     if (-d $file) {
  424.         _die("$0: Cannot write on $file, is a directory\n");
  425.     }
  426.     if (-e _) {
  427.         _die("$0: Cannot write on $file: $!\n") unless -w _;
  428.     } 
  429.     unless (-w cwd()) { 
  430.         _die("$0: Cannot write in this directory: $!\n");
  431.     }
  432. }
  433.  
  434. sub check_perl {
  435.     my $file = shift;
  436.     unless (-T $file) {
  437.         warn "$0: Binary `$file' sure doesn't smell like perl source!\n";
  438.         print "Checking file type... ";
  439.         system("file", $file);  
  440.         _die("Please try a perlier file!\n");
  441.     } 
  442.  
  443.     open(my $handle, "<", $file)    or _die("XXX: can't open $file: $!");
  444.     local $_ = <$handle>;
  445.     if (/^#!/ && !/perl/) {
  446.         _die("$0: $file is a ", /^#!\s*(\S+)/, " script, not perl\n");
  447.     } 
  448.  
  449.  
  450. # File spawning and error collecting
  451. sub spawnit {
  452.     my ($command) = shift;
  453.     my (@error,@output);
  454.     my $errname;
  455.     (undef, $errname) = tempfile("pccXXXXX");
  456.     { 
  457.     open (S_OUT, "$command 2>$errname |")
  458.         or _die("$0: Couldn't spawn the compiler.\n");
  459.     @output = <S_OUT>;
  460.     }
  461.     open (S_ERROR, $errname) or _die("$0: Couldn't read the error file.\n");
  462.     @error = <S_ERROR>;
  463.     close S_ERROR;
  464.     close S_OUT;
  465.     unlink $errname or _die("$0: Can't unlink error file $errname");
  466.     return (\@output, \@error);
  467. }
  468.  
  469. sub helpme {
  470.        print "perlcc compiler frontend, version $VERSION\n\n";
  471.        { no warnings;
  472.        exec "pod2usage $0";
  473.        exec "perldoc $0";
  474.        exec "pod2text $0";
  475.        }
  476. }
  477.  
  478. sub relativize {
  479.     my ($args) = @_;
  480.  
  481.     return() if ($args =~ m"^[/\\]");
  482.     return("./$args");
  483. }
  484.  
  485. sub _die {
  486.     $logfh->print(@_) if opt('log');
  487.     print STDERR @_;
  488.     exit(); # should die eventually. However, needed so that a 'make compile'
  489.             # can compile all the way through to the end for standard dist.
  490. }
  491.  
  492. sub _usage_and_die {
  493.     _die(<<EOU);
  494. $0: Usage:
  495. $0 [-o executable] [-r] [-O|-B|-c|-S] [-I /foo] [-L /foo] [-log log] [source[.pl] | -e oneliner]
  496. EOU
  497. }
  498.  
  499. sub run {
  500.     my (@commands) = @_;
  501.  
  502.     print interruptrun(@commands) if (!opt('log'));
  503.     $logfh->print(interruptrun(@commands)) if (opt('log'));
  504. }
  505.  
  506. sub interruptrun
  507. {
  508.     my (@commands) = @_;
  509.  
  510.     my $command = join('', @commands);
  511.     local(*FD);
  512.     my $pid = open(FD, "$command |");
  513.     my $text;
  514.     
  515.     local($SIG{HUP}) = sub { kill 9, $pid; exit };
  516.     local($SIG{INT}) = sub { kill 9, $pid; exit };
  517.  
  518.     my $needalarm = 
  519.           ($ENV{PERLCC_TIMEOUT} && 
  520.       $Config{'osname'} ne 'MSWin32' && 
  521.       $command =~ m"(^|\s)perlcc\s");
  522.  
  523.     eval 
  524.     {
  525.          local($SIG{ALRM}) = sub { die "INFINITE LOOP"; };
  526.          alarm($ENV{PERLCC_TIMEOUT}) if ($needalarm);
  527.      $text = join('', <FD>);
  528.      alarm(0) if ($needalarm);
  529.     };
  530.  
  531.     if ($@)
  532.     {
  533.         eval { kill 'HUP', $pid };
  534.         vprint 0, "SYSTEM TIMEOUT (infinite loop?)\n";
  535.     }
  536.  
  537.     close(FD);
  538.     return($text);
  539. }
  540.  
  541. sub is_win32() { $^O =~ m/^MSWin/ }
  542. sub is_msvc() { is_win32 && $Config{cc} =~ m/^cl/i }
  543.  
  544. END {
  545.     unlink $cfile if ($cfile && !opt(S) && !opt(c));
  546. }
  547.  
  548. __END__
  549.  
  550. =head1 NAME
  551.  
  552. perlcc - generate executables from Perl programs
  553.  
  554. =head1 SYNOPSIS
  555.  
  556.     $ perlcc hello              # Compiles into executable 'a.out'
  557.     $ perlcc -o hello hello.pl  # Compiles into executable 'hello'
  558.  
  559.     $ perlcc -O file            # Compiles using the optimised C backend
  560.     $ perlcc -B file            # Compiles using the bytecode backend
  561.  
  562.     $ perlcc -c file            # Creates a C file, 'file.c'
  563.     $ perlcc -S -o hello file   # Creates a C file, 'file.c',
  564.                                 # then compiles it to executable 'hello'
  565.     $ perlcc -c out.c file      # Creates a C file, 'out.c' from 'file'
  566.  
  567.     $ perlcc -e 'print q//'     # Compiles a one-liner into 'a.out'
  568.     $ perlcc -c -e 'print q//'  # Creates a C file 'a.out.c'
  569.  
  570.     $ perlcc -I /foo hello    # extra headers (notice the space after -I)
  571.     $ perlcc -L /foo hello    # extra libraries (notice the space after -L)
  572.  
  573.     $ perlcc -r hello           # compiles 'hello' into 'a.out', runs 'a.out'.
  574.     $ perlcc -r hello a b c     # compiles 'hello' into 'a.out', runs 'a.out'.
  575.                                 # with arguments 'a b c' 
  576.  
  577.     $ perlcc hello -log c       # compiles 'hello' into 'a.out' logs compile
  578.                                 # log into 'c'. 
  579.  
  580. =head1 DESCRIPTION
  581.  
  582. F<perlcc> creates standalone executables from Perl programs, using the
  583. code generators provided by the L<B> module. At present, you may
  584. either create executable Perl bytecode, using the C<-B> option, or 
  585. generate and compile C files using the standard and 'optimised' C
  586. backends.
  587.  
  588. The code generated in this way is not guaranteed to work. The whole
  589. codegen suite (C<perlcc> included) should be considered B<very>
  590. experimental. Use for production purposes is strongly discouraged.
  591.  
  592. =head1 OPTIONS
  593.  
  594. =over 4
  595.  
  596. =item -LI<library directories>
  597.  
  598. Adds the given directories to the library search path when C code is
  599. passed to your C compiler.
  600.  
  601. =item -II<include directories>
  602.  
  603. Adds the given directories to the include file search path when C code is
  604. passed to your C compiler; when using the Perl bytecode option, adds the
  605. given directories to Perl's include path.
  606.  
  607. =item -o I<output file name>
  608.  
  609. Specifies the file name for the final compiled executable.
  610.  
  611. =item -c I<C file name>
  612.  
  613. Create C code only; do not compile to a standalone binary.
  614.  
  615. =item -e I<perl code>
  616.  
  617. Compile a one-liner, much the same as C<perl -e '...'>
  618.  
  619. =item -S
  620.  
  621. Do not delete generated C code after compilation.
  622.  
  623. =item -B
  624.  
  625. Use the Perl bytecode code generator.
  626.  
  627. =item -O
  628.  
  629. Use the 'optimised' C code generator. This is more experimental than
  630. everything else put together, and the code created is not guaranteed to
  631. compile in finite time and memory, or indeed, at all.
  632.  
  633. =item -v
  634.  
  635. Increase verbosity of output; can be repeated for more verbose output.
  636.  
  637. =item -r 
  638.  
  639. Run the resulting compiled script after compiling it.
  640.  
  641. =item -log
  642.  
  643. Log the output of compiling to a file rather than to stdout.
  644.  
  645. =back
  646.  
  647. =cut
  648.  
  649.