1PERLIVP(1) Perl Programmers Reference Guide PERLIVP(1)
2
3
4
6 perlivp - Perl Installation Verification Procedure
7
9 perlivp [-a] [-p] [-v] [-h]
10
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
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
43 · print "# Perl binary `$perlpath' does not appear executable.\n";
44
45 Likely to occur for a perl binary that was not properly installed.
46 Correct by conducting a proper installation.
47
48 · print "# Perl version `$]' installed, expected $ivp_VERSION.\n";
49
50 Likely to occur for a perl that was not properly installed.
51 Correct by conducting a proper installation.
52
53 · print "# Perl \@INC directory `$_' does not appear to exist.\n";
54
55 Likely to occur for a perl library tree that was not properly
56 installed. Correct by conducting a proper installation.
57
58 · print "# Needed module `$_' does not appear to be properly
59 installed.\n";
60
61 One of the two modules that is used by perlivp was not present in
62 the installation. This is a serious error since it adversely
63 affects perlivp's ability to function. You may be able to correct
64 this by performing a proper perl installation.
65
66 · print "# Required module `$_' does not appear to be properly
67 installed.\n";
68
69 An attempt to "eval "require $module"" failed, even though the list
70 of extensions indicated that it should succeed. Correct by
71 conducting a proper installation.
72
73 · print "# Unnecessary module `bLuRfle' appears to be installed.\n";
74
75 This test not coming out ok could indicate that you have in fact
76 installed a bLuRfle.pm module or that the "eval " require
77 \"$module_name.pm\"; "" test may give misleading results with your
78 installation of perl. If yours is the latter case then please let
79 the author know.
80
81 · print "# file",+($#missing == 0) ? '' : 's'," missing from
82 installation:\n";
83
84 One or more files turned up missing according to a run of
85 "ExtUtils::Installed -> validate()" over your installation.
86 Correct by conducting a proper installation.
87
88 · print "# Perl header `$_' does not appear to be properly
89 installed.\n";
90
91 Correct by running h2ph over your system's C header files. If
92 necessary, edit the resulting *.ph files to eliminate perl syntax
93 errors.
94
95 For further information on how to conduct a proper installation consult
96 the INSTALL file that comes with the perl source and the README file
97 for your platform.
98
100 Peter Prymmer
101
102
103
104perl v5.12.4 2011-11-04 PERLIVP(1)