| OLD | NEW | 
|---|
| 1                         VMS Installation instructions | 1                         VMS Installation instructions | 
| 2                         written by Richard Levitte | 2                         written by Richard Levitte | 
| 3                         <richard@levitte.org> | 3                         <richard@levitte.org> | 
| 4 | 4 | 
| 5 | 5 | 
| 6 Intro: | 6 Intro: | 
| 7 ====== | 7 ====== | 
| 8 | 8 | 
| 9 This file is divided in the following parts: | 9 This file is divided in the following parts: | 
| 10 | 10 | 
| (...skipping 53 matching lines...) Expand 10 before | Expand all | Expand 10 after  Loading... | 
| 64 <byer@mail.all-net.net>, and just slightly modified them, making | 64 <byer@mail.all-net.net>, and just slightly modified them, making | 
| 65 them slightly more general and easier to maintain. | 65 them slightly more general and easier to maintain. | 
| 66 | 66 | 
| 67 You can actually compile in almost any directory separately.  Look | 67 You can actually compile in almost any directory separately.  Look | 
| 68 for a command procedure name xxx-LIB.COM (in the library directories) | 68 for a command procedure name xxx-LIB.COM (in the library directories) | 
| 69 or MAKExxx.COM (in the program directories) and read the comments at | 69 or MAKExxx.COM (in the program directories) and read the comments at | 
| 70 the top to understand how to use them.  However, if you want to | 70 the top to understand how to use them.  However, if you want to | 
| 71 compile all you can get, the simplest is to use MAKEVMS.COM in the top | 71 compile all you can get, the simplest is to use MAKEVMS.COM in the top | 
| 72 directory.  The syntax is the following: | 72 directory.  The syntax is the following: | 
| 73 | 73 | 
| 74   @MAKEVMS <option> <rsaref-p> <debug-p> [<compiler>] | 74   @MAKEVMS <option> <bits> <debug-p> [<compiler>] | 
| 75 | 75 | 
| 76 <option> must be one of the following: | 76 <option> must be one of the following: | 
| 77 | 77 | 
| 78       ALL       Just build "everything". | 78       ALL       Just build "everything". | 
| 79       CONFIG    Just build the "[.CRYPTO]OPENSSLCONF.H" file. | 79       CONFIG    Just build the "[.CRYPTO]OPENSSLCONF.H" file. | 
| 80       BUILDINF  Just build the "[.INCLUDE]BUILDINF.H" file. | 80       BUILDINF  Just build the "[.INCLUDE]BUILDINF.H" file. | 
| 81       SOFTLINKS Just copies some files, to simulate Unix soft links. | 81       SOFTLINKS Just copies some files, to simulate Unix soft links. | 
| 82       BUILDALL  Same as ALL, except CONFIG, BUILDINF and SOFTLINKS aren't done. | 82       BUILDALL  Same as ALL, except CONFIG, BUILDINF and SOFTLINKS aren't done. | 
| 83       RSAREF    Just build the "[.xxx.EXE.RSAREF]LIBRSAGLUE.OLB" library. | 83       RSAREF    Just build the "[.xxx.EXE.RSAREF]LIBRSAGLUE.OLB" library. | 
| 84       CRYPTO    Just build the "[.xxx.EXE.CRYPTO]LIBCRYPTO.OLB" library. | 84       CRYPTO    Just build the "[.xxx.EXE.CRYPTO]LIBCRYPTO.OLB" library. | 
| 85       SSL       Just build the "[.xxx.EXE.SSL]LIBSSL.OLB" library. | 85       SSL       Just build the "[.xxx.EXE.SSL]LIBSSL.OLB" library. | 
| 86       SSL_TASK  Just build the "[.xxx.EXE.SSL]SSL_TASK.EXE" program. | 86       SSL_TASK  Just build the "[.xxx.EXE.SSL]SSL_TASK.EXE" program. | 
| 87       TEST      Just build the "[.xxx.EXE.TEST]" test programs for OpenSSL. | 87       TEST      Just build the "[.xxx.EXE.TEST]" test programs for OpenSSL. | 
| 88       APPS      Just build the "[.xxx.EXE.APPS]" application programs for OpenSS
     L. | 88       APPS      Just build the "[.xxx.EXE.APPS]" application programs for OpenSS
     L. | 
