=head2 Important safety tip
-The build and install procedures have changed significantly from the 5.004
-releases! Make sure you read the "Configuring the Perl Build", "Building
-Perl", and "Installing Perl" sections of this document before you build or
-install. Also please note other changes in the current release by having
-a look at L<perldelta/VMS>.
+For best results, make sure you read the "Configuring the Perl Build",
+"Building Perl", and "Installing Perl" sections of this document before
+you build or install. Also please note other changes in the current
+release by having a look at L<perldelta/VMS>.
Also note that, as of Perl version 5.005 and later, an ANSI C compliant
compiler is required to build Perl. VAX C is *not* ANSI compliant, as it
=item 2 A make tool.
-DEC's MMS (v2.6 or later), or MadGoat's free MMS
-analog MMK (available from ftp.madgoat.com/madgoat) both work
-just fine. Gnu Make might work, but it's been so long since
-anyone's tested it that we're not sure. MMK is free though, so
-go ahead and use that.
+HP's MMS may work, but MadGoat's free MMS analog MMK (available from
+http://www.kednos.com/kednos/Resources/MMK) has consistently worked
+better. Gnu Make might work, but it's been so long since anyone's tested
+it that we're not sure. MMK is free though, so go ahead and use that.
=back
from HP.
http://www.hp.com/go/openvms/freeware/
- http://www.crinoid.com/utils/
=item 2 VMS TAR
A port of GNU tar is also available as part of the GNV package:
- http://gnv.sourceforge.net/
+ http://h71000.www7.hp.com/opensource/gnv.html
=item 3 UNZIP.EXE for VMS
http://www.info-zip.org/UnZip.html
http://www.hp.com/go/openvms/freeware/
- ftp://ftp.hp.com/pub/openvms
- ftp://ftp.madgoat.com/madgoat/
- ftp://ftp.process.com/vms-freeware/fileserv
+ ftp://ftp.hp.com/pub/openvms/
+ ftp://ftp.process.com/vms-freeware/fileserv/
=item 4 MOST
distribution) and applied with GNU patch. VMS ports of these utilities are
available here:
- http://www.crinoid.com/utils/
+ http://www.antinode.info/dec/sw/diffutils.html
http://www.hp.com/go/openvms/freeware/
=back
You may need to set up a foreign symbol for the unpacking utility of choice.
-If you unpack a perl source kit with a name containing multiple periods on
-an ODS-5 volume using recent versions of vmstar (e.g. V3.4 or later) you may
-need to be especially careful in unpacking the tape archive file. Try to use
-the ODS-2 compatability qualifiers such as:
+As of version 5.10.0, Perl will still build and run on ODS-2 volumes,
+including on VAX, but there are a number of modules whose temporary
+files and tests are much happier residing on ODS-5 volumes. For
+example, CPANPLUS will fail most of its tests on an ODS-2 volume because
+it includes files with multiple dots that will have been converted to
+underscores and the tests will have difficulty finding them. So your
+best bet is to unpack the Perl source kit on an ODS-5 volume using
+recent versions of vmstar (e.g. V3.4 or later). Contrary to advice
+provided with previous versions of Perl, do I<not> use the ODS-2
+compatability qualifier. Instead, use a command like the following:
- vmstar /extract/verbose/ods2 perl-V^.VIII^.III.tar
+ vmstar /extract/verbose perl-V^.VIII^.III.tar
or:
- vmstar -xvof perl-5^.8^.3.tar
+ vmstar -xvf perl-5^.11^.0.tar
-If you neglected to use the /ODS2 qualifier or the -o switch then you
-could rename the source directory:
+Then rename the top-level source directory like so:
- set security/protection=(o:rwed) perl-5^.8^.3.dir
- rename perl-5^.8^.3.dir perl-5_8_3.dir
+ set security/protection=(o:rwed) perl-5^.11^.0.dir
+ rename perl-5^.11^.0.dir perl-5_11_0.dir
-Perl on VMS as of 5.8.3 does not completely handle extended file
-parse styles such as are encountered on ODS-5. While it can be built,
-installed, and run on ODS-5 filesystems; it may encounter
-trouble with characters that are otherwise illegal on ODS-2
-volumes (notably the ^. escaped period sequence).
+The reason for this last step is that while filenames with multiple dots
+are generally supported by Perl on VMS, I<directory> names with multiple
+dots are a special case with special problems because the dot is the
+traditional directory delimiter on VMS. Rudimentary support for
+multi-dot directory names is available, but some of the oldest and most
+essential parts of Perl (such as searching for and loading library
+modules) do not yet fully support the ODS-5 caret-escape syntax.
=head1 Configuring the Perl build
unbuildable; odds are that there's nothing in there you'll need to
change.
-The one exception is the various *DIR install locations. Changing those
-requires changes in genconfig.pl as well. Be really careful if you need to
-change these, as they can cause some fairly subtle problems.
-
=head2 Socket Support (optional) for Perl on VMS
Perl includes a number of functions for IP sockets, which are available if
How well integrated they are into the system depends on the stack, your
version of VMS, and the version of your C compiler.
-The most portable solution uses the SOCKETSHR library. In combination with
-either UCX or NetLib, this supports all the major TCP stacks (Multinet,
-Pathways, TCPWare, UCX, and CMU) on all versions of VMS Perl runs on, with
-all the compilers on both VAX and Alpha. The socket interface is also
-consistent across versions of VMS and C compilers. It has a problem with
-UDP sockets when used with Multinet, though, so you should be aware of
-that.
-
-The other solution available is to use the socket routines built into DEC
+The default solution available is to use the socket routines built into DEC
C. Which routines are available depend on the version of VMS you're
running, and require proper UCX emulation by your TCP/IP vendor.
Relatively current versions of Multinet, TCPWare, Pathway, and UCX all
provide the required libraries--check your manuals or release notes to see
if your version is new enough.
+The other solution uses the SOCKETSHR library. Before VAX/VMS 5.5-2 it was
+the most portable solution. The SOCKETSHR library has not been maintained
+since VAX/VMS 5.5-2, and it is not known if will even compile with the ANSI
+C that Perl currently requires. It remains an option for historical reasons,
+just in case someone might find it useful.
+
+In combination with either UCX or NetLib, this supported all the major TCP
+stacks (Multinet, Pathways, TCPWare, UCX, and CMU) on all versions of VMS
+Perl ran on up to VAX/VMS 6.2 and Alpha VMS 1.5 with all the compilers on
+both VAX and Alpha. The portion of the socket interface was also consistent
+across versions of VMS and C compilers.
+
+It has a problem with UDP sockets when used with Multinet, though, so you
+should be aware of that.
+
+As of VAX/VMS 5.5-2 and later, CMU is the only TCP/IP program that requires
+socketshr, and the sources have been lost to the most recent CMU bug fixes,
+so CMU is limited to OpenVMS/VAX 6.2 or earlier, which is the last release
+that binaries for the last released patches are known to exist.
+
+There is currently no official web site for downloading either CMU or
+SOCKETSHR; however, copies may be found in the DECUS archives.
+
=head1 Building Perl
The configuration script will print out, at the very end, the MMS or MMK
built; otherwise the manipulations of temporary files and directories
attempted by some of the tests will fail.
-If any tests fail, it means something is wrong with Perl. If the test suite
+If any tests fail, it means something is wrong with Perl, or at least
+with the particular module or feature that reported failure. If the test suite
hangs (some tests can take upwards of two or three minutes, or more if
you're on an especially slow machine, depending on your machine speed, so
don't be hasty), then the test *after* the last one displayed failed. Don't
The next big gotcha is directory depth. Perl can create directories four,
five, or even six levels deep during the build, so you don't have to be
too deep to start to hit the RMS 8 level limit (for ODS 2 volumes which were
-common on versions of VMS prior to V7.2 and even with V7.2 on the VAX).
+common on versions of VMS prior to V7.2 and even with V7.3 on the VAX).
It is best to do:
DEFINE/TRANS=(CONC,TERM) PERLSRC "disk:[dir.dir.dir.perldir.]"
Perl exited. This is fixed by DEC CSC patch ALPACRT04_061 or later.
See also:
- http://ftp.support.compaq.com/patches/.new/openvms.shtml
+ http://www.itrc.hp.com/
=back
were used to build perl on VMS. Hence they may require a great deal
of source code modification to work again.
- http://slacvx.slac.stanford.edu/HELP/GCC
http://www.progis.de/
- http://www.lp.se/products/gnu.html
=head2 Floating Point Considerations
Vmsperl pages on the web include:
http://www.sidhe.org/vmsperl/index.html
- http://www.crinoid.com/
- http://duphy4.physics.drexel.edu/pub/cgi_info.htmlx
http://www.cpan.org/modules/by-module/VMS/
http://www.xray.mpe.mpg.de/mailing-lists/vmsperl/
- http://www.best.com/~pvhp/vms/
http://www-ang.kfunigraz.ac.at/~binder/perl.html
http://lists.perl.org/showlist.cgi?name=vmsperl
http://archive.develooper.com/vmsperl@perl.org/
=head1 SEE ALSO
Perl information for users and programmers about the port of perl to VMS is
-available from the [.
VMS]PERLVMS.POD file that gets installed as L<perlvms>.
+available from the [.
POD]PERLVMS.POD file that gets installed as L<perlvms>.
For administrators the perlvms document also includes a detailed discussion
of extending vmsperl with CPAN modules after Perl has been installed.
=head1 AUTHORS
-Revised 10-October-2001 by Craig Berry craigberry@mac.com.
-Revised 25-February-2000 by Peter Prymmer pvhp@best.com.
-Revised 27-October-1999 by Craig Berry craigberry@mac.com.
-Revised 01-March-1999 by Dan Sugalski dan@sidhe.org.
-Originally by Charles Bailey bailey@newman.upenn.edu.
+Originally by Charles Bailey bailey@newman.upenn.edu. See the git repository
+for history.
=head1 ACKNOWLEDGEMENTS
the opportunity to test and develop for the AXP,
John Hasstedt John.Hasstedt@sunysb.edu
for VAX VMS V7.2 support
+ John Malmberg wb8tyw@qsl.net
+ for ODS-5 filename handling and other modernizations
and to the entire VMSperl group for useful advice and suggestions. In
addition the perl5-porters deserve credit for their creativity and
https://perl5.git.perl.org / perl5.git / blobdiff