man-pages/man1/perlivp.1.html
2021-03-31 01:06:50 +01:00

187 lines
4.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of PERLIVP</TITLE>
</HEAD><BODY>
<H1>PERLIVP</H1>
Section: Perl Programmers Reference Guide (1)<BR>Updated: 2020-10-19<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
perlivp - Perl Installation Verification Procedure
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>perlivp</B> [<B>-p</B>] [<B>-v</B>] [<B>-h</B>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The <B>perlivp</B> 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:
<P>
<PRE>
make install
</PRE>
<P>
(or your platform's equivalent procedure) to verify that <B>perl</B> and its
libraries have been installed correctly. A correct installation is verified
by output that looks like:
<P>
<PRE>
ok 1
ok 2
</PRE>
<P>
etc.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-h</B> help<DD>
Prints out a brief help message.
<DT id="2"><B>-p</B> print preface<DD>
Gives a description of each test prior to performing it.
<DT id="3"><B>-v</B> verbose<DD>
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.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>DIAGNOSTICS</H2>
<DL COMPACT>
<DT id="4">&bull;<DD>
print ``# Perl binary '$perlpath' does not appear executable.\n'';
<P>
Likely to occur for a perl binary that was not properly installed.
Correct by conducting a proper installation.
<DT id="5">&bull;<DD>
print ``# Perl version '$]' installed, expected <TT>$ivp_VERSION</TT>.\n'';
<P>
Likely to occur for a perl that was not properly installed.
Correct by conducting a proper installation.
<DT id="6">&bull;<DD>
print ``# Perl \@INC directory '$_' does not appear to exist.\n'';
<P>
Likely to occur for a perl library tree that was not properly installed.
Correct by conducting a proper installation.
<DT id="7">&bull;<DD>
print ``# Needed module '$_' does not appear to be properly installed.\n'';
<P>
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.
<DT id="8">&bull;<DD>
print ``# Required module '$_' does not appear to be properly installed.\n'';
<P>
An attempt to <TT>&quot;eval &quot;require $module&quot;&quot;</TT> failed, even though the list of
extensions indicated that it should succeed. Correct by conducting a proper
installation.
<DT id="9">&bull;<DD>
print ``# Unnecessary module 'bLuRfle' appears to be installed.\n'';
<P>
This test not coming out ok could indicate that you have in fact installed
a bLuRfle.pm module or that the <TT>&quot;eval &quot; require \&quot;$module_name.pm\&quot;; &quot;&quot;</TT>
test may give misleading results with your installation of perl. If yours
is the latter case then please let the author know.
<DT id="10">&bull;<DD>
print ``# file'',+($#missing == 0) ? '' : 's',`` missing from installation:\n'';
<P>
One or more files turned up missing according to a run of
<TT>&quot;ExtUtils::Installed -&gt; validate()&quot;</TT> over your installation.
Correct by conducting a proper installation.
</DL>
<P>
For further information on how to conduct a proper installation consult the
<FONT SIZE="-1">INSTALL</FONT> file that comes with the perl source and the <FONT SIZE="-1">README</FONT> file for your
platform.
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
Peter Prymmer
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="14"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="15"><A HREF="#lbAF">DIAGNOSTICS</A><DD>
<DT id="16"><A HREF="#lbAG">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:22 GMT, March 31, 2021
</BODY>
</HTML>