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 platforms 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.	Cor
	   rect 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 perlivps ability to function.  You may be able to correct
	   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 con
	   ducting 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 \"$mod
	   ule_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 installa
       tion:\n";
	   One or more files turned up missing according to a run of "ExtU
	   tils::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 systems C header files.  If nec
	   essary, 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			  2008-04-25			    PERLIVP(1)