home *** CD-ROM | disk | FTP | other *** search
/ PC World 2003 March / PCWorld_2003-03_cd.bin / Software / Topware / activeperl / ActivePerl / Perl / bin / perlivp.bat < prev    next >
Encoding:
DOS Batch File  |  2002-12-01  |  12.3 KB  |  436 lines
  1. @rem = '--*-Perl-*--
  2. @echo off
  3. if "%OS%" == "Windows_NT" goto WinNT
  4. perl -x -S "%0" %1 %2 %3 %4 %5 %6 %7 %8 %9
  5. goto endofperl
  6. :WinNT
  7. perl -x -S %0 %*
  8. if NOT "%COMSPEC%" == "%SystemRoot%\system32\cmd.exe" goto endofperl
  9. if %errorlevel% == 9009 echo You do not have Perl in your PATH.
  10. if errorlevel 1 goto script_failed_so_exit_with_non_zero_val 2>nul
  11. goto endofperl
  12. @rem ';
  13. #!perl
  14. #line 15
  15.     eval 'exec D:\p4\Apps\Gecko\MSI\data\ActivePerl\Perl\bin\perl.exe -S $0 ${1+"$@"}'
  16.         if $running_under_some_shell;
  17.  
  18. # perlivp V 0.02
  19.  
  20.  
  21. sub usage {
  22.     warn "@_\n" if @_;
  23.     print << "    EOUSAGE";
  24. Usage:
  25.  
  26.     $0 [-p] [-v] | [-h]
  27.  
  28.     -p Print a preface before each test telling what it will test.
  29.     -v Verbose mode in which extra information about test results
  30.        is printed.  Test failures always print out some extra information
  31.        regardless of whether or not this switch is set.
  32.     -h Prints this help message.
  33.     EOUSAGE
  34.     exit;
  35. }
  36.  
  37. use vars qw(%opt); # allow testing with older versions (do not use our)
  38.  
  39. @opt{ qw/? H h P p V v/ } = qw(0 0 0 0 0 0 0);
  40.  
  41. while ($ARGV[0] =~ /^-/) {
  42.     $ARGV[0] =~ s/^-//; 
  43.     for my $flag (split(//,$ARGV[0])) {
  44.         usage() if '?' =~ /\Q$flag/;
  45.         usage() if 'h' =~ /\Q$flag/;
  46.         usage() if 'H' =~ /\Q$flag/;
  47.         usage("unknown flag: `$flag'") unless 'HhPpVv' =~ /\Q$flag/;
  48.         warn "$0: `$flag' flag already set\n" if $opt{$flag}++;
  49.     } 
  50.     shift;
  51. }
  52.  
  53. $opt{p}++ if $opt{P};
  54. $opt{v}++ if $opt{V};
  55.  
  56. my $pass__total = 0;
  57. my $error_total = 0;
  58. my $tests_total = 0;
  59.  
  60. my $perlpath = 'D:\p4\Apps\Gecko\MSI\data\ActivePerl\Perl\bin\perl.exe';
  61. my $useithreads = 'define';
  62.  
  63. print "## Checking Perl binary via variable `\$perlpath' = $perlpath.\n" if $opt{'p'};
  64.  
  65. if (-x $perlpath) {
  66.     print "## Perl binary `$perlpath' appears executable.\n" if $opt{'v'};
  67.     print "ok 1\n";
  68.     $pass__total++;
  69. }
  70. else {
  71.     print "# Perl binary `$perlpath' does not appear executable.\n";
  72.     print "not ok 1\n";
  73.     $error_total++;
  74. }
  75. $tests_total++;
  76.  
  77.  
  78. print "## Checking Perl version via variable `\$]'.\n" if $opt{'p'};
  79.  
  80. my $ivp_VERSION = 5.008;
  81.  
  82. if ($ivp_VERSION == $]) {
  83.     print "## Perl version `$]' appears installed as expected.\n" if $opt{'v'};
  84.     print "ok 2\n";
  85.     $pass__total++;
  86. }
  87. else {
  88.     print "# Perl version `$]' installed, expected $ivp_VERSION.\n";
  89.     print "not ok 2\n";
  90.     $error_total++;
  91. }
  92. $tests_total++;
  93.  
  94.  
  95. print "## Checking roots of the Perl library directory tree via variable `\@INC'.\n" if $opt{'p'};
  96.  
  97. my $INC_total = 0;
  98. my $INC_there = 0;
  99. foreach (@INC) {
  100.     next if $_ eq '.'; # skip -d test here
  101.     if ($^O eq 'MacOS') {
  102.         next if $_ eq ':'; # skip -d test here
  103.         next if $_ eq 'Dev:Pseudo:'; # why is this in @INC?
  104.     }
  105.     if (-d $_) {
  106.         print "## Perl \@INC directory `$_' exists.\n" if $opt{'v'};
  107.         $INC_there++;
  108.     }
  109.     else {
  110.         print "# Perl \@INC directory `$_' does not appear to exist.\n";
  111.     }
  112.     $INC_total++;
  113. }
  114. if ($INC_total == $INC_there) {
  115.     print "ok 3\n";
  116.     $pass__total++;
  117. }
  118. else {
  119.     print "not ok 3\n";
  120.     $error_total++;
  121. }
  122. $tests_total++;
  123.  
  124.  
  125. print "## Checking installations of modules necessary for ivp.\n" if $opt{'p'};
  126.  
  127. my $needed_total = 0;
  128. my $needed_there = 0;
  129. foreach (qw(Config.pm ExtUtils/Installed.pm)) {
  130.     $@ = undef;
  131.     $needed_total++;
  132.     eval "require \"$_\";";
  133.     if (!$@) {
  134.         print "## Module `$_' appears to be installed.\n" if $opt{'v'};
  135.         $needed_there++;
  136.     }
  137.     else {
  138.         print "# Needed module `$_' does not appear to be properly installed.\n";
  139.     }
  140.     $@ = undef;
  141. }
  142. if ($needed_total == $needed_there) {
  143.     print "ok 4\n";
  144.     $pass__total++;
  145. }
  146. else {
  147.     print "not ok 4\n";
  148.     $error_total++;
  149. }
  150. $tests_total++;
  151.  
  152.  
  153. print "## Checking installations of extensions built with perl.\n" if $opt{'p'};
  154.  
  155. use Config;
  156.  
  157. my $extensions_total = 0;
  158. my $extensions_there = 0;
  159. if (defined($Config{'extensions'})) {
  160.     my @extensions = split(/\s+/,$Config{'extensions'});
  161.     foreach (@extensions) {
  162.         next if ($_ eq '');
  163.         if ( $useithreads !~ /define/i ) {
  164.             next if ($_ eq 'threads');
  165.             next if ($_ eq 'threads/shared');
  166.         }
  167.         next if ($_ eq 'Devel/DProf'); 
  168.            # VMS$ perl  -e "eval ""require \""Devel/DProf.pm\"";"" print $@"
  169.            # \NT> perl  -e "eval \"require 'Devel/DProf.pm'\"; print $@"
  170.            # DProf: run perl with -d to use DProf.
  171.            # Compilation failed in require at (eval 1) line 1.
  172.         eval " require \"$_.pm\"; ";
  173.         if (!$@) {
  174.             print "## Module `$_' appears to be installed.\n" if $opt{'v'};
  175.             $extensions_there++;
  176.         }
  177.         else {
  178.             print "# Required module `$_' does not appear to be properly installed.\n";
  179.             $@ = undef;
  180.         }
  181.         $extensions_total++;
  182.     }
  183.  
  184.     # A silly name for a module (that hopefully won't ever exist).
  185.     # Note that this test serves more as a check of the validity of the
  186.     # actuall required module tests above.
  187.     my $unnecessary = 'bLuRfle';
  188.  
  189.     if (!grep(/$unnecessary/, @extensions)) {
  190.         $@ = undef;
  191.         eval " require \"$unnecessary.pm\"; ";
  192.         if ($@) {
  193.             print "## Unnecessary module `$unnecessary' does not appear to be installed.\n" if $opt{'v'};
  194.         }
  195.         else {
  196.             print "# Unnecessary module `$unnecessary' appears to be installed.\n";
  197.             $extensions_there++;
  198.         }
  199.     }
  200.     $@ = undef;
  201. }
  202. if ($extensions_total == $extensions_there) {
  203.     print "ok 5\n";
  204.     $pass__total++;
  205. }
  206. else {
  207.     print "not ok 5\n";
  208.     $error_total++;
  209. }
  210. $tests_total++;
  211.  
  212.  
  213. print "## Checking installations of later additional extensions.\n" if $opt{'p'};
  214.  
  215. use ExtUtils::Installed;
  216.  
  217. my $installed_total = 0;
  218. my $installed_there = 0;
  219. my $version_check = 0;
  220. my $installed = ExtUtils::Installed -> new();
  221. my @modules = $installed -> modules();
  222. my @missing = ();
  223. my $version = undef;
  224. for (@modules) {
  225.     $installed_total++;
  226.     # Consider it there if it contains one or more files,
  227.     # and has zero missing files,
  228.     # and has a defined version
  229.     $version = undef;
  230.     $version = $installed -> version($_);
  231.     if ($version) {
  232.         print "## $_; $version\n" if $opt{'v'};
  233.         $version_check++;
  234.     }
  235.     else {
  236.         print "# $_; NO VERSION\n" if $opt{'v'};
  237.     }
  238.     $version = undef;
  239.     @missing = ();
  240.     @missing = $installed -> validate($_);
  241.     if ($#missing >= 0) {
  242.         print "# file",+($#missing == 0) ? '' : 's'," missing from installation:\n";
  243.         print '# ',join(' ',@missing),"\n";
  244.     }
  245.     elsif ($#missing == -1) {
  246.         $installed_there++;
  247.     }
  248.     @missing = ();
  249. }
  250. if (($installed_total == $installed_there) && 
  251.     ($installed_total == $version_check)) {
  252.     print "ok 6\n";
  253.     $pass__total++;
  254. }
  255. else {
  256.     print "not ok 6\n";
  257.     $error_total++;
  258. }
  259. $tests_total++;
  260.  
  261.  
  262. print "## Checking installations of *.h -> *.ph header files.\n" if $opt{'p'};
  263. my $ph_there = 0;
  264. my $var = undef;
  265. my $val = undef;
  266. my $h_file = undef;
  267. # Just about "any" C implementation ought to have a stdio.h (even if 
  268. # Config.pm may not list a i_stdio var).
  269. my @ph_files = qw(stdio.ph);
  270. # Add the ones that we know that perl thinks are there:
  271. while (($var, $val) = each %Config) {
  272.     if ($var =~ m/i_(.+)/ && $val eq 'define') {
  273.         $h_file = $1;
  274.     # Some header and symbol names don't match for hysterical raisins.
  275.     $h_file = 'arpa/inet'    if $h_file eq 'arpainet';
  276.     $h_file = 'netinet/in'   if $h_file eq 'niin';
  277.     $h_file = 'netinet/tcp'  if $h_file eq 'netinettcp';
  278.     $h_file = 'sys/resource' if $h_file eq 'sysresrc';
  279.     $h_file = 'sys/select'   if $h_file eq 'sysselct';
  280.     $h_file = 'sys/security' if $h_file eq 'syssecrt';
  281.         $h_file = 'rpcsvc/dbm'   if $h_file eq 'rpcsvcdbm';
  282.         # This ought to distinguish syslog from sys/syslog.
  283.         # (NB syslog.ph is heavily used for the DBI pre-requisites).
  284.         $h_file =~ s{^sys(\w.+)}{sys/$1} unless $h_file eq 'syslog';
  285.         push(@ph_files, "$h_file.ph");
  286.     }
  287. }
  288. #foreach (qw(stdio.ph syslog.ph)) {
  289. foreach (@ph_files) {
  290.     $@ = undef;
  291.     eval "require \"$_\";";
  292.     if (!$@) {
  293.         print "## Perl header `$_' appears to be installed.\n" if $opt{'v'};
  294.         $ph_there++;
  295.     }
  296.     else {
  297.         print "# Perl header `$_' does not appear to be properly installed.\n";
  298.     }
  299.     $@ = undef;
  300. }
  301.  
  302. if (scalar(@ph_files) == $ph_there) {
  303.     print "ok 7\n";
  304.     $pass__total++;
  305. }
  306. else {
  307.     print "not ok 7\n";
  308.     $error_total++;
  309. }
  310. $tests_total++;
  311.  
  312. # Final report (rather than feed ousrselves to Test::Harness::runtests()
  313. # we simply format some output on our own to keep things simple and
  314. # easier to "fix" - at least for now.
  315.  
  316. if ($error_total == 0 && $tests_total) {
  317.     print "All tests successful.\n";
  318. } elsif ($tests_total==0){
  319.         die "FAILED--no tests were run for some reason.\n";
  320. } else {
  321.     my $rate = 0.0;
  322.     if ($tests_total > 0) { $rate = sprintf "%.2f", 100.0 * ($pass__total / $tests_total); }
  323.     printf " %d/%d subtests failed, %.2f%% okay.\n",
  324.                               $error_total, $tests_total, $rate;
  325. }
  326.  
  327. =head1 NAME
  328.  
  329. B<perlivp> - Perl Installation Verification Procedure
  330.  
  331. =head1 SYNOPSIS
  332.  
  333. B<perlivp> [B<-p>] [B<-v>] [B<-h>]
  334.  
  335. =head1 DESCRIPTION
  336.  
  337. The B<perlivp> program is set up at Perl source code build time to test the
  338. Perl version it was built under.  It can be used after running:
  339.  
  340.     make install
  341.  
  342. (or your platform's equivalent procedure) to verify that B<perl> and its
  343. libraries have been installed correctly.  A correct installation is verified
  344. by output that looks like:
  345.  
  346.     ok 1
  347.     ok 2
  348.  
  349. etc.
  350.  
  351. =head1 OPTIONS
  352.  
  353. =over 5
  354.  
  355. =item B<-h> help
  356.  
  357. Prints out a brief help message.
  358.  
  359. =item B<-p> print preface
  360.  
  361. Gives a description of each test prior to performing it.
  362.  
  363. =item B<-v> verbose
  364.  
  365. Gives more detailed information about each test, after it has been performed.
  366. Note that any failed tests ought to print out some extra information whether
  367. or not -v is thrown.
  368.  
  369. =back
  370.  
  371. =head1 DIAGNOSTICS
  372.  
  373. =over 4
  374.  
  375. =item * print "# Perl binary `$perlpath' does not appear executable.\n";
  376.  
  377. Likely to occur for a perl binary that was not properly installed.
  378. Correct by conducting a proper installation.
  379.  
  380. =item * print "# Perl version `$]' installed, expected $ivp_VERSION.\n";
  381.  
  382. Likely to occur for a perl that was not properly installed.
  383. Correct by conducting a proper installation.
  384.  
  385. =item * print "# Perl \@INC directory `$_' does not appear to exist.\n";
  386.  
  387. Likely to occur for a perl library tree that was not properly installed.
  388. Correct by conducting a proper installation.
  389.  
  390. =item * print "# Needed module `$_' does not appear to be properly installed.\n";
  391.  
  392. One of the two modules that is used by perlivp was not present in the 
  393. installation.  This is a serious error since it adversely affects perlivp's
  394. ability to function.  You may be able to correct this by performing a
  395. proper perl installation.
  396.  
  397. =item * print "# Required module `$_' does not appear to be properly installed.\n";
  398.  
  399. An attempt to C<eval "require $module"> failed, even though the list of 
  400. extensions indicated that it should succeed.  Correct by conducting a proper 
  401. installation.
  402.  
  403. =item * print "# Unnecessary module `bLuRfle' appears to be installed.\n";
  404.  
  405. This test not coming out ok could indicate that you have in fact installed 
  406. a bLuRfle.pm module or that the C<eval " require \"$module_name.pm\"; ">
  407. test may give misleading results with your installation of perl.  If yours
  408. is the latter case then please let the author know.
  409.  
  410. =item * print "# file",+($#missing == 0) ? '' : 's'," missing from installation:\n";
  411.  
  412. One or more files turned up missing according to a run of 
  413. C<ExtUtils::Installed -E<gt> validate()> over your installation.
  414. Correct by conducting a proper installation.
  415.  
  416. =item * print "# Perl header `$_' does not appear to be properly installed.\n";
  417.  
  418. Correct by running B<h2ph> over your system's C header files.  If necessary, 
  419. edit the resulting *.ph files to eliminate perl syntax errors.
  420.  
  421. =back
  422.  
  423. For further information on how to conduct a proper installation consult the 
  424. INSTALL file that comes with the perl source and the README file for your 
  425. platform.
  426.  
  427. =head1 AUTHOR
  428.  
  429. Peter Prymmer
  430.  
  431. =cut
  432.  
  433.  
  434. __END__
  435. :endofperl
  436.