This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

PERLIVP(1)                            Perl Programmers Reference Guide                            PERLIVP(1)



NAME
       perlivp - Perl Installation Verification Procedure

SYNOPSIS
       perlivp [-a] [-p] [-v] [-h]

DESCRIPTION
       The perlivp program is set up at Perl source code build time to test the Perl version it was built
       under.  It can be used after running:

           make install

       (or your platform's equivalent procedure) to verify that perl and its libraries have been installed
       correctly.  A correct installation is verified by output that looks like:

           ok 1
           ok 2

       etc.

OPTIONS
       -h help
            Prints out a brief help message.

       -a run all tests
            Normally tests for optional features are skipped.  With -a all tests are executed.

       -p print preface
            Gives a description of each test prior to performing it.

       -v verbose
            Gives more detailed information about each test, after it has been performed.  Note that any
            failed tests ought to print out some extra information whether or not -v is thrown.

DIAGNOSTICS
       * print "# Perl binary `$perlpath' does not appear executable.\n";
           Likely to occur for a perl binary that was not properly installed.  Correct by conducting a
           proper installation.

       * print "# Perl version `$]' installed, expected $ivp_VERSION.\n";
           Likely to occur for a perl that was not properly installed.  Correct by conducting a proper
           installation.

       * print "# Perl \@INC directory `$_' does not appear to exist.\n";
           Likely to occur for a perl library tree that was not properly installed.  Correct by conducting a
           proper installation.

       * print "# Needed module `$_' does not appear to be properly installed.\n";
           One of the two modules that is used by perlivp was not present in the installation.  This is a
           serious error since it adversely affects perlivp's ability to function.  You may be able to cor-rect correct
           rect this by performing a proper perl installation.

       * print "# Required module `$_' does not appear to be properly installed.\n";
           An attempt to "eval "require $module"" failed, even though the list of extensions indicated that
           it should succeed.  Correct by conducting a proper installation.

       * print "# Unnecessary module `bLuRfle' appears to be installed.\n";
           This test not coming out ok could indicate that you have in fact installed a bLuRfle.pm module or
           that the "eval " require \"$module_name.pm\"; "" test may give misleading results with your
           installation of perl.  If yours is the latter case then please let the author know.

       * print "# file",+($#missing == 0) ? '' : 's'," missing from installation:\n";
           One or more files turned up missing according to a run of "ExtUtils::Installed -> validate()"
           over your installation.  Correct by conducting a proper installation.

       * print "# Perl header `$_' does not appear to be properly installed.\n";
           Correct by running h2ph over your system's C header files.  If necessary, edit the resulting *.ph
           files to eliminate perl syntax errors.

       For further information on how to conduct a proper installation consult the INSTALL file that comes
       with the perl source and the README file for your platform.

AUTHOR
       Peter Prymmer



perl v5.8.8                                      2007-09-23                                       PERLIVP(1)