920 lines
26 KiB
Batchfile
920 lines
26 KiB
Batchfile
@rem = '--*-Perl-*--
|
||
@echo off
|
||
if "%OS%" == "Windows_NT" goto WinNT
|
||
perl -x -S "%0" %1 %2 %3 %4 %5 %6 %7 %8 %9
|
||
goto endofperl
|
||
:WinNT
|
||
perl -x -S "%0" %*
|
||
if NOT "%COMSPEC%" == "%SystemRoot%\system32\cmd.exe" goto endofperl
|
||
if %errorlevel% == 9009 echo You do not have Perl in your PATH.
|
||
goto endofperl
|
||
@rem ';
|
||
#!perl
|
||
#line 14
|
||
eval 'exec P:\Apps\ActivePerl\temp\bin\MSWin32-x86-object\perl.exe -S $0 ${1+"$@"}'
|
||
if $running_under_some_shell;
|
||
|
||
use Config;
|
||
use strict;
|
||
use FileHandle;
|
||
use File::Basename qw(&basename &dirname);
|
||
use Cwd;
|
||
|
||
use Getopt::Long;
|
||
|
||
$Getopt::Long::bundling_override = 1;
|
||
$Getopt::Long::passthrough = 0;
|
||
$Getopt::Long::ignore_case = 0;
|
||
|
||
my $options = {};
|
||
my $_fh;
|
||
|
||
main();
|
||
|
||
sub main
|
||
{
|
||
|
||
GetOptions
|
||
(
|
||
$options, "L:s",
|
||
"I:s",
|
||
"C:s",
|
||
"o:s",
|
||
"e:s",
|
||
"regex:s",
|
||
"verbose:s",
|
||
"log:s",
|
||
"argv:s",
|
||
"gen",
|
||
"sav",
|
||
"run",
|
||
"prog",
|
||
"mod"
|
||
);
|
||
|
||
|
||
my $key;
|
||
|
||
local($") = "|";
|
||
|
||
_usage() if (!_checkopts());
|
||
push(@ARGV, _maketempfile()) if ($options->{'e'});
|
||
|
||
_usage() if (!@ARGV);
|
||
|
||
my $file;
|
||
foreach $file (@ARGV)
|
||
{
|
||
_print("
|
||
--------------------------------------------------------------------------------
|
||
Compiling $file:
|
||
--------------------------------------------------------------------------------
|
||
", 36 );
|
||
_doit($file);
|
||
}
|
||
}
|
||
|
||
sub _doit
|
||
{
|
||
my ($file) = @_;
|
||
|
||
my ($program_ext, $module_ext) = _getRegexps();
|
||
my ($obj, $objfile, $so, $type);
|
||
|
||
if (
|
||
(($file =~ m"@$program_ext") && ($file !~ m"@$module_ext"))
|
||
|| (defined($options->{'prog'}) || defined($options->{'run'}))
|
||
)
|
||
{
|
||
$objfile = ($options->{'C'}) ? $options->{'C'} : "$file.c";
|
||
$type = 'program';
|
||
|
||
$obj = ($options->{'o'})? $options->{'o'} :
|
||
_getExecutable( $file,$program_ext);
|
||
|
||
return() if (!$obj);
|
||
|
||
}
|
||
elsif (($file =~ m"@$module_ext") || ($options->{'mod'}))
|
||
{
|
||
die "Shared objects are not supported on Win32 yet!!!!\n"
|
||
if ($Config{'osname'} eq 'MSWin32');
|
||
|
||
$obj = ($options->{'o'})? $options->{'o'} :
|
||
_getExecutable($file, $module_ext);
|
||
$so = "$obj.$Config{so}";
|
||
$type = 'sharedlib';
|
||
return() if (!$obj);
|
||
$objfile = ($options->{'C'}) ? $options->{'C'} : "$file.c";
|
||
}
|
||
else
|
||
{
|
||
_error("noextension", $file, $program_ext, $module_ext);
|
||
return();
|
||
}
|
||
|
||
if ($type eq 'program')
|
||
{
|
||
_print("Making C($objfile) for $file!\n", 36 );
|
||
|
||
my $errcode = _createCode($objfile, $file);
|
||
(_print( "ERROR: In generating code for $file!\n", -1), return())
|
||
if ($errcode);
|
||
|
||
_print("Compiling C($obj) for $file!\n", 36 ) if (!$options->{'gen'});
|
||
$errcode = _compileCode($file, $objfile, $obj)
|
||
if (!$options->{'gen'});
|
||
|
||
if ($errcode)
|
||
{
|
||
_print( "ERROR: In compiling code for $objfile !\n", -1);
|
||
my $ofile = File::Basename::basename($objfile);
|
||
$ofile =~ s"\.c$"\.o"s;
|
||
|
||
_removeCode("$ofile");
|
||
return()
|
||
}
|
||
|
||
_runCode($obj) if ($options->{'run'});
|
||
|
||
_removeCode($objfile) if (!$options->{'sav'} ||
|
||
($options->{'e'} && !$options->{'C'}));
|
||
|
||
_removeCode($file) if ($options->{'e'});
|
||
|
||
_removeCode($obj) if (($options->{'e'}
|
||
&& !$options->{'sav'}
|
||
&& !$options->{'o'})
|
||
|| ($options->{'run'} && !$options->{'sav'}));
|
||
}
|
||
else
|
||
{
|
||
_print( "Making C($objfile) for $file!\n", 36 );
|
||
my $errcode = _createCode($objfile, $file, $obj);
|
||
(_print( "ERROR: In generating code for $file!\n", -1), return())
|
||
if ($errcode);
|
||
|
||
_print( "Compiling C($so) for $file!\n", 36 ) if (!$options->{'gen'});
|
||
|
||
my $errorcode =
|
||
_compileCode($file, $objfile, $obj, $so ) if (!$options->{'gen'});
|
||
|
||
(_print( "ERROR: In compiling code for $objfile!\n", -1), return())
|
||
if ($errcode);
|
||
}
|
||
}
|
||
|
||
sub _getExecutable
|
||
{
|
||
my ($sourceprog, $ext) = @_;
|
||
my ($obj);
|
||
|
||
if (defined($options->{'regex'}))
|
||
{
|
||
eval("(\$obj = \$sourceprog) =~ $options->{'regex'}");
|
||
return(0) if (_error('badeval', $@));
|
||
return(0) if (_error('equal', $obj, $sourceprog));
|
||
}
|
||
elsif (defined ($options->{'ext'}))
|
||
{
|
||
($obj = $sourceprog) =~ s"@$ext"$options->{ext}"g;
|
||
return(0) if (_error('equal', $obj, $sourceprog));
|
||
}
|
||
elsif (defined ($options->{'run'}))
|
||
{
|
||
$obj = "perlc$$";
|
||
}
|
||
else
|
||
{
|
||
($obj = $sourceprog) =~ s"@$ext""g;
|
||
return(0) if (_error('equal', $obj, $sourceprog));
|
||
}
|
||
return($obj);
|
||
}
|
||
|
||
sub _createCode
|
||
{
|
||
my ( $generated_cfile, $file, $final_output ) = @_;
|
||
my $return;
|
||
|
||
local($") = " -I";
|
||
|
||
if (@_ == 2) # compiling a program
|
||
{
|
||
_print( "$^X -I@INC -MO=CC,-o$generated_cfile $file\n", 36);
|
||
$return = _run("$ -I@INC -MO=CC,-o$generated_cfile $file", 9);
|
||
$return;
|
||
}
|
||
else # compiling a shared object
|
||
{
|
||
_print(
|
||
"$ -I@INC -MO=CC,-m$final_output,-o$generated_cfile $file\n", 36);
|
||
$return =
|
||
_run("$ -I@INC -MO=CC,-m$final_output,-o$generated_cfile $file", 9);
|
||
$return;
|
||
}
|
||
}
|
||
|
||
sub _compileCode
|
||
{
|
||
my ($sourceprog, $generated_cfile, $output_executable, $shared_object) = @_;
|
||
my @return;
|
||
|
||
if (@_ == 3) # just compiling a program
|
||
{
|
||
$return[0] =
|
||
_ccharness('static', $sourceprog, "-o", $output_executable, $generated_cfile);
|
||
$return[0];
|
||
}
|
||
else
|
||
{
|
||
my $object_file = $generated_cfile;
|
||
$object_file =~ s"\.c$"$Config{_o}";
|
||
|
||
$return[0] = _ccharness('compile', $sourceprog, "-c", $generated_cfile);
|
||
$return[1] = _ccharness
|
||
(
|
||
'dynamic',
|
||
$sourceprog, "-o",
|
||
$shared_object, $object_file
|
||
);
|
||
return(1) if (grep ($_, @return));
|
||
return(0);
|
||
}
|
||
}
|
||
|
||
sub _runCode
|
||
{
|
||
my ($executable) = @_;
|
||
_print("$executable $options->{'argv'}\n", 36);
|
||
_run("$executable $options->{'argv'}", -1 );
|
||
}
|
||
|
||
sub _removeCode
|
||
{
|
||
my ($file) = @_;
|
||
unlink($file) if (-e $file);
|
||
}
|
||
|
||
sub _ccharness
|
||
{
|
||
my $type = shift;
|
||
my (@args) = @_;
|
||
local($") = " ";
|
||
|
||
my $sourceprog = shift(@args);
|
||
my ($libdir, $incdir);
|
||
|
||
if (-d "$Config{installarchlib}/CORE")
|
||
{
|
||
$libdir = "-L$Config{installarchlib}/CORE";
|
||
$incdir = "-I$Config{installarchlib}/CORE";
|
||
}
|
||
else
|
||
{
|
||
$libdir = "-L.. -L.";
|
||
$incdir = "-I.. -I.";
|
||
}
|
||
|
||
$libdir .= " -L$options->{L}" if (defined($options->{L}));
|
||
$incdir .= " -I$options->{L}" if (defined($options->{L}));
|
||
|
||
my $linkargs = '';
|
||
|
||
if (!grep(/^-[cS]$/, @args))
|
||
{
|
||
my $lperl = $^O eq 'os2' ? '-llibperl' : '-lperl';
|
||
my $flags = $type eq 'dynamic' ? $Config{lddlflags} : $Config{ldflags};
|
||
$linkargs = "$flags $libdir $lperl @Config{libs}";
|
||
}
|
||
|
||
my @sharedobjects = _getSharedObjects($sourceprog);
|
||
|
||
my $cccmd =
|
||
"$Config{cc} @Config{qw(ccflags optimize)} $incdir @sharedobjects @args $linkargs";
|
||
|
||
|
||
_print ("$cccmd\n", 36);
|
||
_run("$cccmd", 18 );
|
||
}
|
||
|
||
sub _getSharedObjects
|
||
{
|
||
my ($sourceprog) = @_;
|
||
my ($tmpfile, $incfile);
|
||
my (@return);
|
||
local($") = " -I";
|
||
|
||
if ($Config{'osname'} eq 'MSWin32')
|
||
{
|
||
# _addstuff;
|
||
}
|
||
else
|
||
{
|
||
my ($tmpprog);
|
||
($tmpprog = $sourceprog) =~ s"(.*)[\/\\](.*)"$2";
|
||
$tmpfile = "/tmp/$tmpprog.tst";
|
||
$incfile = "/tmp/$tmpprog.val";
|
||
}
|
||
|
||
my $fd = new FileHandle("> $tmpfile") || die "Couldn't open $tmpfile!\n";
|
||
my $fd2 =
|
||
new FileHandle("$sourceprog") || die "Couldn't open $sourceprog!\n";
|
||
|
||
my $perl = <$fd2>; # strip off header;
|
||
|
||
print $fd
|
||
<<"EOF";
|
||
use FileHandle;
|
||
my \$fh3 = new FileHandle("> $incfile")
|
||
|| die "Couldn't open $incfile\\n";
|
||
|
||
my \$key;
|
||
foreach \$key (keys(\%INC)) { print \$fh3 "\$key:\$INC{\$key}\\n"; }
|
||
close(\$fh3);
|
||
exit();
|
||
EOF
|
||
|
||
print $fd ( <$fd2> );
|
||
close($fd);
|
||
|
||
_print("$ -I@INC $tmpfile\n", 36);
|
||
_run("$ -I@INC $tmpfile", 9 );
|
||
|
||
$fd = new FileHandle ("$incfile");
|
||
my @lines = <$fd>;
|
||
|
||
unlink($tmpfile);
|
||
unlink($incfile);
|
||
|
||
my $line;
|
||
my $autolib;
|
||
|
||
foreach $line (@lines)
|
||
{
|
||
chomp($line);
|
||
my ($modname, $modpath) = split(':', $line);
|
||
my ($dir, $file) = ($modpath=~ m"(.*)[\\/]($modname)");
|
||
|
||
if ($autolib = _lookforAuto($dir, $file))
|
||
{
|
||
push(@return, $autolib);
|
||
}
|
||
}
|
||
|
||
return(@return);
|
||
}
|
||
|
||
sub _maketempfile
|
||
{
|
||
my $return;
|
||
|
||
# if ($Config{'osname'} eq 'MSWin32')
|
||
# { $return = "C:\\TEMP\\comp$$.p"; }
|
||
# else
|
||
# { $return = "/tmp/comp$$.p"; }
|
||
|
||
$return = "comp$$.p";
|
||
|
||
my $fd = new FileHandle( "> $return") || die "Couldn't open $return!\n";
|
||
print $fd $options->{'e'};
|
||
close($fd);
|
||
|
||
return($return);
|
||
}
|
||
|
||
|
||
sub _lookforAuto
|
||
{
|
||
my ($dir, $file) = @_;
|
||
|
||
my $relshared;
|
||
my $return;
|
||
|
||
($relshared = $file) =~ s"(.*)\.pm"$1";
|
||
|
||
my ($tmp, $modname) = ($relshared =~ m"(?:(.*)[\\/]){0,1}(.*)"s);
|
||
|
||
$relshared .=
|
||
($Config{'osname'} eq 'MSWin32')? "\\$modname.dll" : "/$modname.so";
|
||
|
||
|
||
|
||
if (-e ($return = "$Config{'installarchlib'}/auto/$relshared") )
|
||
{
|
||
return($return);
|
||
}
|
||
elsif (-e ($return = "$Config{'installsitearch'}/auto/$relshared"))
|
||
{
|
||
return($return);
|
||
}
|
||
elsif (-e ($return = "$dir/arch/auto/$relshared"))
|
||
{
|
||
return($return);
|
||
}
|
||
else
|
||
{
|
||
return(undef);
|
||
}
|
||
}
|
||
|
||
sub _getRegexps # make the appropriate regexps for making executables,
|
||
{ # shared libs
|
||
|
||
my ($program_ext, $module_ext) = ([],[]);
|
||
|
||
|
||
@$program_ext = ($ENV{PERL_SCRIPT_EXT})? split(':', $ENV{PERL_SCRIPT_EXT}) :
|
||
('.p$', '.pl$', '.bat$');
|
||
|
||
|
||
@$module_ext = ($ENV{PERL_MODULE_EXT})? split(':', $ENV{PERL_MODULE_EXT}) :
|
||
('.pm$');
|
||
|
||
|
||
_mungeRegexp( $program_ext );
|
||
_mungeRegexp( $module_ext );
|
||
|
||
return($program_ext, $module_ext);
|
||
}
|
||
|
||
sub _mungeRegexp
|
||
{
|
||
my ($regexp) = @_;
|
||
|
||
grep(s:(^|[^\\])\.:$1\x00\\.:g, @$regexp);
|
||
grep(s:(^|[^\x00])\\\.:$1\.:g, @$regexp);
|
||
grep(s:\x00::g, @$regexp);
|
||
}
|
||
|
||
|
||
sub _error
|
||
{
|
||
my ($type, @args) = @_;
|
||
|
||
if ($type eq 'equal')
|
||
{
|
||
|
||
if ($args[0] eq $args[1])
|
||
{
|
||
_print ("ERROR: The object file '$args[0]' does not generate a legitimate executable file! Skipping!\n", -1);
|
||
return(1);
|
||
}
|
||
}
|
||
elsif ($type eq 'badeval')
|
||
{
|
||
if ($args[0])
|
||
{
|
||
_print ("ERROR: $args[0]\n", -1);
|
||
return(1);
|
||
}
|
||
}
|
||
elsif ($type eq 'noextension')
|
||
{
|
||
my $progext = join(',', @{$args[1]});
|
||
my $modext = join(',', @{$args[2]});
|
||
|
||
$progext =~ s"\\""g;
|
||
$modext =~ s"\\""g;
|
||
|
||
$progext =~ s"\$""g;
|
||
$modext =~ s"\$""g;
|
||
|
||
_print
|
||
(
|
||
"
|
||
ERROR: '$args[0]' does not have a proper extension! Proper extensions are:
|
||
|
||
PROGRAM: $progext
|
||
SHARED OBJECT: $modext
|
||
|
||
Use the '-prog' flag to force your files to be interpreted as programs.
|
||
Use the '-mod' flag to force your files to be interpreted as modules.
|
||
", -1
|
||
);
|
||
return(1);
|
||
}
|
||
|
||
return(0);
|
||
}
|
||
|
||
sub _checkopts
|
||
{
|
||
my @errors;
|
||
local($") = "\n";
|
||
|
||
if ($options->{'log'})
|
||
{
|
||
$_fh = new FileHandle(">> $options->{'log'}") || push(@errors, "ERROR: Couldn't open $options->{'log'}\n");
|
||
}
|
||
|
||
if (($options->{'c'}) && (@ARGV > 1) && ($options->{'sav'} ))
|
||
{
|
||
push(@errors,
|
||
"ERROR: The '-sav' and '-C' options are incompatible when you have more than
|
||
one input file! ('-C' explicitly names resulting C code, '-sav' saves it,
|
||
and hence, with more than one file, the c code will be overwritten for
|
||
each file that you compile)\n");
|
||
}
|
||
if (($options->{'o'}) && (@ARGV > 1))
|
||
{
|
||
push(@errors,
|
||
"ERROR: The '-o' option is incompatible when you have more than one input file!
|
||
(-o explicitly names the resulting executable, hence, with more than
|
||
one file the names clash)\n");
|
||
}
|
||
|
||
if ($options->{'e'} && $options->{'sav'} && !$options->{'o'} &&
|
||
!$options->{'C'})
|
||
{
|
||
push(@errors,
|
||
"ERROR: You need to specify where you are going to save the resulting
|
||
executable or C code, when using '-sav' and '-e'. Use '-o' or '-C'.\n");
|
||
}
|
||
|
||
if (($options->{'regex'} || $options->{'run'} || $options->{'o'})
|
||
&& $options->{'gen'})
|
||
{
|
||
push(@errors,
|
||
"ERROR: The options '-regex', '-run', and '-o' are incompatible with '-gen'.
|
||
'-gen' says to stop at C generation, and the other three modify the
|
||
compilation and/or running process!\n");
|
||
}
|
||
|
||
if ($options->{'run'} && $options->{'mod'})
|
||
{
|
||
push(@errors,
|
||
"ERROR: Can't run modules that you are compiling! '-run' and '-mod' are
|
||
incompatible!\n");
|
||
}
|
||
|
||
if ($options->{'e'} && @ARGV)
|
||
{
|
||
push (@errors,
|
||
"ERROR: The option '-e' needs to be all by itself without any other
|
||
file arguments!\n");
|
||
}
|
||
if ($options->{'e'} && !($options->{'o'} || $options->{'run'}))
|
||
{
|
||
$options->{'run'} = 1;
|
||
}
|
||
|
||
if (!defined($options->{'verbose'}))
|
||
{
|
||
$options->{'verbose'} = ($options->{'log'})? 64 : 7;
|
||
}
|
||
|
||
my $verbose_error;
|
||
|
||
if ($options->{'verbose'} =~ m"[^tagfcd]" &&
|
||
!( $options->{'verbose'} eq '0' ||
|
||
($options->{'verbose'} < 64 && $options->{'verbose'} > 0)))
|
||
{
|
||
$verbose_error = 1;
|
||
push(@errors,
|
||
"ERROR: Illegal verbosity level. Needs to have either the letters
|
||
't','a','g','f','c', or 'd' in it or be between 0 and 63, inclusive.\n");
|
||
}
|
||
|
||
$options->{'verbose'} = ($options->{'verbose'} =~ m"[tagfcd]")?
|
||
($options->{'verbose'} =~ m"d") * 32 +
|
||
($options->{'verbose'} =~ m"c") * 16 +
|
||
($options->{'verbose'} =~ m"f") * 8 +
|
||
($options->{'verbose'} =~ m"t") * 4 +
|
||
($options->{'verbose'} =~ m"a") * 2 +
|
||
($options->{'verbose'} =~ m"g") * 1
|
||
: $options->{'verbose'};
|
||
|
||
if (!$verbose_error && ( $options->{'log'} &&
|
||
!(
|
||
($options->{'verbose'} & 8) ||
|
||
($options->{'verbose'} & 16) ||
|
||
($options->{'verbose'} & 32 )
|
||
)
|
||
)
|
||
)
|
||
{
|
||
push(@errors,
|
||
"ERROR: The verbosity level '$options->{'verbose'}' does not output anything
|
||
to a logfile, and you specified '-log'!\n");
|
||
} # }
|
||
|
||
if (!$verbose_error && ( !$options->{'log'} &&
|
||
(
|
||
($options->{'verbose'} & 8) ||
|
||
($options->{'verbose'} & 16) ||
|
||
($options->{'verbose'} & 32) ||
|
||
($options->{'verbose'} & 64)
|
||
)
|
||
)
|
||
)
|
||
{
|
||
push(@errors,
|
||
"ERROR: The verbosity level '$options->{'verbose'}' requires that you also
|
||
specify a logfile via '-log'\n");
|
||
} # }
|
||
|
||
|
||
(_print( "\n". join("\n", @errors), -1), return(0)) if (@errors);
|
||
return(1);
|
||
}
|
||
|
||
sub _print
|
||
{
|
||
my ($text, $flag ) = @_;
|
||
|
||
my $logflag = int($flag/8) * 8;
|
||
my $regflag = $flag % 8;
|
||
|
||
if ($flag == -1 || ($flag & $options->{'verbose'}))
|
||
{
|
||
my $dolog = ((($logflag & $options->{'verbose'}) || $flag == -1)
|
||
&& $options->{'log'});
|
||
|
||
my $doreg = (($regflag & $options->{'verbose'}) || $flag == -1);
|
||
|
||
if ($doreg) { print( STDERR $text ); }
|
||
if ($dolog) { print $_fh $text; }
|
||
}
|
||
}
|
||
|
||
sub _run
|
||
{
|
||
my ($command, $flag) = @_;
|
||
|
||
my $logflag = ($flag != -1)? int($flag/8) * 8 : 0;
|
||
my $regflag = $flag % 8;
|
||
|
||
if ($flag == -1 || ($flag & $options->{'verbose'}))
|
||
{
|
||
my $dolog = ($logflag & $options->{'verbose'} && $options->{'log'});
|
||
my $doreg = (($regflag & $options->{'verbose'}) || $flag == -1);
|
||
|
||
if ($doreg && !$dolog)
|
||
{ system("$command"); }
|
||
|
||
elsif ($doreg && $dolog)
|
||
{ my $text = `$command 2>&1`; print $_fh $text; print STDERR $text;}
|
||
else
|
||
{ my $text = `$command 2>&1`; print $_fh $text; }
|
||
}
|
||
else
|
||
{
|
||
`$command 2>&1`;
|
||
}
|
||
return($?);
|
||
}
|
||
|
||
sub _usage
|
||
{
|
||
_print
|
||
(
|
||
<<"EOF"
|
||
|
||
Usage: $0 <file_list>
|
||
|
||
Flags with arguments
|
||
-L < extra library dirs for installation (form of 'dir1:dir2') >
|
||
-I < extra include dirs for installation (form of 'dir1:dir2') >
|
||
-C < explicit name of resulting C code >
|
||
-o < explicit name of resulting executable >
|
||
-e < to compile 'one liners'. Need executable name (-o) or '-run'>
|
||
-regex < rename regex, -regex 's/\.p/\.exe/' compiles a.p to a.exe >
|
||
-verbose < verbose level (1-63, or following letters 'gatfcd' >
|
||
-argv < arguments for the executables to be run via '-run' or '-e' >
|
||
|
||
Boolean flags
|
||
-gen ( to just generate the c code. Implies '-sav' )
|
||
-sav ( to save intermediate c code, (and executables with '-run'))
|
||
-run ( to run the compiled program on the fly, as were interpreted.)
|
||
-prog ( to indicate that the files on command line are programs )
|
||
-mod ( to indicate that the files on command line are modules )
|
||
|
||
EOF
|
||
, -1
|
||
|
||
);
|
||
exit(255);
|
||
}
|
||
|
||
|
||
__END__
|
||
|
||
=head1 NAME
|
||
|
||
perlcc - frontend for perl compiler
|
||
|
||
=head1 SYNOPSIS
|
||
|
||
%prompt perlcc a.p # compiles into executable 'a'
|
||
|
||
%prompt perlcc A.pm # compile into 'A.so'
|
||
|
||
%prompt perlcc a.p -o execute # compiles 'a.p' into 'execute'.
|
||
|
||
%prompt perlcc a.p -o execute -run # compiles 'a.p' into execute, runs on
|
||
# the fly
|
||
|
||
%prompt perlcc a.p -o execute -run -argv 'arg1 arg2 arg3'
|
||
# compiles into execute, runs with
|
||
# arg1 arg2 arg3 as @ARGV
|
||
|
||
%prompt perlcc a.p b.p c.p -regex 's/\.p/\.exe'
|
||
# compiles into 'a.exe','b.exe','c.exe'.
|
||
|
||
%prompt perlcc a.p -log compilelog # compiles into 'a', saves compilation
|
||
# info into compilelog, as well
|
||
# as mirroring to screen
|
||
|
||
%prompt perlcc a.p -log compilelog -verbose cdf
|
||
# compiles into 'a', saves compilation
|
||
# info into compilelog, being silent
|
||
# on screen.
|
||
|
||
%prompt perlcc a.p -C a.c -gen # generates C code (into a.c) and
|
||
# stops without compile.
|
||
|
||
%prompt perlcc a.p -L ../lib a.c
|
||
# Compiles with the perl libraries
|
||
# inside ../lib included.
|
||
|
||
=head1 DESCRIPTION
|
||
|
||
'perlcc' is the frontend into the perl compiler. Typing 'perlcc a.p'
|
||
compiles the code inside a.p into a standalone executable, and
|
||
perlcc A.pm will compile into a shared object, A.so, suitable for inclusion
|
||
into a perl program via "use A".
|
||
|
||
There are quite a few flags to perlcc which help with such issues as compiling
|
||
programs in bulk, testing compiled programs for compatibility with the
|
||
interpreter, and controlling.
|
||
|
||
=head1 OPTIONS
|
||
|
||
=over 4
|
||
|
||
=item -L < library_directories >
|
||
|
||
Adds directories in B<library_directories> to the compilation command.
|
||
|
||
=item -I < include_directories >
|
||
|
||
Adds directories inside B<include_directories> to the compilation command.
|
||
|
||
=item -C < c_code_name >
|
||
|
||
Explicitly gives the name B<c_code_name> to the generated c code which is to
|
||
be compiled. Can only be used if compiling one file on the command line.
|
||
|
||
=item -o < executable_name >
|
||
|
||
Explicitly gives the name B<executable_name> to the executable which is to be
|
||
compiled. Can only be used if compiling one file on the command line.
|
||
|
||
=item -e < perl_line_to_execute>
|
||
|
||
Compiles 'one liners', in the same way that B<perl -e> runs text strings at
|
||
the command line. Default is to have the 'one liner' be compiled, and run all
|
||
in one go (see B<-run>); giving the B<-o> flag saves the resultant executable,
|
||
rather than throwing it away. Use '-argv' to pass arguments to the executable
|
||
created.
|
||
|
||
=item -regex <rename_regex>
|
||
|
||
Gives a rule B<rename_regex> - which is a legal perl regular expression - to
|
||
create executable file names.
|
||
|
||
=item -verbose <verbose_level>
|
||
|
||
Show exactly what steps perlcc is taking to compile your code. You can change
|
||
the verbosity level B<verbose_level> much in the same way that the '-D' switch
|
||
changes perl's debugging level, by giving either a number which is the sum of
|
||
bits you want or a list of letters representing what you wish to see. Here are
|
||
the verbosity levels so far :
|
||
|
||
Bit 1(g): Code Generation Errors to STDERR
|
||
Bit 2(a): Compilation Errors to STDERR
|
||
Bit 4(t): Descriptive text to STDERR
|
||
Bit 8(f): Code Generation Errors to file (B<-log> flag needed)
|
||
Bit 16(c): Compilation Errors to file (B<-log> flag needed)
|
||
Bit 32(d): Descriptive text to file (B<-log> flag needed)
|
||
|
||
If the B<-log> tag is given, the default verbose level is 63 (ie: mirroring
|
||
all of perlcc's output to both the screen and to a log file). If no B<-log>
|
||
tag is given, then the default verbose level is 7 (ie: outputting all of
|
||
perlcc's output to STDERR).
|
||
|
||
NOTE: Because of buffering concerns, you CANNOT shadow the output of '-run' to
|
||
both a file, and to the screen! Suggestions are welcome on how to overcome this
|
||
difficulty, but for now it simply does not work properly, and hence will only go
|
||
to the screen.
|
||
|
||
=item -log <logname>
|
||
|
||
Opens, for append, a logfile to save some or all of the text for a given
|
||
compile command. No rewrite version is available, so this needs to be done
|
||
manually.
|
||
|
||
=item -argv <arguments>
|
||
|
||
In combination with '-run' or '-e', tells perlcc to run the resulting
|
||
executable with the string B<arguments> as @ARGV.
|
||
|
||
=item -sav
|
||
|
||
Tells perl to save the intermediate C code. Usually, this C code is the name
|
||
of the perl code, plus '.c'; 'perlcode.p' gets generated in 'perlcode.p.c',
|
||
for example. If used with the '-e' operator, you need to tell perlcc where to
|
||
save resulting executables.
|
||
|
||
=item -gen
|
||
|
||
Tells perlcc to only create the intermediate C code, and not compile the
|
||
results. Does an implicit B<-sav>, saving the C code rather than deleting it.
|
||
|
||
=item -run
|
||
|
||
Immediately run the perl code that has been generated. NOTE: IF YOU GIVE THE
|
||
B<-run> FLAG TO B<perlcc>, THEN THE REST OF @ARGV WILL BE INTERPRETED AS
|
||
ARGUMENTS TO THE PROGRAM THAT YOU ARE COMPILING.
|
||
|
||
=item -prog
|
||
|
||
Indicate that the programs at the command line are programs, and should be
|
||
compiled as such. B<perlcc> will automatically determine files to be
|
||
programs if they have B<.p>, B<.pl>, B<.bat> extensions.
|
||
|
||
=item -mod
|
||
|
||
Indicate that the programs at the command line are modules, and should be
|
||
compiled as such. B<perlcc> will automatically determine files to be
|
||
modules if they have the extension B<.pm>.
|
||
|
||
=back
|
||
|
||
=head1 ENVIRONMENT
|
||
|
||
Most of the work of B<perlcc> is done at the command line. However, you can
|
||
change the heuristic which determines what is a module and what is a program.
|
||
As indicated above, B<perlcc> assumes that the extensions:
|
||
|
||
.p$, .pl$, and .bat$
|
||
|
||
indicate a perl program, and:
|
||
|
||
.pm$
|
||
|
||
indicate a library, for the purposes of creating executables. And furthermore,
|
||
by default, these extensions will be replaced (and dropped ) in the process of
|
||
creating an executable.
|
||
|
||
To change the extensions which are programs, and which are modules, set the
|
||
environmental variables:
|
||
|
||
PERL_SCRIPT_EXT
|
||
PERL_MODULE_EXT
|
||
|
||
These two environmental variables take colon-separated, legal perl regular
|
||
expressions, and are used by perlcc to decide which objects are which.
|
||
For example:
|
||
|
||
setenv PERL_SCRIPT_EXT '.prl$:.perl$'
|
||
prompt% perlcc sample.perl
|
||
|
||
will compile the script 'sample.perl' into the executable 'sample', and
|
||
|
||
setenv PERL_MODULE_EXT '.perlmod$:.perlmodule$'
|
||
|
||
prompt% perlcc sample.perlmod
|
||
|
||
will compile the module 'sample.perlmod' into the shared object
|
||
'sample.so'
|
||
|
||
NOTE: the '.' in the regular expressions for PERL_SCRIPT_EXT and PERL_MODULE_EXT
|
||
is a literal '.', and not a wild-card. To get a true wild-card, you need to
|
||
backslash the '.'; as in:
|
||
|
||
setenv PERL_SCRIPT_EXT '\.\.\.\.\.'
|
||
|
||
which would have the effect of compiling ANYTHING (except what is in
|
||
PERL_MODULE_EXT) into an executable with 5 less characters in its name.
|
||
|
||
=head1 FILES
|
||
|
||
'perlcc' uses a temporary file when you use the B<-e> option to evaluate
|
||
text and compile it. This temporary file is 'perlc$$.p'. The temporary C code is
|
||
perlc$$.p.c, and the temporary executable is perlc$$.
|
||
|
||
When you use '-run' and don't save your executable, the temporary executable is
|
||
perlc$$
|
||
|
||
=head1 BUGS
|
||
|
||
perlcc currently cannot compile shared objects on Win32. This should be fixed
|
||
by perl5.005.
|
||
|
||
=cut
|
||
|
||
__END__
|
||
:endofperl
|