|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
NOTES FOR THE OPENVMS PLATFORM
|
|
Packit Service |
084de1 |
==============================
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Requirement details
|
|
Packit Service |
084de1 |
-------------------
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
In addition to the requirements and instructions listed in INSTALL,
|
|
Packit Service |
084de1 |
this are required as well:
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
* At least ODS-5 disk organization for source and build.
|
|
Packit Service |
084de1 |
Installation can be done on any existing disk organization.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
About ANSI C compiler
|
|
Packit Service |
084de1 |
---------------------
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
An ANSI C compiled is needed among other things. This means that
|
|
Packit Service |
084de1 |
VAX C is not and will not be supported.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
We have only tested with DEC C (a.k.a HP VMS C / VSI C) and require
|
|
Packit Service |
084de1 |
version 7.1 or later. Compiling with a different ANSI C compiler may
|
|
Packit Service |
084de1 |
require some work.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Please avoid using C RTL feature logical names DECC$* when building
|
|
Packit Service |
084de1 |
and testing OpenSSL. Most of all, they can be disruptive when
|
|
Packit Service |
084de1 |
running the tests, as they affect the Perl interpreter.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
About ODS-5 directory names and Perl
|
|
Packit Service |
084de1 |
------------------------------------
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
It seems that the perl function canonpath() in the File::Spec module
|
|
Packit Service |
084de1 |
doesn't treat file specifications where the last directory name
|
|
Packit Service |
084de1 |
contains periods very well. Unfortunately, some versions of VMS tar
|
|
Packit Service |
084de1 |
will keep the periods in the OpenSSL source directory instead of
|
|
Packit Service |
084de1 |
converting them to underscore, thereby leaving your source in
|
|
Packit Service |
084de1 |
something like [.openssl-1^.1^.0]. This will lead to issues when
|
|
Packit Service |
084de1 |
configuring and building OpenSSL.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
We have no replacement for Perl's canonpath(), so the best workaround
|
|
Packit Service |
084de1 |
for now is to rename the OpenSSL source directory, as follows (please
|
|
Packit Service |
084de1 |
adjust for the actual source directory name you have):
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
$ rename openssl-1^.1^.0.DIR openssl-1_1_0.DIR
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
About MMS and DCL
|
|
Packit Service |
084de1 |
-----------------
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
MMS has certain limitations when it comes to line length, and DCL has
|
|
Packit Service |
084de1 |
certain limitations when it comes to total command length. We do
|
|
Packit Service |
084de1 |
what we can to mitigate, but there is the possibility that it's not
|
|
Packit Service |
084de1 |
enough. Should you run into issues, a very simple solution is to set
|
|
Packit Service |
084de1 |
yourself up a few logical names for the directory trees you're going
|
|
Packit Service |
084de1 |
to use.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
About debugging
|
|
Packit Service |
084de1 |
---------------
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
If you build for debugging, the default on VMS is that image
|
|
Packit Service |
084de1 |
activation starts the debugger automatically, giving you a debug
|
|
Packit Service |
084de1 |
prompt. Unfortunately, this disrupts all other uses, such as running
|
|
Packit Service |
084de1 |
test programs in the test framework.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Generally speaking, if you build for debugging, only use the programs
|
|
Packit Service |
084de1 |
directly for debugging. Do not try to use them from a script, such
|
|
Packit Service |
084de1 |
as running the test suite.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
*The following is not available on Alpha*
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
As a compromise, we're turning off the flag that makes the debugger
|
|
Packit Service |
084de1 |
start automatically. If there is a program that you need to debug,
|
|
Packit Service |
084de1 |
you need to turn that flag back on first, for example:
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
$ set image /flag=call_debug [.test]evp_test.exe
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Then just run it and you will find yourself in a debugging session.
|
|
Packit Service |
084de1 |
When done, we recommend that you turn that flag back off:
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
$ set image /flag=nocall_debug [.test]evp_test.exe
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Checking the distribution
|
|
Packit Service |
084de1 |
-------------------------
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
There have been reports of places where the distribution didn't quite
|
|
Packit Service |
084de1 |
get through, for example if you've copied the tree from a NFS-mounted
|
|
Packit Service |
084de1 |
Unix mount point.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
The easiest way to check if everything got through as it should is to
|
|
Packit Service |
084de1 |
check for one of the following files:
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
[.crypto]opensslconf^.h.in
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
The best way to get a correct distribution is to download the gzipped
|
|
Packit Service |
084de1 |
tar file from ftp://ftp.openssl.org/source/, use GZIP -d to uncompress
|
|
Packit Service |
084de1 |
it and VMSTAR to unpack the resulting tar file.
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Gzip and VMSTAR are available here:
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
http://antinode.info/dec/index.html#Software
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
Should you need it, you can find UnZip for VMS here:
|
|
Packit Service |
084de1 |
|
|
Packit Service |
084de1 |
http://www.info-zip.org/UnZip.html
|