[thirdparty/openssl.git] / INSTALL.VMS


 INSTALLATION ON THE VMS PLATFORM
 --------------------------------

 Intro
 -----

 This file is divided in the following parts:

   Requirements                 - Mandatory reading.
   Cheking the distribution     - Mandatory reading.
   Quick start
   Test                         <TO BE ADDED>
   Installation                 <TO BE ADDED>
   Backward portability         <TO BE ADDED>
   Possible bugs and quirks     <TO BE ADDED>


 Requirements
 ------------

 To build and install OpenSSL, you will need:

  * 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
 -------------------------

 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 GUNZIP to uncompress
 it and use VMSTAR to unpack the resulting tar file.

 GUNZIP is available {FIXME: where is it available?}

 VMSTAR is available {FIXME: where is it available?}


 Quick start
 -----------

 If you want to just get on with it, do this:

  $ @config
  $ mms
  $ mms test
  $ mmm install

 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:

  $ @config --prefix=PROGRAM:[OPENSSL]
Commit	Line	Data
7d7d2cbc	1
f578075a RL	2	INSTALLATION ON THE VMS PLATFORM
f578075a RL	3	--------------------------------
7d7d2cbc	4
f578075a RL	5	Intro
f578075a RL	6	-----
7d7d2cbc	7
f578075a	8	This file is divided in the following parts:
7d7d2cbc	9
f578075a RL	10	Requirements - Mandatory reading.
	11	Cheking the distribution - Mandatory reading.
	12	Quick start
	13	Test <TO BE ADDED>
	14	Installation <TO BE ADDED>
	15	Backward portability <TO BE ADDED>
	16	Possible bugs and quirks <TO BE ADDED>
2e98ec56 RL	17
2e98ec56 RL	18
f578075a RL	19	Requirements
f578075a RL	20	------------
713f2261	21
f578075a	22	To build and install OpenSSL, you will need:
713f2261	23
f578075a RL	24	* Perl 5 with core modules (please read README.PERL)
	25	* The perl module Text::Template (please read README.PERL)
	26	* DEC C or some other ANSI C compiler. VAX C is not supported.
	27	[Note: OpenSSL has only been tested with DEC C. Compiling with
	28	a different ANSI C compiler may require some work]
713f2261	29
f578075a RL	30	Checking the distribution
f578075a RL	31	-------------------------
2e98ec56	32
f578075a RL	33	There have been reports of places where the distribution didn't quite
	34	get through, for example if you've copied the tree from a NFS-mounted
	35	Unix mount point.
2e98ec56	36
f578075a RL	37	The easiest way to check if everything got through as it should is to
f578075a RL	38	check for one of the following files:
2e98ec56	39
f578075a	40	[.crypto]opensslconf^.h.in
2e98ec56	41
f578075a RL	42	The best way to get a correct distribution is to download the gzipped
	43	tar file from ftp://ftp.openssl.org/source/, use GUNZIP to uncompress
	44	it and use VMSTAR to unpack the resulting tar file.
2e98ec56	45
f578075a	46	GUNZIP is available {FIXME: where is it available?}
2e98ec56	47
f578075a	48	VMSTAR is available {FIXME: where is it available?}
2e98ec56	49
7d7d2cbc	50
f578075a RL	51	Quick start
f578075a RL	52	-----------
1a8b087a	53
f578075a	54	If you want to just get on with it, do this:
7d7d2cbc	55
f578075a RL	56	$ @config
	57	$ mms
	58	$ mms test
	59	$ mmm install
7d7d2cbc	60
f578075a RL	61	This will buidl and install OpenSSL in the default location, which is
	62	SYS$COMMON:[OPENSSL-'VERSION']. If you want it to be anywhere else,
	63	run config.com like this:
7d7d2cbc	64
f578075a	65	$ @config --prefix=PROGRAM:[OPENSSL]
7d7d2cbc	66