[thirdparty/openssl.git] / NOTES.VMS


 NOTES FOR THE OPENVMS PLATFORM
 ==============================

 Requirement details
 -------------------

 In addition to the requirements and instructions listed in INSTALL,
 this are required as well:

  * At least ODS-5 disk organization for source and build.
    Installation can be done on any existing disk organization.


 About ANSI C compiler
 ---------------------

 An ANSI C compiled is needed among other things.  This means that
 VAX C is not and will not be supported.

 We have only tested with DEC C (a.k.a HP VMS C / VSI C), compiling
 with a different ANSI C compiler may require some work.

 Please avoid using C RTL feature logical names DECC$* when building
 and testing OpenSSL.  Most of all, they can be disruptive when
 running the tests, as they affect the Perl interpreter.


 About MMS and DCL
 -----------------

 MMS has certain limitations when it comes to line length, and DCL has
 certain limitations when it comes to total command length.  We do
 what we can to mitigate, but there is the possibility that it's not
 enough.  Should you run into issues, a very simple solution is to set
 yourself up a few logical names for the directory trees you're going
 to use.


 Checking the distribution
 -------------------------

 There have been reports of places where the distribution didn't quite
 get through, for example if you've copied the tree from a NFS-mounted
 Unix mount point.

 The easiest way to check if everything got through as it should is to
 check for one of the following files:

   [.crypto]opensslconf^.h.in

 The best way to get a correct distribution is to download the gzipped
 tar file from ftp://ftp.openssl.org/source/, use GZIP -d to uncompress
 it and VMSTAR to unpack the resulting tar file.

 Gzip and VMSTAR are available here:

   http://antinode.info/dec/index.html#Software

 Should you need it, you can find UnZip for VMS here:

   http://www.info-zip.org/UnZip.html
Commit	Line	Data
2acd8ec7 RL	1
	2	NOTES FOR THE OPENVMS PLATFORM
	3	==============================
	4
	5	Requirement details
	6	-------------------
	7
b54e35f6 RL	8	In addition to the requirements and instructions listed in INSTALL,
b54e35f6 RL	9	this are required as well:
2acd8ec7 RL	10
	11	* At least ODS-5 disk organization for source and build.
	12	Installation can be done on any existing disk organization.
	13
	14
	15	About ANSI C compiler
	16	---------------------
	17
7793e174 RL	18	An ANSI C compiled is needed among other things. This means that
7793e174 RL	19	VAX C is not and will not be supported.
2acd8ec7	20
7793e174 RL	21	We have only tested with DEC C (a.k.a HP VMS C / VSI C), compiling
	22	with a different ANSI C compiler may require some work.
	23
	24	Please avoid using C RTL feature logical names DECC$* when building
	25	and testing OpenSSL. Most of all, they can be disruptive when
	26	running the tests, as they affect the Perl interpreter.
2acd8ec7 RL	27
2acd8ec7 RL	28
b54e35f6 RL	29	About MMS and DCL
	30	-----------------
	31
	32	MMS has certain limitations when it comes to line length, and DCL has
	33	certain limitations when it comes to total command length. We do
	34	what we can to mitigate, but there is the possibility that it's not
	35	enough. Should you run into issues, a very simple solution is to set
	36	yourself up a few logical names for the directory trees you're going
	37	to use.
	38
	39
2acd8ec7 RL	40	Checking the distribution
	41	-------------------------
	42
	43	There have been reports of places where the distribution didn't quite
	44	get through, for example if you've copied the tree from a NFS-mounted
	45	Unix mount point.
	46
	47	The easiest way to check if everything got through as it should is to
	48	check for one of the following files:
	49
	50	[.crypto]opensslconf^.h.in
	51
	52	The best way to get a correct distribution is to download the gzipped
	53	tar file from ftp://ftp.openssl.org/source/, use GZIP -d to uncompress
	54	it and VMSTAR to unpack the resulting tar file.
	55
	56	Gzip and VMSTAR are available here:
	57
	58	http://antinode.info/dec/index.html#Software
	59
	60	Should you need it, you can find UnZip for VMS here:
	61
	62	http://www.info-zip.org/UnZip.html