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 |