Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perlivp.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "PERLIVP 1"
61 .TH PERLIVP 1 2026-03-09 "perl v5.42.1" "Perl Programmers Reference Guide"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 perlivp \- Perl Installation Verification Procedure
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 \&\fBperlivp\fR [\fB\-p\fR] [\fB\-v\fR] [\fB\-h\fR]
71 .SH DESCRIPTION
72 .IX Header "DESCRIPTION"
73 The \fBperlivp\fR program is set up at Perl source code build time to test the
74 Perl version it was built under. It can be used after running:
75 .PP
76 .Vb 1
77 \& make install
78 .Ve
79 .PP
80 (or your platform\*(Aqs equivalent procedure) to verify that \fBperl\fR and its
81 libraries have been installed correctly. A correct installation is verified
82 by output that looks like:
83 .PP
84 .Vb 2
85 \& ok 1
86 \& ok 2
87 .Ve
88 .PP
89 etc.
90 .SH OPTIONS
91 .IX Header "OPTIONS"
92 .IP "\fB\-h\fR help" 5
93 .IX Item "-h help"
94 Prints out a brief help message.
95 .IP "\fB\-p\fR print preface" 5
96 .IX Item "-p print preface"
97 Gives a description of each test prior to performing it.
98 .IP "\fB\-v\fR verbose" 5
99 .IX Item "-v verbose"
100 Gives more detailed information about each test, after it has been performed.
101 Note that any failed tests ought to print out some extra information whether
102 or not \-v is thrown.
103 .SH DIAGNOSTICS
104 .IX Header "DIAGNOSTICS"
105 .IP \(bu 4
106 print "# Perl binary \*(Aq$perlpath\*(Aq does not appear executable.\en";
107 .Sp
108 Likely to occur for a perl binary that was not properly installed.
109 Correct by conducting a proper installation.
110 .IP \(bu 4
111 print "# Perl version \*(Aq$]\*(Aq installed, expected \f(CW$ivp_VERSION\fR.\en";
112 .Sp
113 Likely to occur for a perl that was not properly installed.
114 Correct by conducting a proper installation.
115 .IP \(bu 4
116 print "# Perl \e@INC directory \*(Aq$_\*(Aq does not appear to exist.\en";
117 .Sp
118 Likely to occur for a perl library tree that was not properly installed.
119 Correct by conducting a proper installation.
120 .IP \(bu 4
121 print "# Needed module \*(Aq$_\*(Aq does not appear to be properly installed.\en";
122 .Sp
123 One of the two modules that is used by perlivp was not present in the
124 installation. This is a serious error since it adversely affects perlivp\*(Aqs
125 ability to function. You may be able to correct this by performing a
126 proper perl installation.
127 .IP \(bu 4
128 print "# Required module \*(Aq$_\*(Aq does not appear to be properly installed.\en";
129 .Sp
130 An attempt to \f(CW\*(C`eval "require $module"\*(C'\fR failed, even though the list of
131 extensions indicated that it should succeed. Correct by conducting a proper
132 installation.
133 .IP \(bu 4
134 print "# Unnecessary module \*(AqbLuRfle\*(Aq appears to be installed.\en";
135 .Sp
136 This test not coming out ok could indicate that you have in fact installed
137 a bLuRfle.pm module or that the \f(CW\*(C`eval " require \e"$module_name.pm\e"; "\*(C'\fR
138 test may give misleading results with your installation of perl. If yours
139 is the latter case then please let the author know.
140 .IP \(bu 4
141 print "# file",+($#missing == 0) ? \*(Aq\*(Aq : \*(Aqs\*(Aq," missing from installation:\en";
142 .Sp
143 One or more files turned up missing according to a run of
144 \&\f(CW\*(C`ExtUtils::Installed \-> validate()\*(C'\fR over your installation.
145 Correct by conducting a proper installation.
146 .PP
147 For further information on how to conduct a proper installation consult the
148 INSTALL file that comes with the perl source and the README file for your
149 platform.
150 .SH AUTHOR
151 .IX Header "AUTHOR"
152 Peter Prymmer