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