1PERLIVP(1)             Perl Programmers Reference Guide             PERLIVP(1)
2
3
4

NAME

6       perlivp - Perl Installation Verification Procedure
7

SYNOPSIS

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

DESCRIPTION

12       The perlivp program is set up at Perl source code build time to test
13       the Perl version it was built under.  It can be used after running:
14
15           make install
16
17       (or your platform's equivalent procedure) to verify that perl and its
18       libraries have been installed correctly.  A correct installation is
19       verified by output that looks like:
20
21           ok 1
22           ok 2
23
24       etc.
25

OPTIONS

27       -h help
28            Prints out a brief help message.
29
30       -a run all tests
31            Normally tests for optional features are skipped.  With -a all
32            tests are executed.
33
34       -p print preface
35            Gives a description of each test prior to performing it.
36
37       -v verbose
38            Gives more detailed information about each test, after it has been
39            performed.  Note that any failed tests ought to print out some
40            extra information whether or not -v is thrown.
41

DIAGNOSTICS

43       * print "# Perl binary `$perlpath' does not appear executable.\n";
44           Likely to occur for a perl binary that was not properly installed.
45           Correct by conducting a proper installation.
46
47       * print "# Perl version `$]' installed, expected $ivp_VERSION.\n";
48           Likely to occur for a perl that was not properly installed.  Cor‐
49           rect by conducting a proper installation.
50
51       * print "# Perl \@INC directory `$_' does not appear to exist.\n";
52           Likely to occur for a perl library tree that was not properly
53           installed.  Correct by conducting a proper installation.
54
55       * print "# Needed module `$_' does not appear to be properly
56       installed.\n";
57           One of the two modules that is used by perlivp was not present in
58           the installation.  This is a serious error since it adversely
59           affects perlivp's ability to function.  You may be able to correct
60           this by performing a proper perl installation.
61
62       * print "# Required module `$_' does not appear to be properly
63       installed.\n";
64           An attempt to "eval "require $module"" failed, even though the list
65           of extensions indicated that it should succeed.  Correct by con‐
66           ducting a proper installation.
67
68       * print "# Unnecessary module `bLuRfle' appears to be installed.\n";
69           This test not coming out ok could indicate that you have in fact
70           installed a bLuRfle.pm module or that the "eval " require \"$mod‐
71           ule_name.pm\"; "" test may give misleading results with your
72           installation of perl.  If yours is the latter case then please let
73           the author know.
74
75       * print "# file",+($#missing == 0) ? '' : 's'," missing from installa‐
76       tion:\n";
77           One or more files turned up missing according to a run of "ExtU‐
78           tils::Installed -> validate()" over your installation.  Correct by
79           conducting a proper installation.
80
81       * print "# Perl header `$_' does not appear to be properly
82       installed.\n";
83           Correct by running h2ph over your system's C header files.  If nec‐
84           essary, edit the resulting *.ph files to eliminate perl syntax
85           errors.
86
87       For further information on how to conduct a proper installation consult
88       the INSTALL file that comes with the perl source and the README file
89       for your platform.
90

AUTHOR

92       Peter Prymmer
93
94
95
96perl v5.8.8                       2008-05-05                        PERLIVP(1)
Impressum