From f578075a93c7418f72ba000d1225cb0d9fd7df5d Mon Sep 17 00:00:00 2001 From: Richard Levitte Date: Sat, 30 Jan 2016 07:15:59 +0100 Subject: [PATCH] unified build scheme: rewrite INSTALL.VMS There is more to be added, but this will at least tell people how to try. Reviewed-by: Rich Salz --- INSTALL.VMS | 324 +++++++--------------------------------------------- README.PERL | 18 +++ 2 files changed, 62 insertions(+), 280 deletions(-) diff --git a/INSTALL.VMS b/INSTALL.VMS index 7fc3389fca..01f2ee7815 100644 --- a/INSTALL.VMS +++ b/INSTALL.VMS @@ -1,302 +1,66 @@ - VMS Installation instructions - written by Richard Levitte - + INSTALLATION ON THE VMS PLATFORM + -------------------------------- -Intro: -====== + Intro + ----- -This file is divided in the following parts: + This file is divided in the following parts: - Requirements - Mandatory reading. - Checking the distribution - Mandatory reading. - Compilation - Mandatory reading. - Logical names - Mandatory reading. - Test - Mandatory reading. - Installation - Mandatory reading. - Backward portability - Read if it's an issue. - Possible bugs or quirks - A few warnings on things that - may go wrong or may surprise you. - TODO - Things that are to come. + Requirements - Mandatory reading. + Cheking the distribution - Mandatory reading. + Quick start + Test + Installation + Backward portability + Possible bugs and quirks -Requirements: -============= + Requirements + ------------ -To build and install OpenSSL, you will need: + To build and install OpenSSL, you will need: - * Perl 5 with core modules. If you don't want to build it yourself, - we suggest you look here: http://sourceforge.net/projects/vmsperlkit/files/ - * DEC C or some other ANSI C compiler. VAX C is *not* supported. - [Note: OpenSSL has only been tested with DEC C. Compiling with - a different ANSI C compiler may require some work] + * Perl 5 with core modules (please read README.PERL) + * The perl module Text::Template (please read README.PERL) + * DEC C or some other ANSI C compiler. VAX C is *not* supported. + [Note: OpenSSL has only been tested with DEC C. Compiling with + a different ANSI C compiler may require some work] -Checking the distribution: -========================== + 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. + 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: + 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 - [.CRYPTO]OPENSSLCONF_H.IN + [.crypto]opensslconf^.h.in -They should never exist both at once, but one of them should (preferably -the first variant). If you can't find any of those two, something went -wrong. + The best way to get a correct distribution is to download the gzipped + tar file from ftp://ftp.openssl.org/source/, use GUNZIP to uncompress + it and use VMSTAR to unpack the resulting tar file. -The best way to get a correct distribution is to download the gzipped tar -file from ftp://ftp.openssl.org/source/, use GUNZIP to uncompress it and -use VMSTAR to unpack the resulting tar file. + GUNZIP is available {FIXME: where is it available?} -GUNZIP is available in many places on the net. One of the distribution -points is the WKU software archive, ftp://ftp.wku.edu/vms/fileserv/ . + VMSTAR is available {FIXME: where is it available?} -VMSTAR is also available in many places on the net. The recommended place -to find information about it is http://www.free.lp.se/vmstar/ . + Quick start + ----------- -Compilation: -============ + If you want to just get on with it, do this: -I've used the very good command procedures written by Robert Byer -, and just slightly modified them, making -them slightly more general and easier to maintain. + $ @config + $ mms + $ mms test + $ mmm install -You can actually compile in almost any directory separately. Look -for a command procedure name xxx-LIB.COM (in the library directories) -or MAKExxx.COM (in the program directories) and read the comments at -the top to understand how to use them. However, if you want to -compile all you can get, the simplest is to use MAKEVMS.COM in the top -directory. The syntax is the following: + This will buidl and install OpenSSL in the default location, which is + SYS$COMMON:[OPENSSL-'VERSION']. If you want it to be anywhere else, + run config.com like this: - @MAKEVMS