Man page 1 : perlivp

perlivp - Perl Installation Verification Procedure

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

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.

-h help 5 Prints out a brief help message.

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

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

-v verbose 5 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.

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

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

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

4 print \*(L"# Needed module `$_' does not appear to be properly installed.\n\*(R"; .Sp 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 correct this by performing a proper perl installation.

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

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

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

4 print \*(L"# Perl header `$_' does not appear to be properly installed.\n\*(R"; .Sp 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.

Peter Prymmer