'br}

'br}

{\

NAME

perlivp - Perl Installation Verification Procedure

SYNOPSIS

perlivp [-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

\fB-h\fR help 5

Prints out a brief help message.

\fB-p\fR print preface 5

Gives a description of each test prior to performing it.

\fB-v\fR 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.

DIAGNOSTICS

\(bu 4

print *(L"# Perl binary '$perlpath' does not appear executable.en*(R";

Likely to occur for a perl binary that was not properly installed. Correct by conducting a proper installation.

\(bu 4

print *(L"# Perl version '$]' installed, expected f(CW$ivp_VERSION.en*(R";

Likely to occur for a perl that was not properly installed. Correct by conducting a proper installation.

\(bu 4

print *(L"# Perl e@INC directory '$_' does not appear to exist.en*(R";

Likely to occur for a perl library tree that was not properly installed. Correct by conducting a proper installation.

\(bu 4

print *(L"# Needed module '$_' does not appear to be properly installed.en*(R";

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.

\(bu 4

print *(L"# Required module '$_' does not appear to be properly installed.en*(R";

An attempt to f(CW*(C`eval "require $module"*(C' failed, even though the list of extensions indicated that it should succeed. Correct by conducting a proper installation.

\(bu 4

print *(L"# Unnecessary module 'bLuRfle' appears to be installed.en*(R";

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 e"$module_name.pme"; "*(C' test may give misleading results with your installation of perl. If yours is the latter case then please let the author know.

\(bu 4

print *(L"# file*(R",+($#missing == 0) ? '' : 's',*(L" missing from installation:en*(R";

One or more files turned up missing according to a run of f(CW*(C`ExtUtils::Installed -> validate()*(C' over your installation. Correct by conducting a proper installation.

For further information on how to conduct a proper installation consult the s-1INSTALLs0 file that comes with the perl source and the s-1READMEs0 file for your platform.

AUTHOR

Peter Prymmer