| 89 | 89 | 
| 90 <rsaref-p> must be one of the following: | 90 <bits> must be one of the following: | 
| 91 | 91 | 
| 92       RSAREF    compile using the RSAREF Library | 92       ""        compile using default pointer size | 
| 93       NORSAREF  compile without using RSAREF | 93       32        compile using 32 bit pointer size | 
| 94 | 94       64        compile using 64 bit pointer size | 
| 95 Note 0: The RSAREF library IS NO LONGER NEEDED.  The RSA patent |  | 
| 96         expires September 20, 2000, and RSA Security chose to make |  | 
| 97         the algorithm public domain two weeks before that. |  | 
| 98 |  | 
| 99 Note 1: If you still want to use RSAREF, the library is NOT INCLUDED |  | 
| 100         and you have to download it.  RSA Security doesn't carry it |  | 
| 101         any more, but there are a number of places where you can find |  | 
| 102         it.  You have to get the ".tar-Z" file as the ".zip" file |  | 
| 103         doesn't have the directory structure stored.  You have to |  | 
| 104         extract the file into the [.RSAREF] directory as that is where |  | 
| 105         the scripts will look for the files. |  | 
| 106 |  | 
| 107 Note 2: I have never done this, so I've no idea if it works or not. |  | 
| 108 | 95 | 
| 109 <debug-p> must be one of the following: | 96 <debug-p> must be one of the following: | 
| 110 | 97 | 
| 111       DEBUG     compile with debugging info (will not optimize) | 98       DEBUG     compile with debugging info (will not optimize) | 
| 112       NODEBUG   compile without debugging info (will optimize) | 99       NODEBUG   compile without debugging info (will optimize) | 
| 113 | 100 | 
| 114 <compiler> must be one of the following: | 101 <compiler> must be one of the following: | 
| 115 | 102 | 
| 116       DECC      For DEC C. | 103       DECC      For DEC C. | 
| 117       GNUC      For GNU C. | 104       GNUC      For GNU C. | 
| 118 | 105 | 
| 119 | 106 | 
| 120 You will find the crypto library in [.xxx.EXE.CRYPTO], called LIBCRYPTO.OLB, | 107 You will find the crypto library in [.xxx.EXE.CRYPTO] (where xxx is VAX, | 
| 121 where xxx is VAX or AXP.  You will find the SSL library in [.xxx.EXE.SSL], | 108 ALPHA or IA64), called SSL_LIBCRYPTO32.OLB or SSL_LIBCRYPTO.OLB depending | 
| 122 named LIBSSL.OLB, and you will find a bunch of useful programs in | 109 on how it was built.  You will find the SSL library in [.xxx.EXE.SSL], | 
| 123 [.xxx.EXE.APPS].  However, these shouldn't be used right off unless it's | 110 named SSL_LIBSSL32.OLB or SSL_LIBSSL.OLB, and you will find a bunch of | 
| 124 just to test them.  For production use, make sure you install first, see | 111 useful programs in [.xxx.EXE.APPS].  However, these shouldn't be used | 
| 125 Installation below. | 112 right off unless it's just to test them.  For production use, make sure | 
|  | 113 you install first, see Installation below. | 
| 126 | 114 | 
| 127 Note 1: Some programs in this package require a TCP/IP library. | 115 Note 1: Some programs in this package require a TCP/IP library. | 
| 128 | 116 | 
| 129 Note 2: if you want to compile the crypto library only, please make sure | 117 Note 2: if you want to compile the crypto library only, please make sure | 
| 130         you have at least done a @MAKEVMS CONFIG, a @MAKEVMS BUILDINF and | 118         you have at least done a @MAKEVMS CONFIG, a @MAKEVMS BUILDINF and | 
| 131         a @MAKEVMS SOFTLINKS.  A lot of things will break if you don't. | 119         a @MAKEVMS SOFTLINKS.  A lot of things will break if you don't. | 
| 132 | 120 | 
| 133 | 121 | 
| 134 Logical names: | 122 Logical names: | 
| 135 ============== | 123 ============== | 
| (...skipping 27 matching lines...) Expand all  Loading... | 
| 163 it's an ugly hack!) and rebuild. Please send a bug report to | 151 it's an ugly hack!) and rebuild. Please send a bug report to | 
| 164 <openssl-bugs@openssl.org>, including the output of "openssl version -a" | 152 <openssl-bugs@openssl.org>, including the output of "openssl version -a" | 
| 165 and of the failed test. | 153 and of the failed test. | 
| 166 | 154 | 
| 167 | 155 | 
| 168 Installation: | 156 Installation: | 
| 169 ============= | 157 ============= | 
| 170 | 158 | 
| 171 Installation is easy, just do the following: | 159 Installation is easy, just do the following: | 
| 172 | 160 | 
| 173   @INSTALL <root> | 161   @INSTALL <root> <bits> | 
| 174 | 162 | 
| 175 <root> is the directory in which everything will be installed, | 163 <root> is the directory in which everything will be installed, | 
| 176 subdirectories, libraries, header files, programs and startup command | 164 subdirectories, libraries, header files, programs and startup command | 
| 177 procedures. | 165 procedures. | 
| 178 | 166 | 
|  | 167 <bits> works the same way as for MAKEVMS.COM | 
|  | 168 | 
| 179 N.B.: INSTALL.COM builds a new directory structure, different from | 169 N.B.: INSTALL.COM builds a new directory structure, different from | 
| 180 the directory tree where you have now build OpenSSL. | 170 the directory tree where you have now build OpenSSL. | 
| 181 | 171 | 
| 182 In the [.VMS] subdirectory of the installation, you will find the | 172 In the [.VMS] subdirectory of the installation, you will find the | 
| 183 following command procedures: | 173 following command procedures: | 
| 184 | 174 | 
| 185   OPENSSL_STARTUP.COM | 175   OPENSSL_STARTUP.COM | 
| 186 | 176 | 
| 187         defines all needed logical names.  Takes one argument that | 177         defines all needed logical names.  Takes one argument that | 
| 188         tells it in what logical name table to insert the logical | 178         tells it in what logical name table to insert the logical | 
| 189         names.  If you insert if it SYS$MANAGER:SYSTARTUP_VMS.COM, the | 179         names.  If you insert if it SYS$MANAGER:SYSTARTUP_VMS.COM, the | 
| 190         call should look like this: | 180         call should look like this: | 
| 191 | 181 | 
| 192           @openssldev:[openssldir.VMS]OPENSSL_STARTUP "/SYSTEM" | 182           @openssldev:[openssldir.VMS]OPENSSL_STARTUP "/SYSTEM" | 
| 193 | 183 | 
| 194   OPENSSL_UTILS.COM | 184   OPENSSL_UTILS.COM | 
| 195 | 185 | 
| 196         sets up the symbols to the applications.  Should be called | 186         sets up the symbols to the applications.  Should be called | 
| 197         from for example SYS$MANAGER:SYLOGIN.COM | 187         from for example SYS$MANAGER:SYLOGIN.COM | 
| 198 | 188 | 
|  | 189   OPENSSL_UNDO.COM | 
|  | 190 | 
|  | 191         deassigns the logical names created with OPENSSL_STARTUP.COM. | 
|  | 192 | 
| 199 The logical names that are set up are the following: | 193 The logical names that are set up are the following: | 
| 200 | 194 | 
| 201   SSLROOT       a dotted concealed logical name pointing at the | 195   SSLROOT       a dotted concealed logical name pointing at the | 
| 202                 root directory. | 196                 root directory. | 
| 203 | 197 | 
| 204   SSLCERTS      Initially an empty directory, this is the default | 198   SSLCERTS      Initially an empty directory, this is the default | 
| 205                 location for certificate files. | 199                 location for certificate files. | 
| 206   SSLMISC       Various scripts. |  | 
| 207   SSLPRIVATE    Initially an empty directory, this is the default | 200   SSLPRIVATE    Initially an empty directory, this is the default | 
| 208                 location for private key files. | 201                 location for private key files. | 
| 209 | 202 | 
| 210   SSLEXE        Contains the openssl binary and a few other utility | 203   SSLEXE        Contains the openssl binary and a few other utility | 
| 211                 programs. | 204                 programs. | 
| 212   SSLINCLUDE    Contains the header files needed if you want to | 205   SSLINCLUDE    Contains the header files needed if you want to | 
| 213                 compile programs with libcrypto or libssl. | 206                 compile programs with libcrypto or libssl. | 
| 214   SSLLIB        Contains the OpenSSL library files (LIBCRYPTO.OLB | 207   SSLLIB        Contains the OpenSSL library files themselves: | 
| 215 »       »       and LIBSSL.OLB) themselves. | 208   »     »       - SSL_LIBCRYPTO32.OLB and SSL_LIBSSL32.OLB or | 
|  | 209 »       »       - SSL_LIBCRYPTO.OLB and SSL_LIBSSL.OLB | 
| 216 | 210 | 
| 217   OPENSSL       Same as SSLINCLUDE.  This is because the standard | 211   OPENSSL       Same as SSLINCLUDE.  This is because the standard | 
| 218                 way to include OpenSSL header files from version | 212                 way to include OpenSSL header files from version | 
| 219                 0.9.3 and on is: | 213                 0.9.3 and on is: | 
| 220 | 214 | 
| 221                         #include <openssl/header.h> | 215                         #include <openssl/header.h> | 
| 222 | 216 | 
| 223                 For more info on this issue, see the INSTALL. file | 217                 For more info on this issue, see the INSTALL. file | 
| 224                 (the NOTE in section 4 of "Installation in Detail"). | 218                 (the NOTE in section 4 of "Installation in Detail"). | 
| 225                 You don't need to "deleting old header files"!!! | 219                 You don't need to "deleting old header files"!!! | 
| (...skipping 63 matching lines...) Expand 10 before | Expand all | Expand 10 after  Loading... | 
| 289 - Script code to link an already compiled build tree. | 283 - Script code to link an already compiled build tree. | 
| 290 - A VMSINSTALlable version (way in the future, unless someone else hacks). | 284 - A VMSINSTALlable version (way in the future, unless someone else hacks). | 
| 291 - shareable images (DLL for you Windows folks). | 285 - shareable images (DLL for you Windows folks). | 
| 292 | 286 | 
| 293 There may be other things that I have missed and that may be desirable. | 287 There may be other things that I have missed and that may be desirable. | 
| 294 Please send mail to <openssl-users@openssl.org> or to me directly if you | 288 Please send mail to <openssl-users@openssl.org> or to me directly if you | 
| 295 have any ideas. | 289 have any ideas. | 
| 296 | 290 | 
| 297 -- | 291 -- | 
| 298 Richard Levitte <richard@levitte.org> | 292 Richard Levitte <richard@levitte.org> | 
| 299 2000-02-27 | 293 2000-02-27, 2011-03-18 | 
| OLD | NEW | 
|---|