]>
Commit | Line | Data |
---|---|---|
6ede7d73 DMSP |
1 | Build and Install |
2 | ================= | |
3 | ||
4 | This document describes installation on all supported operating | |
008ca01e JM |
5 | systems: the Unix/Linux family (including macOS), OpenVMS, |
6 | and Windows. | |
6ede7d73 DMSP |
7 | |
8 | Table of Contents | |
9 | ================= | |
10 | ||
11 | - [Prerequisites](#prerequisites) | |
12 | - [Notational Conventions](#notational-conventions) | |
13 | - [Quick Installation Guide](#quick-installation-guide) | |
257e9d03 RS |
14 | - [Building OpenSSL](#building-openssl) |
15 | - [Installing OpenSSL](#installing-openssl) | |
6ede7d73 | 16 | - [Configuration Options](#configuration-options) |
257e9d03 RS |
17 | - [API Level](#api-level) |
18 | - [Cross Compile Prefix](#cross-compile-prefix) | |
19 | - [Build Type](#build-type) | |
20 | - [Directories](#directories) | |
21 | - [Compiler Warnings](#compiler-warnings) | |
12e96a23 | 22 | - [Compression Algorithm Flags](#compression-algorithm-flags) |
257e9d03 | 23 | - [Seeding the Random Generator](#seeding-the-random-generator) |
31214258 | 24 | - [Setting the FIPS HMAC key](#setting-the-FIPS-HMAC-key) |
257e9d03 RS |
25 | - [Enable and Disable Features](#enable-and-disable-features) |
26 | - [Displaying configuration data](#displaying-configuration-data) | |
6ede7d73 | 27 | - [Installation Steps in Detail](#installation-steps-in-detail) |
257e9d03 RS |
28 | - [Configure](#configure-openssl) |
29 | - [Build](#build-openssl) | |
30 | - [Test](#test-openssl) | |
31 | - [Install](#install-openssl) | |
6ede7d73 | 32 | - [Advanced Build Options](#advanced-build-options) |
257e9d03 RS |
33 | - [Environment Variables](#environment-variables) |
34 | - [Makefile Targets](#makefile-targets) | |
35 | - [Running Selected Tests](#running-selected-tests) | |
6ede7d73 | 36 | - [Troubleshooting](#troubleshooting) |
257e9d03 RS |
37 | - [Configuration Problems](#configuration-problems) |
38 | - [Build Failures](#build-failures) | |
39 | - [Test Failures](#test-failures) | |
6ede7d73 | 40 | - [Notes](#notes) |
257e9d03 RS |
41 | - [Notes on multi-threading](#notes-on-multi-threading) |
42 | - [Notes on shared libraries](#notes-on-shared-libraries) | |
43 | - [Notes on random number generation](#notes-on-random-number-generation) | |
203c18f1 | 44 | - [Notes on assembler modules compilation](#notes-on-assembler-modules-compilation) |
79e259e3 | 45 | |
6ede7d73 DMSP |
46 | Prerequisites |
47 | ============= | |
2acd8ec7 | 48 | |
6ede7d73 | 49 | To install OpenSSL, you will need: |
2acd8ec7 | 50 | |
3a0b3cc9 | 51 | * A "make" implementation |
9f1fe6a9 DMSP |
52 | * Perl 5 with core modules (please read [NOTES-PERL.md](NOTES-PERL.md)) |
53 | * The Perl module `Text::Template` (please read [NOTES-PERL.md](NOTES-PERL.md)) | |
6ede7d73 DMSP |
54 | * an ANSI C compiler |
55 | * a development environment in the form of development libraries and C | |
56 | header files | |
57 | * a supported operating system | |
79e259e3 | 58 | |
6ede7d73 DMSP |
59 | For additional platform specific requirements, solutions to specific |
60 | issues and other details, please read one of these: | |
ea24fe29 | 61 | |
4148581e DMSP |
62 | * [Notes for UNIX-like platforms](NOTES-UNIX.md) |
63 | * [Notes for Android platforms](NOTES-ANDROID.md) | |
64 | * [Notes for Windows platforms](NOTES-WINDOWS.md) | |
65 | * [Notes for the DOS platform with DJGPP](NOTES-DJGPP.md) | |
66 | * [Notes for the OpenVMS platform](NOTES-VMS.md) | |
99fb31c1 | 67 | * [Notes for the HPE NonStop platform](NOTES-NONSTOP.md) |
4148581e DMSP |
68 | * [Notes on Perl](NOTES-PERL.md) |
69 | * [Notes on Valgrind](NOTES-VALGRIND.md) | |
ea24fe29 | 70 | |
6ede7d73 DMSP |
71 | Notational conventions |
72 | ====================== | |
ea24fe29 | 73 | |
6ede7d73 | 74 | Throughout this document, we use the following conventions. |
ea24fe29 | 75 | |
6ede7d73 DMSP |
76 | Commands |
77 | -------- | |
ea24fe29 | 78 | |
6ede7d73 | 79 | Any line starting with a dollar sign is a command line. |
ea24fe29 | 80 | |
6ede7d73 | 81 | $ command |
ea24fe29 | 82 | |
6ede7d73 DMSP |
83 | The dollar sign indicates the shell prompt and is not to be entered as |
84 | part of the command. | |
ea24fe29 | 85 | |
6ede7d73 DMSP |
86 | Choices |
87 | ------- | |
ea24fe29 | 88 | |
6ede7d73 DMSP |
89 | Several words in curly braces separated by pipe characters indicate a |
90 | **mandatory choice**, to be replaced with one of the given words. | |
91 | For example, the line | |
ea24fe29 | 92 | |
6ede7d73 | 93 | $ echo { WORD1 | WORD2 | WORD3 } |
ea24fe29 | 94 | |
6ede7d73 | 95 | represents one of the following three commands |
ea24fe29 | 96 | |
6ede7d73 DMSP |
97 | $ echo WORD1 |
98 | - or - | |
99 | $ echo WORD2 | |
100 | - or - | |
101 | $ echo WORD3 | |
ea24fe29 | 102 | |
6ede7d73 DMSP |
103 | One or several words in square brackets separated by pipe characters |
104 | denote an **optional choice**. It is similar to the mandatory choice, | |
105 | but it can also be omitted entirely. | |
79e259e3 | 106 | |
6ede7d73 | 107 | So the line |
79e259e3 | 108 | |
6ede7d73 DMSP |
109 | $ echo [ WORD1 | WORD2 | WORD3 ] |
110 | ||
111 | represents one of the four commands | |
112 | ||
113 | $ echo WORD1 | |
114 | - or - | |
115 | $ echo WORD2 | |
116 | - or - | |
117 | $ echo WORD3 | |
118 | - or - | |
119 | $ echo | |
120 | ||
121 | Arguments | |
122 | --------- | |
123 | ||
a4ffb33e | 124 | **Optional Arguments** are enclosed in square brackets. |
6ede7d73 | 125 | |
a4ffb33e | 126 | [option...] |
6ede7d73 | 127 | |
a4ffb33e | 128 | A trailing ellipsis means that more than one could be specified. |
6ede7d73 | 129 | |
6ede7d73 DMSP |
130 | Quick Installation Guide |
131 | ======================== | |
132 | ||
133 | If you just want to get OpenSSL installed without bothering too much | |
134 | about the details, here is the short version of how to build and install | |
135 | OpenSSL. If any of the following steps fails, please consult the | |
bf4cdd4a | 136 | [Installation in Detail](#installation-steps-in-detail) section below. |
6ede7d73 DMSP |
137 | |
138 | Building OpenSSL | |
139 | ---------------- | |
140 | ||
141 | Use the following commands to configure, build and test OpenSSL. | |
142 | The testing is optional, but recommended if you intend to install | |
143 | OpenSSL for production use. | |
144 | ||
99fb31c1 | 145 | ### Unix / Linux / macOS / NonStop |
2acd8ec7 | 146 | |
16b0e0fc | 147 | $ ./Configure |
2acd8ec7 RL |
148 | $ make |
149 | $ make test | |
2acd8ec7 | 150 | |
257e9d03 | 151 | ### OpenVMS |
6ede7d73 DMSP |
152 | |
153 | Use the following commands to build OpenSSL: | |
2acd8ec7 | 154 | |
16b0e0fc | 155 | $ perl Configure |
2acd8ec7 RL |
156 | $ mms |
157 | $ mms test | |
79e259e3 | 158 | |
257e9d03 | 159 | ### Windows |
6ede7d73 DMSP |
160 | |
161 | If you are using Visual Studio, open a Developer Command Prompt and | |
8c1cbc72 | 162 | issue the following commands to build OpenSSL. |
b32b8961 | 163 | |
16b0e0fc | 164 | $ perl Configure |
b32b8961 RL |
165 | $ nmake |
166 | $ nmake test | |
6ede7d73 DMSP |
167 | |
168 | As mentioned in the [Choices](#choices) section, you need to pick one | |
169 | of the four Configure targets in the first command. | |
170 | ||
18891efd | 171 | Most likely you will be using the `VC-WIN64A`/`VC-WIN64A-HYBRIDCRT` target for |
172 | 64bit Windows binaries (AMD64) or `VC-WIN32`/`VC-WIN32-HYBRIDCRT` for 32bit | |
173 | Windows binaries (X86). | |
9afbb681 DDO |
174 | The other two options are `VC-WIN64I` (Intel IA64, Itanium) and |
175 | `VC-CE` (Windows CE) are rather uncommon nowadays. | |
6ede7d73 DMSP |
176 | |
177 | Installing OpenSSL | |
178 | ------------------ | |
179 | ||
180 | The following commands will install OpenSSL to a default system location. | |
181 | ||
182 | **Danger Zone:** even if you are impatient, please read the following two | |
183 | paragraphs carefully before you install OpenSSL. | |
184 | ||
185 | For security reasons the default system location is by default not writable | |
186 | for unprivileged users. So for the final installation step administrative | |
187 | privileges are required. The default system location and the procedure to | |
8c1cbc72 | 188 | obtain administrative privileges depends on the operating system. |
6ede7d73 DMSP |
189 | It is recommended to compile and test OpenSSL with normal user privileges |
190 | and use administrative privileges only for the final installation step. | |
191 | ||
192 | On some platforms OpenSSL is preinstalled as part of the Operating System. | |
193 | In this case it is highly recommended not to overwrite the system versions, | |
194 | because other applications or libraries might depend on it. | |
195 | To avoid breaking other applications, install your copy of OpenSSL to a | |
196 | [different location](#installing-to-a-different-location) which is not in | |
197 | the global search path for system libraries. | |
198 | ||
41149648 RL |
199 | Finally, if you plan on using the FIPS module, you need to read the |
200 | [Post-installation Notes](#post-installation-notes) further down. | |
201 | ||
99fb31c1 | 202 | ### Unix / Linux / macOS / NonStop |
6ede7d73 DMSP |
203 | |
204 | Depending on your distribution, you need to run the following command as | |
205 | root user or prepend `sudo` to the command: | |
206 | ||
207 | $ make install | |
208 | ||
209 | By default, OpenSSL will be installed to | |
210 | ||
211 | /usr/local | |
212 | ||
213 | More precisely, the files will be installed into the subdirectories | |
214 | ||
215 | /usr/local/bin | |
216 | /usr/local/lib | |
217 | /usr/local/include | |
218 | ... | |
219 | ||
220 | depending on the file type, as it is custom on Unix-like operating systems. | |
221 | ||
257e9d03 | 222 | ### OpenVMS |
6ede7d73 DMSP |
223 | |
224 | Use the following command to install OpenSSL. | |
225 | ||
226 | $ mms install | |
227 | ||
228 | By default, OpenSSL will be installed to | |
229 | ||
d8c1cafb | 230 | SYS$COMMON:[OPENSSL] |
6ede7d73 | 231 | |
257e9d03 | 232 | ### Windows |
6ede7d73 DMSP |
233 | |
234 | If you are using Visual Studio, open the Developer Command Prompt _elevated_ | |
235 | and issue the following command. | |
236 | ||
8c16829e | 237 | $ nmake install |
b32b8961 | 238 | |
98663afc TM |
239 | The easiest way to elevate the Command Prompt is to press and hold down both |
240 | the `<CTRL>` and `<SHIFT>` keys while clicking the menu item in the task menu. | |
6ede7d73 DMSP |
241 | |
242 | The default installation location is | |
243 | ||
244 | C:\Program Files\OpenSSL | |
7c03bb9f | 245 | |
6ede7d73 | 246 | for native binaries, or |
b1fe6b43 | 247 | |
6ede7d73 | 248 | C:\Program Files (x86)\OpenSSL |
2acd8ec7 | 249 | |
6ede7d73 | 250 | for 32bit binaries on 64bit Windows (WOW64). |
2acd8ec7 | 251 | |
257e9d03 | 252 | #### Installing to a different location |
79e259e3 | 253 | |
6ede7d73 | 254 | To install OpenSSL to a different location (for example into your home |
9afbb681 | 255 | directory for testing purposes) run `Configure` as shown in the following |
43a70f02 | 256 | examples. |
6ede7d73 | 257 | |
d8c1cafb RL |
258 | The options `--prefix` and `--openssldir` are explained in further detail in |
259 | [Directories](#directories) below, and the values used here are mere examples. | |
260 | ||
43a70f02 | 261 | On Unix: |
2acd8ec7 | 262 | |
16b0e0fc | 263 | $ ./Configure --prefix=/opt/openssl --openssldir=/usr/local/ssl |
2acd8ec7 | 264 | |
43a70f02 | 265 | On OpenVMS: |
2acd8ec7 | 266 | |
16b0e0fc | 267 | $ perl Configure --prefix=PROGRAM:[INSTALLS] --openssldir=SYS$MANAGER:[OPENSSL] |
79e259e3 | 268 | |
6ede7d73 | 269 | Note: if you do add options to the configuration command, please make sure |
1dc1ea18 | 270 | you've read more than just this Quick Start, such as relevant `NOTES-*` files, |
6ede7d73 DMSP |
271 | the options outline below, as configuration options may change the outcome |
272 | in otherwise unexpected ways. | |
273 | ||
6ede7d73 DMSP |
274 | Configuration Options |
275 | ===================== | |
276 | ||
9afbb681 DDO |
277 | There are several options to `./Configure` to customize the build (note that |
278 | for Windows, the defaults for `--prefix` and `--openssldir` depend on what | |
16b0e0fc | 279 | configuration is used and what Windows implementation OpenSSL is built on. |
9f1fe6a9 | 280 | For more information, see the [Notes for Windows platforms](NOTES-WINDOWS.md). |
6ede7d73 DMSP |
281 | |
282 | API Level | |
283 | --------- | |
284 | ||
285 | --api=x.y[.z] | |
286 | ||
287 | Build the OpenSSL libraries to support the API for the specified version. | |
288 | If [no-deprecated](#no-deprecated) is also given, don't build with support | |
289 | for deprecated APIs in or below the specified version number. For example, | |
473664aa | 290 | adding |
6ede7d73 DMSP |
291 | |
292 | --api=1.1.0 no-deprecated | |
293 | ||
294 | will remove support for all APIs that were deprecated in OpenSSL version | |
295 | 1.1.0 or below. This is a rather specialized option for developers. | |
296 | If you just intend to remove all deprecated APIs up to the current version | |
297 | entirely, just specify [no-deprecated](#no-deprecated). | |
298 | If `--api` isn't given, it defaults to the current (minor) OpenSSL version. | |
299 | ||
6ede7d73 DMSP |
300 | Cross Compile Prefix |
301 | -------------------- | |
302 | ||
9afbb681 | 303 | --cross-compile-prefix=<PREFIX> |
6ede7d73 | 304 | |
9afbb681 | 305 | The `<PREFIX>` to include in front of commands for your toolchain. |
6ede7d73 | 306 | |
9afbb681 DDO |
307 | It is likely to have to end with dash, e.g. `a-b-c-` would invoke GNU compiler |
308 | as `a-b-c-gcc`, etc. Unfortunately cross-compiling is too case-specific to put | |
6ede7d73 | 309 | together one-size-fits-all instructions. You might have to pass more flags or |
16b0e0fc RL |
310 | set up environment variables to actually make it work. Android and iOS cases |
311 | are discussed in corresponding `Configurations/15-*.conf` files. But there are | |
312 | cases when this option alone is sufficient. For example to build the mingw64 | |
313 | target on Linux `--cross-compile-prefix=x86_64-w64-mingw32-` works. Naturally | |
314 | provided that mingw packages are installed. Today Debian and Ubuntu users | |
315 | have option to install a number of prepackaged cross-compilers along with | |
316 | corresponding run-time and development packages for "alien" hardware. To give | |
317 | another example `--cross-compile-prefix=mipsel-linux-gnu-` suffices in such | |
318 | case. | |
319 | ||
320 | For cross compilation, you must [configure manually](#manual-configuration). | |
321 | Also, note that `--openssldir` refers to target's file system, not one you are | |
322 | building on. | |
6ede7d73 | 323 | |
6ede7d73 DMSP |
324 | Build Type |
325 | ---------- | |
326 | ||
327 | --debug | |
328 | ||
329 | Build OpenSSL with debugging symbols and zero optimization level. | |
330 | ||
331 | --release | |
332 | ||
333 | Build OpenSSL without debugging symbols. This is the default. | |
334 | ||
6ede7d73 DMSP |
335 | Directories |
336 | ----------- | |
337 | ||
257e9d03 | 338 | ### libdir |
6ede7d73 DMSP |
339 | |
340 | --libdir=DIR | |
341 | ||
342 | The name of the directory under the top of the installation directory tree | |
343 | (see the `--prefix` option) where libraries will be installed. By default | |
bd32bdb8 | 344 | this is `lib`. Note that on Windows only static libraries (`*.lib`) will |
6ede7d73 | 345 | be stored in this location. Shared libraries (`*.dll`) will always be |
bd32bdb8 TM |
346 | installed to the `bin` directory. |
347 | ||
348 | Some build targets have a multilib postfix set in the build configuration. | |
349 | For these targets the default libdir is `lib<multilib-postfix>`. Please use | |
350 | `--libdir=lib` to override the libdir if adding the postfix is undesirable. | |
6ede7d73 | 351 | |
257e9d03 | 352 | ### openssldir |
6ede7d73 DMSP |
353 | |
354 | --openssldir=DIR | |
355 | ||
356 | Directory for OpenSSL configuration files, and also the default certificate | |
357 | and key store. Defaults are: | |
358 | ||
359 | Unix: /usr/local/ssl | |
360 | Windows: C:\Program Files\Common Files\SSL | |
361 | OpenVMS: SYS$COMMON:[OPENSSL-COMMON] | |
362 | ||
363 | For 32bit Windows applications on Windows 64bit (WOW64), always replace | |
364 | `C:\Program Files` by `C:\Program Files (x86)`. | |
365 | ||
257e9d03 | 366 | ### prefix |
6ede7d73 DMSP |
367 | |
368 | --prefix=DIR | |
369 | ||
370 | The top of the installation directory tree. Defaults are: | |
371 | ||
372 | Unix: /usr/local | |
373 | Windows: C:\Program Files\OpenSSL | |
d8c1cafb | 374 | OpenVMS: SYS$COMMON:[OPENSSL] |
6ede7d73 | 375 | |
6ede7d73 DMSP |
376 | Compiler Warnings |
377 | ----------------- | |
378 | ||
379 | --strict-warnings | |
380 | ||
381 | This is a developer flag that switches on various compiler options recommended | |
382 | for OpenSSL development. It only works when using gcc or clang as the compiler. | |
383 | If you are developing a patch for OpenSSL then it is recommended that you use | |
384 | this option where possible. | |
385 | ||
12e96a23 TS |
386 | Compression Algorithm Flags |
387 | --------------------------- | |
388 | ||
389 | ### with-brotli-include | |
390 | ||
391 | --with-brotli-include=DIR | |
392 | ||
393 | The directory for the location of the brotli include files (i.e. the location | |
394 | of the **brotli** include directory). This option is only necessary if | |
395 | [enable-brotli](#enable-brotli) is used and the include files are not already | |
396 | on the system include path. | |
397 | ||
398 | ### with-brotli-lib | |
399 | ||
400 | --with-brotli-lib=LIB | |
401 | ||
402 | **On Unix**: this is the directory containing the brotli libraries. | |
403 | If not provided, the system library path will be used. | |
404 | ||
405 | The names of the libraries are: | |
406 | ||
407 | * libbrotlicommon.a or libbrotlicommon.so | |
408 | * libbrotlidec.a or libbrotlidec.so | |
409 | * libbrotlienc.a or libbrotlienc.so | |
410 | ||
411 | **On Windows:** this is the directory containing the brotli libraries. | |
412 | If not provided, the system library path will be used. | |
413 | ||
414 | The names of the libraries are: | |
415 | ||
416 | * brotlicommon.lib | |
417 | * brotlidec.lib | |
418 | * brotlienc.lib | |
6ede7d73 | 419 | |
257e9d03 | 420 | ### with-zlib-include |
6ede7d73 DMSP |
421 | |
422 | --with-zlib-include=DIR | |
423 | ||
424 | The directory for the location of the zlib include file. This option is only | |
bf4cdd4a | 425 | necessary if [zlib](#zlib) is used and the include file is not |
6ede7d73 DMSP |
426 | already on the system include path. |
427 | ||
257e9d03 | 428 | ### with-zlib-lib |
6ede7d73 DMSP |
429 | |
430 | --with-zlib-lib=LIB | |
431 | ||
432 | **On Unix**: this is the directory containing the zlib library. | |
433 | If not provided the system library path will be used. | |
434 | ||
435 | **On Windows:** this is the filename of the zlib library (with or | |
436 | without a path). This flag must be provided if the | |
9afbb681 DDO |
437 | [zlib-dynamic](#zlib-dynamic) option is not also used. If `zlib-dynamic` is used |
438 | then this flag is optional and defaults to `ZLIB1` if not provided. | |
6ede7d73 DMSP |
439 | |
440 | **On VMS:** this is the filename of the zlib library (with or without a path). | |
9afbb681 DDO |
441 | This flag is optional and if not provided then `GNV$LIBZSHR`, `GNV$LIBZSHR32` |
442 | or `GNV$LIBZSHR64` is used by default depending on the pointer size chosen. | |
6ede7d73 | 443 | |
caf9317d TS |
444 | ### with-zstd-include |
445 | ||
446 | --with-zstd-include=DIR | |
447 | ||
448 | The directory for the location of the Zstd include file. This option is only | |
449 | necessary if [enable-std](#enable-zstd) is used and the include file is not | |
450 | already on the system include path. | |
451 | ||
452 | OpenSSL requires Zstd 1.4 or greater. The Linux kernel source contains a | |
453 | *zstd.h* file that is not compatible with the 1.4.x Zstd distribution, the | |
454 | compilation will generate an error if the Linux *zstd.h* is included before | |
455 | (or instead of) the Zstd distribution header. | |
456 | ||
457 | ### with-zstd-lib | |
458 | ||
459 | --with-zstd-lib=LIB | |
460 | ||
461 | **On Unix**: this is the directory containing the Zstd library. | |
462 | If not provided the system library path will be used. | |
463 | ||
464 | **On Windows:** this is the filename of the Zstd library (with or | |
465 | without a path). This flag must be provided if the | |
466 | [enable-zstd-dynamic](#enable-zstd-dynamic) option is not also used. | |
467 | If `zstd-dynamic` is used then this flag is optional and defaults | |
468 | to `LIBZSTD` if not provided. | |
469 | ||
6ede7d73 DMSP |
470 | Seeding the Random Generator |
471 | ---------------------------- | |
472 | ||
473 | --with-rand-seed=seed1[,seed2,...] | |
474 | ||
475 | A comma separated list of seeding methods which will be tried by OpenSSL | |
476 | in order to obtain random input (a.k.a "entropy") for seeding its | |
477 | cryptographically secure random number generator (CSPRNG). | |
478 | The current seeding methods are: | |
479 | ||
257e9d03 | 480 | ### os |
6ede7d73 DMSP |
481 | |
482 | Use a trusted operating system entropy source. | |
483 | This is the default method if such an entropy source exists. | |
484 | ||
257e9d03 | 485 | ### getrandom |
6ede7d73 DMSP |
486 | |
487 | Use the [getrandom(2)][man-getrandom] or equivalent system call. | |
488 | ||
489 | [man-getrandom]: http://man7.org/linux/man-pages/man2/getrandom.2.html | |
490 | ||
257e9d03 | 491 | ### devrandom |
6ede7d73 | 492 | |
9afbb681 DDO |
493 | Use the first device from the `DEVRANDOM` list which can be opened to read |
494 | random bytes. The `DEVRANDOM` preprocessor constant expands to | |
6ede7d73 DMSP |
495 | |
496 | "/dev/urandom","/dev/random","/dev/srandom" | |
497 | ||
498 | on most unix-ish operating systems. | |
499 | ||
257e9d03 | 500 | ### egd |
6ede7d73 DMSP |
501 | |
502 | Check for an entropy generating daemon. | |
b99c463d | 503 | This source is ignored by the FIPS provider. |
6ede7d73 | 504 | |
257e9d03 | 505 | ### rdcpu |
6ede7d73 | 506 | |
e8b597f3 OT |
507 | Use the `RDSEED` or `RDRAND` command on x86 or `RNDRRS` command on aarch64 |
508 | if provided by the CPU. | |
6ede7d73 | 509 | |
257e9d03 | 510 | ### librandom |
6ede7d73 DMSP |
511 | |
512 | Use librandom (not implemented yet). | |
b99c463d | 513 | This source is ignored by the FIPS provider. |
6ede7d73 | 514 | |
257e9d03 | 515 | ### none |
6ede7d73 DMSP |
516 | |
517 | Disable automatic seeding. This is the default on some operating systems where | |
518 | no suitable entropy source exists, or no support for it is implemented yet. | |
b99c463d | 519 | This option is ignored by the FIPS provider. |
6ede7d73 DMSP |
520 | |
521 | For more information, see the section [Notes on random number generation][rng] | |
522 | at the end of this document. | |
523 | ||
524 | [rng]: #notes-on-random-number-generation | |
525 | ||
31214258 RS |
526 | Setting the FIPS HMAC key |
527 | ------------------------- | |
528 | ||
529 | --fips-key=value | |
530 | ||
531 | As part of its self-test validation, the FIPS module must verify itself | |
532 | by performing a SHA-256 HMAC computation on itself. The default key is | |
533 | the SHA256 value of "the holy handgrenade of antioch" and is sufficient | |
534 | for meeting the FIPS requirements. | |
535 | ||
536 | To change the key to a different value, use this flag. The value should | |
537 | be a hex string no more than 64 characters. | |
538 | ||
6ede7d73 DMSP |
539 | Enable and Disable Features |
540 | --------------------------- | |
541 | ||
8c1cbc72 GN |
542 | Feature options always come in pairs, an option to enable feature |
543 | `xxxx`, and an option to disable it: | |
6ede7d73 DMSP |
544 | |
545 | [ enable-xxxx | no-xxxx ] | |
546 | ||
547 | Whether a feature is enabled or disabled by default, depends on the feature. | |
548 | In the following list, always the non-default variant is documented: if | |
9afbb681 DDO |
549 | feature `xxxx` is disabled by default then `enable-xxxx` is documented and |
550 | if feature `xxxx` is enabled by default then `no-xxxx` is documented. | |
6ede7d73 | 551 | |
257e9d03 | 552 | ### no-afalgeng |
6ede7d73 DMSP |
553 | |
554 | Don't build the AFALG engine. | |
555 | ||
556 | This option will be forced on a platform that does not support AFALG. | |
557 | ||
257e9d03 | 558 | ### enable-ktls |
6ede7d73 DMSP |
559 | |
560 | Build with Kernel TLS support. | |
561 | ||
562 | This option will enable the use of the Kernel TLS data-path, which can improve | |
563 | performance and allow for the use of sendfile and splice system calls on | |
564 | TLS sockets. The Kernel may use TLS accelerators if any are available on the | |
565 | system. This option will be forced off on systems that do not support the | |
566 | Kernel TLS data-path. | |
567 | ||
257e9d03 | 568 | ### enable-asan |
6ede7d73 DMSP |
569 | |
570 | Build with the Address sanitiser. | |
571 | ||
572 | This is a developer option only. It may not work on all platforms and should | |
573 | never be used in production environments. It will only work when used with | |
574 | gcc or clang and should be used in conjunction with the [no-shared](#no-shared) | |
575 | option. | |
576 | ||
d1a77041 | 577 | ### enable-acvp-tests |
4f2271d5 | 578 | |
d1a77041 | 579 | Build support for Automated Cryptographic Validation Protocol (ACVP) |
4f2271d5 SL |
580 | tests. |
581 | ||
582 | This is required for FIPS validation purposes. Certain ACVP tests require | |
583 | access to algorithm internals that are not normally accessible. | |
584 | Additional information related to ACVP can be found at | |
585 | <https://github.com/usnistgov/ACVP>. | |
586 | ||
ff88545e VK |
587 | ### no-apps |
588 | ||
589 | Do not build apps, e.g. the openssl program. This is handy for minimization. | |
590 | This option also disables tests. | |
591 | ||
257e9d03 | 592 | ### no-asm |
6ede7d73 DMSP |
593 | |
594 | Do not use assembler code. | |
595 | ||
596 | This should be viewed as debugging/troubleshooting option rather than for | |
597 | production use. On some platforms a small amount of assembler code may still | |
598 | be used even with this option. | |
599 | ||
257e9d03 | 600 | ### no-async |
6ede7d73 DMSP |
601 | |
602 | Do not build support for async operations. | |
603 | ||
99fb31c1 RB |
604 | ### no-atexit |
605 | ||
606 | Do not use `atexit()` in libcrypto builds. | |
607 | ||
608 | `atexit()` has varied semantics between platforms and can cause SIGSEGV in some | |
9dc22698 | 609 | circumstances. This option disables the atexit registration of OPENSSL_cleanup. |
99fb31c1 RB |
610 | By default, NonStop configurations use `no-atexit`. |
611 | ||
257e9d03 | 612 | ### no-autoalginit |
6ede7d73 DMSP |
613 | |
614 | Don't automatically load all supported ciphers and digests. | |
615 | ||
616 | Typically OpenSSL will make available all of its supported ciphers and digests. | |
617 | For a statically linked application this may be undesirable if small executable | |
618 | size is an objective. This only affects libcrypto. Ciphers and digests will | |
9afbb681 DDO |
619 | have to be loaded manually using `EVP_add_cipher()` and `EVP_add_digest()` |
620 | if this option is used. This option will force a non-shared build. | |
6ede7d73 | 621 | |
257e9d03 | 622 | ### no-autoerrinit |
6ede7d73 DMSP |
623 | |
624 | Don't automatically load all libcrypto/libssl error strings. | |
625 | ||
626 | Typically OpenSSL will automatically load human readable error strings. For a | |
627 | statically linked application this may be undesirable if small executable size | |
628 | is an objective. | |
629 | ||
12e96a23 TS |
630 | ### enable-brotli |
631 | ||
632 | Build with support for brotli compression/decompression. | |
633 | ||
634 | ### enable-brotli-dynamic | |
635 | ||
636 | Like the enable-brotli option, but has OpenSSL load the brotli library dynamically | |
637 | when needed. | |
638 | ||
639 | This is only supported on systems where loading of shared libraries is supported. | |
640 | ||
257e9d03 | 641 | ### no-autoload-config |
6ede7d73 | 642 | |
9afbb681 | 643 | Don't automatically load the default `openssl.cnf` file. |
6ede7d73 DMSP |
644 | |
645 | Typically OpenSSL will automatically load a system config file which configures | |
646 | default SSL options. | |
647 | ||
257e9d03 | 648 | ### enable-buildtest-c++ |
6ede7d73 DMSP |
649 | |
650 | While testing, generate C++ buildtest files that simply check that the public | |
651 | OpenSSL header files are usable standalone with C++. | |
652 | ||
653 | Enabling this option demands extra care. For any compiler flag given directly | |
654 | as configuration option, you must ensure that it's valid for both the C and | |
655 | the C++ compiler. If not, the C++ build test will most likely break. As an | |
9afbb681 | 656 | alternative, you can use the language specific variables, `CFLAGS` and `CXXFLAGS`. |
6ede7d73 | 657 | |
d0364dcc RS |
658 | ### --banner=text |
659 | ||
660 | Use the specified text instead of the default banner at the end of | |
661 | configuration. | |
662 | ||
ecb09baf RS |
663 | ### --w |
664 | ||
665 | On platforms where the choice of 32-bit or 64-bit architecture | |
666 | is not explicitly specified, `Configure` will print a warning | |
667 | message and wait for a few seconds to let you interrupt the | |
668 | configuration. Using this flag skips the wait. | |
669 | ||
06f81af8 DDO |
670 | ### no-bulk |
671 | ||
672 | Build only some minimal set of features. | |
673 | This is a developer option used internally for CI build tests of the project. | |
674 | ||
1eaf1fc3 P |
675 | ### no-cached-fetch |
676 | ||
677 | Never cache algorithms when they are fetched from a provider. Normally, a | |
678 | provider indicates if the algorithms it supplies can be cached or not. Using | |
679 | this option will reduce run-time memory usage but it also introduces a | |
680 | significant performance penalty. This option is primarily designed to help | |
681 | with detecting incorrect reference counting. | |
682 | ||
257e9d03 | 683 | ### no-capieng |
6ede7d73 DMSP |
684 | |
685 | Don't build the CAPI engine. | |
686 | ||
687 | This option will be forced if on a platform that does not support CAPI. | |
688 | ||
257e9d03 | 689 | ### no-cmp |
6ede7d73 | 690 | |
9afbb681 DDO |
691 | Don't build support for Certificate Management Protocol (CMP) |
692 | and Certificate Request Message Format (CRMF). | |
6ede7d73 | 693 | |
257e9d03 | 694 | ### no-cms |
6ede7d73 DMSP |
695 | |
696 | Don't build support for Cryptographic Message Syntax (CMS). | |
697 | ||
257e9d03 | 698 | ### no-comp |
6ede7d73 DMSP |
699 | |
700 | Don't build support for SSL/TLS compression. | |
701 | ||
702 | If this option is enabled (the default), then compression will only work if | |
9afbb681 | 703 | the zlib or `zlib-dynamic` options are also chosen. |
6ede7d73 | 704 | |
257e9d03 | 705 | ### enable-crypto-mdebug |
6ede7d73 | 706 | |
9afbb681 | 707 | This now only enables the `failed-malloc` feature. |
6ede7d73 | 708 | |
257e9d03 | 709 | ### enable-crypto-mdebug-backtrace |
6ede7d73 DMSP |
710 | |
711 | This is a no-op; the project uses the compiler's address/leak sanitizer instead. | |
712 | ||
257e9d03 | 713 | ### no-ct |
6ede7d73 DMSP |
714 | |
715 | Don't build support for Certificate Transparency (CT). | |
716 | ||
257e9d03 | 717 | ### no-deprecated |
6ede7d73 DMSP |
718 | |
719 | Don't build with support for deprecated APIs up until and including the version | |
720 | given with `--api` (or the current version, if `--api` wasn't specified). | |
721 | ||
257e9d03 | 722 | ### no-dgram |
6ede7d73 DMSP |
723 | |
724 | Don't build support for datagram based BIOs. | |
725 | ||
726 | Selecting this option will also force the disabling of DTLS. | |
727 | ||
956b4c75 VK |
728 | ### no-docs |
729 | ||
730 | Don't build and install documentation, i.e. manual pages in various forms. | |
731 | ||
257e9d03 | 732 | ### no-dso |
6ede7d73 DMSP |
733 | |
734 | Don't build support for loading Dynamic Shared Objects (DSO) | |
735 | ||
257e9d03 | 736 | ### enable-devcryptoeng |
6ede7d73 DMSP |
737 | |
738 | Build the `/dev/crypto` engine. | |
739 | ||
740 | This option is automatically selected on the BSD platform, in which case it can | |
9afbb681 | 741 | be disabled with `no-devcryptoeng`. |
6ede7d73 | 742 | |
257e9d03 | 743 | ### no-dynamic-engine |
6ede7d73 DMSP |
744 | |
745 | Don't build the dynamically loaded engines. | |
746 | ||
747 | This only has an effect in a shared build. | |
748 | ||
257e9d03 | 749 | ### no-ec |
6ede7d73 DMSP |
750 | |
751 | Don't build support for Elliptic Curves. | |
752 | ||
257e9d03 | 753 | ### no-ec2m |
6ede7d73 DMSP |
754 | |
755 | Don't build support for binary Elliptic Curves | |
756 | ||
257e9d03 | 757 | ### enable-ec_nistp_64_gcc_128 |
6ede7d73 DMSP |
758 | |
759 | Enable support for optimised implementations of some commonly used NIST | |
760 | elliptic curves. | |
761 | ||
762 | This option is only supported on platforms: | |
763 | ||
764 | - with little-endian storage of non-byte types | |
765 | - that tolerate misaligned memory references | |
766 | - where the compiler: | |
767 | - supports the non-standard type `__uint128_t` | |
768 | - defines the built-in macro `__SIZEOF_INT128__` | |
769 | ||
257e9d03 | 770 | ### enable-egd |
6ede7d73 DMSP |
771 | |
772 | Build support for gathering entropy from the Entropy Gathering Daemon (EGD). | |
773 | ||
257e9d03 | 774 | ### no-engine |
6ede7d73 DMSP |
775 | |
776 | Don't build support for loading engines. | |
777 | ||
257e9d03 | 778 | ### no-err |
6ede7d73 DMSP |
779 | |
780 | Don't compile in any error strings. | |
781 | ||
257e9d03 | 782 | ### enable-external-tests |
6ede7d73 DMSP |
783 | |
784 | Enable building of integration with external test suites. | |
785 | ||
786 | This is a developer option and may not work on all platforms. The following | |
787 | external test suites are currently supported: | |
788 | ||
cede07dc | 789 | - GOST engine test suite |
6ede7d73 DMSP |
790 | - Python PYCA/Cryptography test suite |
791 | - krb5 test suite | |
792 | ||
036cbb6b DDO |
793 | See the file [test/README-external.md](test/README-external.md) |
794 | for further details. | |
6ede7d73 | 795 | |
257e9d03 | 796 | ### no-filenames |
6ede7d73 DMSP |
797 | |
798 | Don't compile in filename and line number information (e.g. for errors and | |
799 | memory allocation). | |
800 | ||
f2ea01d9 | 801 | ### enable-fips |
6ede7d73 | 802 | |
f2ea01d9 | 803 | Build (and install) the FIPS provider |
6ede7d73 | 804 | |
991a6bb5 SL |
805 | ### no-fips-securitychecks |
806 | ||
807 | Don't perform FIPS module run-time checks related to enforcement of security | |
808 | parameters such as minimum security strength of keys. | |
809 | ||
257e9d03 | 810 | ### enable-fuzz-libfuzzer, enable-fuzz-afl |
6ede7d73 DMSP |
811 | |
812 | Build with support for fuzzing using either libfuzzer or AFL. | |
813 | ||
814 | These are developer options only. They may not work on all platforms and | |
815 | should never be used in production environments. | |
816 | ||
817 | See the file [fuzz/README.md](fuzz/README.md) for further details. | |
818 | ||
257e9d03 | 819 | ### no-gost |
6ede7d73 DMSP |
820 | |
821 | Don't build support for GOST based ciphersuites. | |
822 | ||
823 | Note that if this feature is enabled then GOST ciphersuites are only available | |
824 | if the GOST algorithms are also available through loading an externally supplied | |
825 | engine. | |
826 | ||
6b1f763c VK |
827 | ### no-http |
828 | ||
829 | Disable HTTP support. | |
830 | ||
257e9d03 | 831 | ### no-legacy |
6ede7d73 DMSP |
832 | |
833 | Don't build the legacy provider. | |
834 | ||
835 | Disabling this also disables the legacy algorithms: MD2 (already disabled by default). | |
836 | ||
257e9d03 | 837 | ### no-makedepend |
6ede7d73 DMSP |
838 | |
839 | Don't generate dependencies. | |
840 | ||
257e9d03 | 841 | ### no-module |
79e259e3 | 842 | |
6ede7d73 | 843 | Don't build any dynamically loadable engines. |
917a1b2e | 844 | |
9afbb681 | 845 | This also implies `no-dynamic-engine`. |
917a1b2e | 846 | |
257e9d03 | 847 | ### no-multiblock |
917a1b2e | 848 | |
6ede7d73 | 849 | Don't build support for writing multiple records in one go in libssl |
917a1b2e | 850 | |
6ede7d73 | 851 | Note: this is a different capability to the pipelining functionality. |
917a1b2e | 852 | |
257e9d03 | 853 | ### no-nextprotoneg |
917a1b2e | 854 | |
6ede7d73 | 855 | Don't build support for the Next Protocol Negotiation (NPN) TLS extension. |
c9f06e7f | 856 | |
257e9d03 | 857 | ### no-ocsp |
c9f06e7f | 858 | |
6ede7d73 | 859 | Don't build support for Online Certificate Status Protocol (OCSP). |
b32b8961 | 860 | |
257e9d03 | 861 | ### no-padlockeng |
2acd8ec7 | 862 | |
6ede7d73 | 863 | Don't build the padlock engine. |
2acd8ec7 | 864 | |
257e9d03 | 865 | ### no-hw-padlock |
c9f06e7f | 866 | |
9afbb681 | 867 | As synonym for `no-padlockeng`. Deprecated and should not be used. |
c9f06e7f | 868 | |
257e9d03 | 869 | ### no-pic |
b1fe6b43 | 870 | |
6ede7d73 | 871 | Don't build with support for Position Independent Code. |
b1fe6b43 | 872 | |
257e9d03 | 873 | ### no-pinshared |
79e259e3 | 874 | |
6ede7d73 | 875 | Don't pin the shared libraries. |
79e259e3 | 876 | |
6ede7d73 DMSP |
877 | By default OpenSSL will attempt to stay in memory until the process exits. |
878 | This is so that libcrypto and libssl can be properly cleaned up automatically | |
9afbb681 DDO |
879 | via an `atexit()` handler. The handler is registered by libcrypto and cleans |
880 | up both libraries. On some platforms the `atexit()` handler will run on unload of | |
ce451fb8 MSP |
881 | libcrypto (if it has been dynamically loaded) rather than at process exit. |
882 | ||
883 | This option can be used to stop OpenSSL from attempting to stay in memory until the | |
6ede7d73 DMSP |
884 | process exits. This could lead to crashes if either libcrypto or libssl have |
885 | already been unloaded at the point that the atexit handler is invoked, e.g. on a | |
9afbb681 | 886 | platform which calls `atexit()` on unload of the library, and libssl is unloaded |
ce451fb8 MSP |
887 | before libcrypto then a crash is likely to happen. |
888 | ||
889 | Note that shared library pinning is not automatically disabled for static builds, | |
890 | i.e., `no-shared` does not imply `no-pinshared`. This may come as a surprise when | |
891 | linking libcrypto statically into a shared third-party library, because in this | |
892 | case the shared library will be pinned. To prevent this behaviour, you need to | |
893 | configure the static build using `no-shared` and `no-pinshared` together. | |
894 | ||
895 | Applications can suppress running of the `atexit()` handler at run time by | |
896 | using the `OPENSSL_INIT_NO_ATEXIT` option to `OPENSSL_init_crypto()`. | |
9afbb681 | 897 | See the man page for it for further details. |
2acd8ec7 | 898 | |
257e9d03 | 899 | ### no-posix-io |
2acd8ec7 | 900 | |
6ede7d73 | 901 | Don't use POSIX IO capabilities. |
2acd8ec7 | 902 | |
257e9d03 | 903 | ### no-psk |
79e259e3 | 904 | |
6ede7d73 | 905 | Don't build support for Pre-Shared Key based ciphersuites. |
79e259e3 | 906 | |
257e9d03 | 907 | ### no-rdrand |
79e259e3 | 908 | |
6ede7d73 | 909 | Don't use hardware RDRAND capabilities. |
79e259e3 | 910 | |
257e9d03 | 911 | ### no-rfc3779 |
5bb9e2b4 | 912 | |
6ede7d73 DMSP |
913 | Don't build support for RFC3779, "X.509 Extensions for IP Addresses and |
914 | AS Identifiers". | |
79e259e3 | 915 | |
257e9d03 | 916 | ### sctp |
2acd8ec7 | 917 | |
6ede7d73 | 918 | Build support for Stream Control Transmission Protocol (SCTP). |
2acd8ec7 | 919 | |
257e9d03 | 920 | ### no-shared |
2acd8ec7 | 921 | |
6ede7d73 | 922 | Do not create shared libraries, only static ones. |
2acd8ec7 | 923 | |
6ede7d73 | 924 | See [Notes on shared libraries](#notes-on-shared-libraries) below. |
2acd8ec7 | 925 | |
6399d785 XY |
926 | ### no-sm2-precomp |
927 | ||
928 | Disable using the SM2 precomputed table on aarch64 to make the library smaller. | |
929 | ||
257e9d03 | 930 | ### no-sock |
2acd8ec7 | 931 | |
6ede7d73 | 932 | Don't build support for socket BIOs. |
2acd8ec7 | 933 | |
257e9d03 | 934 | ### no-srp |
2acd8ec7 | 935 | |
6ede7d73 DMSP |
936 | Don't build support for Secure Remote Password (SRP) protocol or |
937 | SRP based ciphersuites. | |
2acd8ec7 | 938 | |
257e9d03 | 939 | ### no-srtp |
b32b8961 | 940 | |
6ede7d73 | 941 | Don't build Secure Real-Time Transport Protocol (SRTP) support. |
b32b8961 | 942 | |
257e9d03 | 943 | ### no-sse2 |
2acd8ec7 | 944 | |
6ede7d73 | 945 | Exclude SSE2 code paths from 32-bit x86 assembly modules. |
79e259e3 | 946 | |
6ede7d73 DMSP |
947 | Normally SSE2 extension is detected at run-time, but the decision whether or not |
948 | the machine code will be executed is taken solely on CPU capability vector. This | |
949 | means that if you happen to run OS kernel which does not support SSE2 extension | |
950 | on Intel P4 processor, then your application might be exposed to "illegal | |
951 | instruction" exception. There might be a way to enable support in kernel, e.g. | |
9afbb681 | 952 | FreeBSD kernel can be compiled with `CPU_ENABLE_SSE`, and there is a way to |
6ede7d73 | 953 | disengage SSE2 code paths upon application start-up, but if you aim for wider |
9afbb681 DDO |
954 | "audience" running such kernel, consider `no-sse2`. Both the `386` and `no-asm` |
955 | options imply `no-sse2`. | |
79e259e3 | 956 | |
726f92e0 | 957 | ### no-ssl-trace |
79e259e3 | 958 | |
726f92e0 | 959 | Don't build with SSL Trace capabilities. |
1af66bb7 | 960 | |
726f92e0 ACB |
961 | This removes the `-trace` option from `s_client` and `s_server`, and omits the |
962 | `SSL_trace()` function from libssl. | |
963 | ||
964 | Disabling `ssl-trace` may provide a small reduction in libssl binary size. | |
1af66bb7 | 965 | |
257e9d03 | 966 | ### no-static-engine |
1af66bb7 | 967 | |
6ede7d73 | 968 | Don't build the statically linked engines. |
1af66bb7 | 969 | |
6ede7d73 | 970 | This only has an impact when not built "shared". |
1af66bb7 | 971 | |
257e9d03 | 972 | ### no-stdio |
1af66bb7 | 973 | |
3a0b3cc9 | 974 | Don't use anything from the C header file `stdio.h` that makes use of the `FILE` |
6ede7d73 DMSP |
975 | type. Only libcrypto and libssl can be built in this way. Using this option will |
976 | suppress building the command line applications. Additionally, since the OpenSSL | |
977 | tests also use the command line applications, the tests will also be skipped. | |
b1fe6b43 | 978 | |
257e9d03 | 979 | ### no-tests |
79e259e3 | 980 | |
6ede7d73 | 981 | Don't build test programs or run any tests. |
79e259e3 | 982 | |
a3e53d56 TS |
983 | ### enable-tfo |
984 | ||
985 | Build with support for TCP Fast Open (RFC7413). Supported on Linux, macOS and FreeBSD. | |
986 | ||
8a764202 | 987 | ### no-quic |
30b01329 | 988 | |
8a764202 | 989 | Don't build with QUIC support. |
30b01329 | 990 | |
257e9d03 | 991 | ### no-threads |
6616429d | 992 | |
6ede7d73 | 993 | Don't build with support for multi-threaded applications. |
2e996acf | 994 | |
257e9d03 | 995 | ### threads |
2acd8ec7 | 996 | |
6ede7d73 | 997 | Build with support for multi-threaded applications. Most platforms will enable |
8c1cbc72 | 998 | this by default. However, if on a platform where this is not the case then this |
6ede7d73 | 999 | will usually require additional system-dependent options! |
2e996acf | 1000 | |
6ede7d73 | 1001 | See [Notes on multi-threading](#notes-on-multi-threading) below. |
e3d9a6b5 | 1002 | |
4574a7fd ÄŒK |
1003 | ### no-thread-pool |
1004 | ||
1005 | Don't build with support for thread pool functionality. | |
1006 | ||
1007 | ### thread-pool | |
1008 | ||
1009 | Build with thread pool functionality. If enabled, OpenSSL algorithms may | |
1010 | use the thread pool to perform parallel computation. This option in itself | |
1011 | does not enable OpenSSL to spawn new threads. Currently the only supported | |
1012 | thread pool mechanism is the default thread pool. | |
1013 | ||
1014 | ### no-default-thread-pool | |
1015 | ||
1016 | Don't build with support for default thread pool functionality. | |
1017 | ||
1018 | ### default-thread-pool | |
1019 | ||
1020 | Build with default thread pool functionality. If enabled, OpenSSL may create | |
1021 | and manage threads up to a maximum number of threads authorized by the | |
1022 | application. Supported on POSIX compliant platforms and Windows. | |
1023 | ||
257e9d03 | 1024 | ### enable-trace |
b32b8961 | 1025 | |
6ede7d73 | 1026 | Build with support for the integrated tracing api. |
2e996acf | 1027 | |
6ede7d73 | 1028 | See manual pages OSSL_trace_set_channel(3) and OSSL_trace_enabled(3) for details. |
2e996acf | 1029 | |
257e9d03 | 1030 | ### no-ts |
a73d990e | 1031 | |
6ede7d73 | 1032 | Don't build Time Stamping (TS) Authority support. |
2e996acf | 1033 | |
257e9d03 | 1034 | ### enable-ubsan |
2e996acf | 1035 | |
6ede7d73 | 1036 | Build with the Undefined Behaviour sanitiser (UBSAN). |
2e996acf | 1037 | |
6ede7d73 | 1038 | This is a developer option only. It may not work on all platforms and should |
9afbb681 DDO |
1039 | never be used in production environments. It will only work when used with |
1040 | gcc or clang and should be used in conjunction with the `-DPEDANTIC` option | |
6ede7d73 | 1041 | (or the `--strict-warnings` option). |
d40b0622 | 1042 | |
257e9d03 | 1043 | ### no-ui-console |
2e996acf | 1044 | |
301ea192 | 1045 | Don't build with the User Interface (UI) console method |
b1fe6b43 | 1046 | |
301ea192 | 1047 | The User Interface console method enables text based console prompts. |
b3e718e2 | 1048 | |
257e9d03 | 1049 | ### enable-unit-test |
79e259e3 | 1050 | |
6ede7d73 | 1051 | Enable additional unit test APIs. |
2acd8ec7 | 1052 | |
6ede7d73 | 1053 | This should not typically be used in production deployments. |
7c03bb9f | 1054 | |
257e9d03 | 1055 | ### no-uplink |
2acd8ec7 | 1056 | |
6ede7d73 | 1057 | Don't build support for UPLINK interface. |
2acd8ec7 | 1058 | |
257e9d03 | 1059 | ### enable-weak-ssl-ciphers |
b0940b33 | 1060 | |
6ede7d73 | 1061 | Build support for SSL/TLS ciphers that are considered "weak" |
fa28bfd6 | 1062 | |
6ede7d73 | 1063 | Enabling this includes for example the RC4 based ciphersuites. |
fa28bfd6 | 1064 | |
257e9d03 | 1065 | ### zlib |
fa28bfd6 | 1066 | |
6ede7d73 | 1067 | Build with support for zlib compression/decompression. |
fa28bfd6 | 1068 | |
257e9d03 | 1069 | ### zlib-dynamic |
fa28bfd6 | 1070 | |
6ede7d73 DMSP |
1071 | Like the zlib option, but has OpenSSL load the zlib library dynamically |
1072 | when needed. | |
fa28bfd6 | 1073 | |
6ede7d73 | 1074 | This is only supported on systems where loading of shared libraries is supported. |
fa28bfd6 | 1075 | |
caf9317d TS |
1076 | ### enable-zstd |
1077 | ||
1078 | Build with support for Zstd compression/decompression. | |
1079 | ||
1080 | ### enable-zstd-dynamic | |
1081 | ||
1082 | Like the enable-zstd option, but has OpenSSL load the Zstd library dynamically | |
1083 | when needed. | |
1084 | ||
1085 | This is only supported on systems where loading of shared libraries is supported. | |
1086 | ||
000e72ec HL |
1087 | ### enable-unstable-qlog |
1088 | ||
de60b122 HL |
1089 | Enables qlog output support for the QUIC protocol. This functionality is |
1090 | unstable and implements a draft version of the qlog specification. The qlog | |
000e72ec HL |
1091 | output from OpenSSL will change in incompatible ways in future, and is not |
1092 | subject to any format stability or compatibility guarantees at this time. See | |
1093 | the manpage openssl-qlog(7) for details. | |
1094 | ||
257e9d03 | 1095 | ### 386 |
fa28bfd6 | 1096 | |
6ede7d73 | 1097 | In 32-bit x86 builds, use the 80386 instruction set only in assembly modules |
fa28bfd6 | 1098 | |
6ede7d73 DMSP |
1099 | The default x86 code is more efficient, but requires at least an 486 processor. |
1100 | Note: This doesn't affect compiler generated code, so this option needs to be | |
1101 | accompanied by a corresponding compiler-specific option. | |
fa28bfd6 | 1102 | |
257e9d03 | 1103 | ### no-{protocol} |
bf01fbbf | 1104 | |
6ede7d73 | 1105 | no-{ssl|ssl3|tls|tls1|tls1_1|tls1_2|tls1_3|dtls|dtls1|dtls1_2} |
4fd53220 | 1106 | |
6ede7d73 | 1107 | Don't build support for negotiating the specified SSL/TLS protocol. |
b3e718e2 | 1108 | |
9afbb681 DDO |
1109 | If `no-tls` is selected then all of `tls1`, `tls1_1`, `tls1_2` and `tls1_3` |
1110 | are disabled. | |
1111 | Similarly `no-dtls` will disable `dtls1` and `dtls1_2`. The `no-ssl` option is | |
1112 | synonymous with `no-ssl3`. Note this only affects version negotiation. | |
6ede7d73 DMSP |
1113 | OpenSSL will still provide the methods for applications to explicitly select |
1114 | the individual protocol versions. | |
b3e718e2 | 1115 | |
257e9d03 | 1116 | ### no-{protocol}-method |
b3e718e2 | 1117 | |
5f18dc7f | 1118 | no-{ssl3|tls1|tls1_1|tls1_2|dtls1|dtls1_2}-method |
b3e718e2 | 1119 | |
9afbb681 | 1120 | Analogous to `no-{protocol}` but in addition do not build the methods for |
6ede7d73 | 1121 | applications to explicitly select individual protocol versions. Note that there |
9afbb681 | 1122 | is no `no-tls1_3-method` option because there is no application method for |
6ede7d73 | 1123 | TLSv1.3. |
b3e718e2 | 1124 | |
6ede7d73 | 1125 | Using individual protocol methods directly is deprecated. Applications should |
9afbb681 | 1126 | use `TLS_method()` instead. |
b3e718e2 | 1127 | |
257e9d03 | 1128 | ### enable-{algorithm} |
b3e718e2 | 1129 | |
6ede7d73 | 1130 | enable-{md2|rc5} |
b3e718e2 | 1131 | |
6ede7d73 | 1132 | Build with support for the specified algorithm. |
b3e718e2 | 1133 | |
257e9d03 | 1134 | ### no-{algorithm} |
b3e718e2 | 1135 | |
6ede7d73 DMSP |
1136 | no-{aria|bf|blake2|camellia|cast|chacha|cmac| |
1137 | des|dh|dsa|ecdh|ecdsa|idea|md4|mdc2|ocb| | |
1138 | poly1305|rc2|rc4|rmd160|scrypt|seed| | |
1139 | siphash|siv|sm2|sm3|sm4|whirlpool} | |
d0631327 | 1140 | |
6ede7d73 | 1141 | Build without support for the specified algorithm. |
d0631327 | 1142 | |
9afbb681 | 1143 | The `ripemd` algorithm is deprecated and if used is synonymous with `rmd160`. |
d0631327 | 1144 | |
257e9d03 | 1145 | ### Compiler-specific options |
d0631327 | 1146 | |
6ede7d73 | 1147 | -Dxxx, -Ixxx, -Wp, -lxxx, -Lxxx, -Wl, -rpath, -R, -framework, -static |
d0631327 | 1148 | |
6ede7d73 DMSP |
1149 | These system specific options will be recognised and passed through to the |
1150 | compiler to allow you to define preprocessor symbols, specify additional | |
1151 | libraries, library directories or other compiler options. It might be worth | |
1152 | noting that some compilers generate code specifically for processor the | |
1153 | compiler currently executes on. This is not necessarily what you might have | |
1154 | in mind, since it might be unsuitable for execution on other, typically older, | |
1155 | processor. Consult your compiler documentation. | |
1156 | ||
1157 | Take note of the [Environment Variables](#environment-variables) documentation | |
1158 | below and how these flags interact with those variables. | |
1159 | ||
1160 | -xxx, +xxx, /xxx | |
1161 | ||
1162 | Additional options that are not otherwise recognised are passed through as | |
1163 | they are to the compiler as well. Unix-style options beginning with a | |
af33b200 | 1164 | `-` or `+` and Windows-style options beginning with a `/` are recognised. |
6ede7d73 DMSP |
1165 | Again, consult your compiler documentation. |
1166 | ||
1167 | If the option contains arguments separated by spaces, then the URL-style | |
9afbb681 DDO |
1168 | notation `%20` can be used for the space character in order to avoid having |
1169 | to quote the option. For example, `-opt%20arg` gets expanded to `-opt arg`. | |
6ede7d73 DMSP |
1170 | In fact, any ASCII character can be encoded as %xx using its hexadecimal |
1171 | encoding. | |
1172 | ||
1173 | Take note of the [Environment Variables](#environment-variables) documentation | |
1174 | below and how these flags interact with those variables. | |
1175 | ||
257e9d03 | 1176 | ### Environment Variables |
6ede7d73 DMSP |
1177 | |
1178 | VAR=value | |
1179 | ||
9afbb681 | 1180 | Assign the given value to the environment variable `VAR` for `Configure`. |
6ede7d73 DMSP |
1181 | |
1182 | These work just like normal environment variable assignments, but are supported | |
1183 | on all platforms and are confined to the configuration scripts only. | |
1184 | These assignments override the corresponding value in the inherited environment, | |
1185 | if there is one. | |
1186 | ||
3a0b3cc9 | 1187 | The following variables are used as "`make` variables" and can be used as an |
6ede7d73 DMSP |
1188 | alternative to giving preprocessor, compiler and linker options directly as |
1189 | configuration. The following variables are supported: | |
1190 | ||
1191 | AR The static library archiver. | |
1192 | ARFLAGS Flags for the static library archiver. | |
1193 | AS The assembler compiler. | |
1194 | ASFLAGS Flags for the assembler compiler. | |
1195 | CC The C compiler. | |
1196 | CFLAGS Flags for the C compiler. | |
1197 | CXX The C++ compiler. | |
1198 | CXXFLAGS Flags for the C++ compiler. | |
1199 | CPP The C/C++ preprocessor. | |
1200 | CPPFLAGS Flags for the C/C++ preprocessor. | |
1201 | CPPDEFINES List of CPP macro definitions, separated | |
1202 | by a platform specific character (':' or | |
1203 | space for Unix, ';' for Windows, ',' for | |
1204 | VMS). This can be used instead of using | |
1205 | -D (or what corresponds to that on your | |
1206 | compiler) in CPPFLAGS. | |
1207 | CPPINCLUDES List of CPP inclusion directories, separated | |
1208 | the same way as for CPPDEFINES. This can | |
1209 | be used instead of -I (or what corresponds | |
1210 | to that on your compiler) in CPPFLAGS. | |
1211 | HASHBANGPERL Perl invocation to be inserted after '#!' | |
1212 | in public perl scripts (only relevant on | |
1213 | Unix). | |
1214 | LD The program linker (not used on Unix, $(CC) | |
1215 | is used there). | |
1216 | LDFLAGS Flags for the shared library, DSO and | |
1217 | program linker. | |
1218 | LDLIBS Extra libraries to use when linking. | |
1219 | Takes the form of a space separated list | |
1220 | of library specifications on Unix and | |
1221 | Windows, and as a comma separated list of | |
1222 | libraries on VMS. | |
1223 | RANLIB The library archive indexer. | |
1224 | RC The Windows resource compiler. | |
1225 | RCFLAGS Flags for the Windows resource compiler. | |
1226 | RM The command to remove files and directories. | |
1227 | ||
1228 | These cannot be mixed with compiling/linking flags given on the command line. | |
1229 | In other words, something like this isn't permitted. | |
1230 | ||
16b0e0fc | 1231 | $ ./Configure -DFOO CPPFLAGS=-DBAR -DCOOKIE |
6ede7d73 DMSP |
1232 | |
1233 | Backward compatibility note: | |
1234 | ||
1235 | To be compatible with older configuration scripts, the environment variables | |
1236 | are ignored if compiling/linking flags are given on the command line, except | |
1237 | for the following: | |
1238 | ||
1239 | AR, CC, CXX, CROSS_COMPILE, HASHBANGPERL, PERL, RANLIB, RC, and WINDRES | |
1240 | ||
9afbb681 | 1241 | For example, the following command will not see `-DBAR`: |
6ede7d73 | 1242 | |
16b0e0fc | 1243 | $ CPPFLAGS=-DBAR ./Configure -DCOOKIE |
6ede7d73 DMSP |
1244 | |
1245 | However, the following will see both set variables: | |
1246 | ||
16b0e0fc | 1247 | $ CC=gcc CROSS_COMPILE=x86_64-w64-mingw32- ./Configure -DCOOKIE |
6ede7d73 | 1248 | |
9afbb681 | 1249 | If `CC` is set, it is advisable to also set `CXX` to ensure both the C and C++ |
6ede7d73 | 1250 | compiler are in the same "family". This becomes relevant with |
9afbb681 | 1251 | `enable-external-tests` and `enable-buildtest-c++`. |
6ede7d73 | 1252 | |
257e9d03 | 1253 | ### Reconfigure |
6ede7d73 DMSP |
1254 | |
1255 | reconf | |
1256 | reconfigure | |
1257 | ||
1258 | Reconfigure from earlier data. | |
1259 | ||
16b0e0fc | 1260 | This fetches the previous command line options and environment from data |
9afbb681 | 1261 | saved in `configdata.pm` and runs the configuration process again, using |
16b0e0fc | 1262 | these options and environment. Note: NO other option is permitted together |
9afbb681 | 1263 | with `reconf`. Note: The original configuration saves away values for ALL |
16b0e0fc RL |
1264 | environment variables that were used, and if they weren't defined, they are |
1265 | still saved away with information that they weren't originally defined. | |
1266 | This information takes precedence over environment variables that are | |
1267 | defined when reconfiguring. | |
6ede7d73 DMSP |
1268 | |
1269 | Displaying configuration data | |
1270 | ----------------------------- | |
1271 | ||
1272 | The configuration script itself will say very little, and finishes by | |
9afbb681 | 1273 | creating `configdata.pm`. This perl module can be loaded by other scripts |
6ede7d73 DMSP |
1274 | to find all the configuration data, and it can also be used as a script to |
1275 | display all sorts of configuration data in a human readable form. | |
1276 | ||
1277 | For more information, please do: | |
1278 | ||
1279 | $ ./configdata.pm --help # Unix | |
1280 | ||
1281 | or | |
1282 | ||
1283 | $ perl configdata.pm --help # Windows and VMS | |
1284 | ||
1285 | Installation Steps in Detail | |
1286 | ============================ | |
1287 | ||
1288 | Configure OpenSSL | |
1289 | ----------------- | |
1290 | ||
257e9d03 | 1291 | ### Automatic Configuration |
6ede7d73 | 1292 | |
92115096 RS |
1293 | In previous version, the `config` script determined the platform type and |
1294 | compiler and then called `Configure`. Starting with this release, they are | |
1295 | the same. | |
6ede7d73 | 1296 | |
257e9d03 | 1297 | #### Unix / Linux / macOS |
6ede7d73 | 1298 | |
a4ffb33e | 1299 | $ ./Configure [options...] |
6ede7d73 | 1300 | |
257e9d03 | 1301 | #### OpenVMS |
6ede7d73 | 1302 | |
a4ffb33e | 1303 | $ perl Configure [options...] |
6ede7d73 | 1304 | |
257e9d03 | 1305 | #### Windows |
6ede7d73 | 1306 | |
a4ffb33e | 1307 | $ perl Configure [options...] |
6ede7d73 | 1308 | |
257e9d03 | 1309 | ### Manual Configuration |
6ede7d73 DMSP |
1310 | |
1311 | OpenSSL knows about a range of different operating system, hardware and | |
1312 | compiler combinations. To see the ones it knows about, run | |
1313 | ||
16b0e0fc | 1314 | $ ./Configure LIST # Unix |
6ede7d73 DMSP |
1315 | |
1316 | or | |
1317 | ||
16b0e0fc | 1318 | $ perl Configure LIST # All other platforms |
6ede7d73 DMSP |
1319 | |
1320 | For the remainder of this text, the Unix form will be used in all examples. | |
1321 | Please use the appropriate form for your platform. | |
1322 | ||
1323 | Pick a suitable name from the list that matches your system. For most | |
9afbb681 | 1324 | operating systems there is a choice between using cc or gcc. |
6ede7d73 | 1325 | When you have identified your system (and if necessary compiler) use this |
9afbb681 | 1326 | name as the argument to `Configure`. For example, a `linux-elf` user would |
6ede7d73 DMSP |
1327 | run: |
1328 | ||
a4ffb33e | 1329 | $ ./Configure linux-elf [options...] |
6ede7d73 | 1330 | |
257e9d03 | 1331 | ### Creating your own Configuration |
6ede7d73 DMSP |
1332 | |
1333 | If your system isn't listed, you will have to create a configuration | |
a4ffb33e RS |
1334 | file named `Configurations/YOURFILENAME.conf` (replace `YOURFILENAME` |
1335 | with a filename of your choosing) and add the correct | |
6ede7d73 | 1336 | configuration for your system. See the available configs as examples |
036cbb6b DDO |
1337 | and read [Configurations/README.md](Configurations/README.md) and |
1338 | [Configurations/README-design.md](Configurations/README-design.md) | |
3a0b3cc9 | 1339 | for more information. |
6ede7d73 | 1340 | |
9afbb681 | 1341 | The generic configurations `cc` or `gcc` should usually work on 32 bit |
6ede7d73 DMSP |
1342 | Unix-like systems. |
1343 | ||
9afbb681 DDO |
1344 | `Configure` creates a build file (`Makefile` on Unix, `makefile` on Windows |
1345 | and `descrip.mms` on OpenVMS) from a suitable template in `Configurations/`, | |
1346 | and defines various macros in `include/openssl/configuration.h` (generated | |
1347 | from `include/openssl/configuration.h.in`. | |
6ede7d73 | 1348 | |
aa2d7e0e RL |
1349 | If none of the generated build files suit your purpose, it's possible to |
1350 | write your own build file template and give its name through the environment | |
1351 | variable `BUILDFILE`. For example, Ninja build files could be supported by | |
1352 | writing `Configurations/build.ninja.tmpl` and then configure with `BUILDFILE` | |
1353 | set like this (Unix syntax shown, you'll have to adapt for other platforms): | |
1354 | ||
1355 | $ BUILDFILE=build.ninja perl Configure [options...] | |
1356 | ||
257e9d03 | 1357 | ### Out of Tree Builds |
6ede7d73 DMSP |
1358 | |
1359 | OpenSSL can be configured to build in a build directory separate from the | |
1360 | source code directory. It's done by placing yourself in some other | |
1361 | directory and invoking the configuration commands from there. | |
1362 | ||
257e9d03 | 1363 | #### Unix example |
6ede7d73 DMSP |
1364 | |
1365 | $ mkdir /var/tmp/openssl-build | |
1366 | $ cd /var/tmp/openssl-build | |
a4ffb33e | 1367 | $ /PATH/TO/OPENSSL/SOURCE/Configure [options...] |
6ede7d73 | 1368 | |
257e9d03 | 1369 | #### OpenVMS example |
6ede7d73 DMSP |
1370 | |
1371 | $ set default sys$login: | |
1372 | $ create/dir [.tmp.openssl-build] | |
1373 | $ set default [.tmp.openssl-build] | |
a4ffb33e | 1374 | $ perl D:[PATH.TO.OPENSSL.SOURCE]Configure [options...] |
6ede7d73 | 1375 | |
257e9d03 | 1376 | #### Windows example |
6ede7d73 DMSP |
1377 | |
1378 | $ C: | |
1379 | $ mkdir \temp-openssl | |
1380 | $ cd \temp-openssl | |
a4ffb33e | 1381 | $ perl d:\PATH\TO\OPENSSL\SOURCE\Configure [options...] |
6ede7d73 | 1382 | |
9afbb681 | 1383 | Paths can be relative just as well as absolute. `Configure` will do its best |
6ede7d73 DMSP |
1384 | to translate them to relative paths whenever possible. |
1385 | ||
6ede7d73 DMSP |
1386 | Build OpenSSL |
1387 | ------------- | |
1388 | ||
1389 | Build OpenSSL by running: | |
1390 | ||
1391 | $ make # Unix | |
1392 | $ mms ! (or mmk) OpenVMS | |
1393 | $ nmake # Windows | |
1394 | ||
9afbb681 | 1395 | This will build the OpenSSL libraries (`libcrypto.a` and `libssl.a` on |
6ede7d73 | 1396 | Unix, corresponding on other platforms) and the OpenSSL binary |
9afbb681 DDO |
1397 | (`openssl`). The libraries will be built in the top-level directory, |
1398 | and the binary will be in the `apps/` subdirectory. | |
6ede7d73 DMSP |
1399 | |
1400 | If the build fails, take a look at the [Build Failures](#build-failures) | |
1401 | subsection of the [Troubleshooting](#troubleshooting) section. | |
1402 | ||
1403 | Test OpenSSL | |
1404 | ------------ | |
1405 | ||
1406 | After a successful build, and before installing, the libraries should | |
1407 | be tested. Run: | |
1408 | ||
1409 | $ make test # Unix | |
1410 | $ mms test ! OpenVMS | |
1411 | $ nmake test # Windows | |
1412 | ||
1413 | **Warning:** you MUST run the tests from an unprivileged account (or disable | |
1414 | your privileges temporarily if your platform allows it). | |
1415 | ||
036cbb6b DDO |
1416 | See [test/README.md](test/README.md) for further details how run tests. |
1417 | ||
1418 | See [test/README-dev.md](test/README-dev.md) for guidelines on adding tests. | |
6ede7d73 | 1419 | |
6ede7d73 DMSP |
1420 | Install OpenSSL |
1421 | --------------- | |
1422 | ||
1423 | If everything tests ok, install OpenSSL with | |
1424 | ||
1425 | $ make install # Unix | |
1426 | $ mms install ! OpenVMS | |
1427 | $ nmake install # Windows | |
1428 | ||
1429 | Note that in order to perform the install step above you need to have | |
1430 | appropriate permissions to write to the installation directory. | |
1431 | ||
1432 | The above commands will install all the software components in this | |
9afbb681 | 1433 | directory tree under `<PREFIX>` (the directory given with `--prefix` or |
6ede7d73 DMSP |
1434 | its default): |
1435 | ||
257e9d03 | 1436 | ### Unix / Linux / macOS |
6ede7d73 DMSP |
1437 | |
1438 | bin/ Contains the openssl binary and a few other | |
1439 | utility scripts. | |
1440 | include/openssl | |
1441 | Contains the header files needed if you want | |
1442 | to build your own programs that use libcrypto | |
1443 | or libssl. | |
1444 | lib Contains the OpenSSL library files. | |
1445 | lib/engines Contains the OpenSSL dynamically loadable engines. | |
1446 | ||
1447 | share/man/man1 Contains the OpenSSL command line man-pages. | |
1448 | share/man/man3 Contains the OpenSSL library calls man-pages. | |
1449 | share/man/man5 Contains the OpenSSL configuration format man-pages. | |
1450 | share/man/man7 Contains the OpenSSL other misc man-pages. | |
1451 | ||
1452 | share/doc/openssl/html/man1 | |
1453 | share/doc/openssl/html/man3 | |
1454 | share/doc/openssl/html/man5 | |
1455 | share/doc/openssl/html/man7 | |
1456 | Contains the HTML rendition of the man-pages. | |
1457 | ||
257e9d03 | 1458 | ### OpenVMS |
6ede7d73 | 1459 | |
d8c1cafb | 1460 | 'arch' is replaced with the architecture name, `ALPHA` or `IA64`, |
9afbb681 | 1461 | 'sover' is replaced with the shared library version (`0101` for 1.1), and |
6ede7d73 DMSP |
1462 | 'pz' is replaced with the pointer size OpenSSL was built with: |
1463 | ||
1464 | [.EXE.'arch'] Contains the openssl binary. | |
1465 | [.EXE] Contains a few utility scripts. | |
1466 | [.include.openssl] | |
1467 | Contains the header files needed if you want | |
1468 | to build your own programs that use libcrypto | |
1469 | or libssl. | |
1470 | [.LIB.'arch'] Contains the OpenSSL library files. | |
1471 | [.ENGINES'sover''pz'.'arch'] | |
1472 | Contains the OpenSSL dynamically loadable engines. | |
1473 | [.SYS$STARTUP] Contains startup, login and shutdown scripts. | |
1474 | These define appropriate logical names and | |
1475 | command symbols. | |
1476 | [.SYSTEST] Contains the installation verification procedure. | |
1477 | [.HTML] Contains the HTML rendition of the manual pages. | |
1478 | ||
257e9d03 | 1479 | ### Additional Directories |
6ede7d73 DMSP |
1480 | |
1481 | Additionally, install will add the following directories under | |
1482 | OPENSSLDIR (the directory given with `--openssldir` or its default) | |
1483 | for you convenience: | |
1484 | ||
1485 | certs Initially empty, this is the default location | |
1486 | for certificate files. | |
1487 | private Initially empty, this is the default location | |
1488 | for private key files. | |
1489 | misc Various scripts. | |
1490 | ||
1491 | The installation directory should be appropriately protected to ensure | |
1492 | unprivileged users cannot make changes to OpenSSL binaries or files, or | |
1493 | install engines. If you already have a pre-installed version of OpenSSL as | |
1494 | part of your Operating System it is recommended that you do not overwrite | |
1495 | the system version and instead install to somewhere else. | |
1496 | ||
1497 | Package builders who want to configure the library for standard locations, | |
1498 | but have the package installed somewhere else so that it can easily be | |
1499 | packaged, can use | |
1500 | ||
3a0b3cc9 DDO |
1501 | $ make DESTDIR=/tmp/package-root install # Unix |
1502 | $ mms/macro="DESTDIR=TMP:[PACKAGE-ROOT]" install ! OpenVMS | |
6ede7d73 DMSP |
1503 | |
1504 | The specified destination directory will be prepended to all installation | |
1505 | target paths. | |
1506 | ||
257e9d03 RS |
1507 | Compatibility issues with previous OpenSSL versions |
1508 | --------------------------------------------------- | |
6ede7d73 | 1509 | |
257e9d03 | 1510 | ### COMPILING existing applications |
6ede7d73 DMSP |
1511 | |
1512 | Starting with version 1.1.0, OpenSSL hides a number of structures that were | |
1513 | previously open. This includes all internal libssl structures and a number | |
1514 | of EVP types. Accessor functions have been added to allow controlled access | |
1515 | to the structures' data. | |
1516 | ||
1517 | This means that some software needs to be rewritten to adapt to the new ways | |
1518 | of doing things. This often amounts to allocating an instance of a structure | |
1519 | explicitly where you could previously allocate them on the stack as automatic | |
1520 | variables, and using the provided accessor functions where you would previously | |
1521 | access a structure's field directly. | |
1522 | ||
1523 | Some APIs have changed as well. However, older APIs have been preserved when | |
1524 | possible. | |
1525 | ||
41149648 RL |
1526 | Post-installation Notes |
1527 | ----------------------- | |
1528 | ||
1529 | With the default OpenSSL installation comes a FIPS provider module, which | |
1530 | needs some post-installation attention, without which it will not be usable. | |
1531 | This involves using the following command: | |
1532 | ||
270540fd | 1533 | $ openssl fipsinstall |
41149648 RL |
1534 | |
1535 | See the openssl-fipsinstall(1) manual for details and examples. | |
1536 | ||
6ede7d73 DMSP |
1537 | Advanced Build Options |
1538 | ====================== | |
1539 | ||
6ede7d73 DMSP |
1540 | Environment Variables |
1541 | --------------------- | |
1542 | ||
1543 | A number of environment variables can be used to provide additional control | |
1544 | over the build process. Typically these should be defined prior to running | |
9afbb681 | 1545 | `Configure`. Not all environment variables are relevant to all platforms. |
6ede7d73 DMSP |
1546 | |
1547 | AR | |
1548 | The name of the ar executable to use. | |
1549 | ||
1550 | BUILDFILE | |
1551 | Use a different build file name than the platform default | |
1552 | ("Makefile" on Unix-like platforms, "makefile" on native Windows, | |
1553 | "descrip.mms" on OpenVMS). This requires that there is a | |
036cbb6b DDO |
1554 | corresponding build file template. |
1555 | See [Configurations/README.md](Configurations/README.md) | |
6ede7d73 DMSP |
1556 | for further information. |
1557 | ||
1558 | CC | |
1559 | The compiler to use. Configure will attempt to pick a default | |
1560 | compiler for your platform but this choice can be overridden | |
1561 | using this variable. Set it to the compiler executable you wish | |
9afbb681 | 1562 | to use, e.g. gcc or clang. |
6ede7d73 DMSP |
1563 | |
1564 | CROSS_COMPILE | |
1565 | This environment variable has the same meaning as for the | |
1566 | "--cross-compile-prefix" Configure flag described above. If both | |
1567 | are set then the Configure flag takes precedence. | |
1568 | ||
92115096 RS |
1569 | HASHBANGPERL |
1570 | The command string for the Perl executable to insert in the | |
1571 | #! line of perl scripts that will be publicly installed. | |
1572 | Default: /usr/bin/env perl | |
1573 | Note: the value of this variable is added to the same scripts | |
1574 | on all platforms, but it's only relevant on Unix-like platforms. | |
1575 | ||
1576 | KERNEL_BITS | |
1577 | This can be the value `32` or `64` to specify the architecture | |
1578 | when it is not "obvious" to the configuration. It should generally | |
1579 | not be necessary to specify this environment variable. | |
1580 | ||
6ede7d73 DMSP |
1581 | NM |
1582 | The name of the nm executable to use. | |
1583 | ||
1584 | OPENSSL_LOCAL_CONFIG_DIR | |
1585 | OpenSSL comes with a database of information about how it | |
1586 | should be built on different platforms as well as build file | |
1587 | templates for those platforms. The database is comprised of | |
1588 | ".conf" files in the Configurations directory. The build | |
1589 | file templates reside there as well as ".tmpl" files. See the | |
036cbb6b DDO |
1590 | file [Configurations/README.md](Configurations/README.md) |
1591 | for further information about the format of ".conf" files | |
1592 | as well as information on the ".tmpl" files. | |
6ede7d73 | 1593 | In addition to the standard ".conf" and ".tmpl" files, it is |
036cbb6b DDO |
1594 | possible to create your own ".conf" and ".tmpl" files and |
1595 | store them locally, outside the OpenSSL source tree. | |
1596 | This environment variable can be set to the directory where | |
1597 | these files are held and will be considered by Configure | |
1598 | before it looks in the standard directories. | |
6ede7d73 DMSP |
1599 | |
1600 | PERL | |
1601 | The name of the Perl executable to use when building OpenSSL. | |
eb4129e1 | 1602 | Only needed if building should use a different Perl executable |
16b0e0fc | 1603 | than what is used to run the Configure script. |
6ede7d73 | 1604 | |
92115096 RS |
1605 | RANLIB |
1606 | The name of the ranlib executable to use. | |
6ede7d73 DMSP |
1607 | |
1608 | RC | |
1609 | The name of the rc executable to use. The default will be as | |
1610 | defined for the target platform in the ".conf" file. If not | |
1611 | defined then "windres" will be used. The WINDRES environment | |
1612 | variable is synonymous to this. If both are defined then RC | |
1613 | takes precedence. | |
1614 | ||
6ede7d73 DMSP |
1615 | WINDRES |
1616 | See RC. | |
1617 | ||
6ede7d73 DMSP |
1618 | Makefile Targets |
1619 | ---------------- | |
1620 | ||
9afbb681 | 1621 | The `Configure` script generates a Makefile in a format relevant to the specific |
6ede7d73 DMSP |
1622 | platform. The Makefiles provide a number of targets that can be used. Not all |
1623 | targets may be available on all platforms. Only the most common targets are | |
1624 | described here. Examine the Makefiles themselves for the full list. | |
1625 | ||
1626 | all | |
1627 | The target to build all the software components and | |
1628 | documentation. | |
1629 | ||
1630 | build_sw | |
1631 | Build all the software components. | |
1632 | THIS IS THE DEFAULT TARGET. | |
1633 | ||
1634 | build_docs | |
1635 | Build all documentation components. | |
1636 | ||
1637 | clean | |
1638 | Remove all build artefacts and return the directory to a "clean" | |
1639 | state. | |
1640 | ||
1641 | depend | |
1642 | Rebuild the dependencies in the Makefiles. This is a legacy | |
1643 | option that no longer needs to be used since OpenSSL 1.1.0. | |
1644 | ||
1645 | install | |
1646 | Install all OpenSSL components. | |
1647 | ||
1648 | install_sw | |
1649 | Only install the OpenSSL software components. | |
1650 | ||
1651 | install_docs | |
1652 | Only install the OpenSSL documentation components. | |
1653 | ||
1654 | install_man_docs | |
1655 | Only install the OpenSSL man pages (Unix only). | |
1656 | ||
1657 | install_html_docs | |
8c1cbc72 | 1658 | Only install the OpenSSL HTML documentation. |
cad80959 | 1659 | |
b19b9830 RL |
1660 | install_fips |
1661 | Install the FIPS provider module configuration file. | |
6ede7d73 DMSP |
1662 | |
1663 | list-tests | |
1664 | Prints a list of all the self test names. | |
1665 | ||
1666 | test | |
1667 | Build and run the OpenSSL self tests. | |
1668 | ||
1669 | uninstall | |
1670 | Uninstall all OpenSSL components. | |
1671 | ||
1672 | reconfigure | |
1673 | reconf | |
1674 | Re-run the configuration process, as exactly as the last time | |
1675 | as possible. | |
1676 | ||
1677 | update | |
1678 | This is a developer option. If you are developing a patch for | |
1679 | OpenSSL you may need to use this if you want to update | |
1680 | automatically generated files; add new error codes or add new | |
1681 | (or change the visibility of) public API functions. (Unix only). | |
1682 | ||
1683 | Running Selected Tests | |
1684 | ---------------------- | |
1685 | ||
3a0b3cc9 DDO |
1686 | You can specify a set of tests to be performed |
1687 | using the `make` variable `TESTS`. | |
6ede7d73 | 1688 | |
3a0b3cc9 DDO |
1689 | See the section [Running Selected Tests of |
1690 | test/README.md](test/README.md#running-selected-tests). | |
6ede7d73 DMSP |
1691 | |
1692 | Troubleshooting | |
1693 | =============== | |
1694 | ||
1695 | Configuration Problems | |
1696 | ---------------------- | |
1697 | ||
257e9d03 | 1698 | ### Selecting the correct target |
6ede7d73 | 1699 | |
16b0e0fc | 1700 | The `./Configure` script tries hard to guess your operating system, but in some |
6ede7d73 DMSP |
1701 | cases it does not succeed. You will see a message like the following: |
1702 | ||
16b0e0fc | 1703 | $ ./Configure |
6ede7d73 | 1704 | Operating system: x86-whatever-minix |
1dc1ea18 | 1705 | This system (minix) is not supported. See file INSTALL.md for details. |
6ede7d73 | 1706 | |
9afbb681 DDO |
1707 | Even if the automatic target selection by the `./Configure` script fails, |
1708 | chances are that you still might find a suitable target in the `Configurations` | |
1709 | directory, which you can supply to the `./Configure` command, | |
1710 | possibly after some adjustment. | |
6ede7d73 | 1711 | |
9afbb681 | 1712 | The `Configurations/` directory contains a lot of examples of such targets. |
6c8149df | 1713 | The main configuration file is [10-main.conf], which contains all targets that |
6ede7d73 DMSP |
1714 | are officially supported by the OpenSSL team. Other configuration files contain |
1715 | targets contributed by other OpenSSL users. The list of targets can be found in | |
1716 | a Perl list `my %targets = ( ... )`. | |
1717 | ||
1718 | my %targets = ( | |
1719 | ... | |
1720 | "target-name" => { | |
1721 | inherit_from => [ "base-target" ], | |
1722 | CC => "...", | |
1723 | cflags => add("..."), | |
1724 | asm_arch => '...', | |
1725 | perlasm_scheme => "...", | |
1726 | }, | |
1727 | ... | |
1728 | ) | |
1729 | ||
16b0e0fc | 1730 | If you call `./Configure` without arguments, it will give you a list of all |
6ede7d73 | 1731 | known targets. Using `grep`, you can lookup the target definition in the |
9afbb681 DDO |
1732 | `Configurations/` directory. For example the `android-x86_64` can be found in |
1733 | [Configurations/15-android.conf](Configurations/15-android.conf). | |
6ede7d73 DMSP |
1734 | |
1735 | The directory contains two README files, which explain the general syntax and | |
9afbb681 | 1736 | design of the configuration files. |
6ede7d73 | 1737 | |
036cbb6b DDO |
1738 | - [Configurations/README.md](Configurations/README.md) |
1739 | - [Configurations/README-design.md](Configurations/README-design.md) | |
6ede7d73 | 1740 | |
6c8149df DMSP |
1741 | If you need further help, try to search the [openssl-users] mailing list |
1742 | or the [GitHub Issues] for existing solutions. If you don't find anything, | |
1743 | you can [raise an issue] to ask a question yourself. | |
6ede7d73 | 1744 | |
6c8149df | 1745 | More about our support resources can be found in the [SUPPORT] file. |
6ede7d73 | 1746 | |
257e9d03 | 1747 | ### Configuration Errors |
6ede7d73 | 1748 | |
16b0e0fc | 1749 | If the `./Configure` or `./Configure` command fails with an error message, |
6ede7d73 DMSP |
1750 | read the error message carefully and try to figure out whether you made |
1751 | a mistake (e.g., by providing a wrong option), or whether the script is | |
1752 | working incorrectly. If you think you encountered a bug, please | |
6c8149df | 1753 | [raise an issue] on GitHub to file a bug report. |
6ede7d73 DMSP |
1754 | |
1755 | Along with a short description of the bug, please provide the complete | |
1756 | configure command line and the relevant output including the error message. | |
1757 | ||
e304aa87 | 1758 | Note: To make the output readable, please add a 'code fence' (three backquotes |
6ede7d73 DMSP |
1759 | ` ``` ` on a separate line) before and after your output: |
1760 | ||
1761 | ``` | |
b0d5c1cb | 1762 | ./Configure [your arguments...] |
6ede7d73 DMSP |
1763 | |
1764 | [output...] | |
1765 | ||
1766 | ``` | |
1767 | ||
6ede7d73 DMSP |
1768 | Build Failures |
1769 | -------------- | |
1770 | ||
1771 | If the build fails, look carefully at the output. Try to locate and understand | |
1772 | the error message. It might be that the compiler is already telling you | |
1773 | exactly what you need to do to fix your problem. | |
1774 | ||
1775 | There may be reasons for the failure that aren't problems in OpenSSL itself, | |
1776 | for example if the compiler reports missing standard or third party headers. | |
1777 | ||
1778 | If the build succeeded previously, but fails after a source or configuration | |
1779 | change, it might be helpful to clean the build tree before attempting another | |
1780 | build. Use this command: | |
1781 | ||
270540fd RL |
1782 | $ make clean # Unix |
1783 | $ mms clean ! (or mmk) OpenVMS | |
1784 | $ nmake clean # Windows | |
6ede7d73 | 1785 | |
203c18f1 AM |
1786 | Assembler error messages can sometimes be sidestepped by using the `no-asm` |
1787 | configuration option. See also [notes](#notes-on-assembler-modules-compilation). | |
6ede7d73 DMSP |
1788 | |
1789 | Compiling parts of OpenSSL with gcc and others with the system compiler will | |
1790 | result in unresolved symbols on some systems. | |
1791 | ||
6c8149df DMSP |
1792 | If you are still having problems, try to search the [openssl-users] mailing |
1793 | list or the [GitHub Issues] for existing solutions. If you think you | |
1794 | encountered an OpenSSL bug, please [raise an issue] to file a bug report. | |
6ede7d73 DMSP |
1795 | Please take the time to review the existing issues first; maybe the bug was |
1796 | already reported or has already been fixed. | |
1797 | ||
6ede7d73 DMSP |
1798 | Test Failures |
1799 | ------------- | |
1800 | ||
1801 | If some tests fail, look at the output. There may be reasons for the failure | |
b0d5c1cb | 1802 | that isn't a problem in OpenSSL itself (like an OS malfunction or a Perl issue). |
6ede7d73 | 1803 | |
3a0b3cc9 DDO |
1804 | You may want increased verbosity, that can be accomplished as described in |
1805 | section [Test Failures of test/README.md](test/README.md#test-failures). | |
6ede7d73 | 1806 | |
e4522e10 DDO |
1807 | You may also want to selectively specify which test(s) to perform. This can be |
1808 | done using the `make` variable `TESTS` as described in section [Running | |
1809 | Selected Tests of test/README.md](test/README.md#running-selected-tests). | |
6ede7d73 DMSP |
1810 | |
1811 | If you find a problem with OpenSSL itself, try removing any | |
3a0b3cc9 DDO |
1812 | compiler optimization flags from the `CFLAGS` line in the Makefile and |
1813 | run `make clean; make` or corresponding. | |
6ede7d73 DMSP |
1814 | |
1815 | To report a bug please open an issue on GitHub, at | |
257e9d03 | 1816 | <https://github.com/openssl/openssl/issues>. |
6ede7d73 | 1817 | |
6ede7d73 DMSP |
1818 | Notes |
1819 | ===== | |
1820 | ||
1821 | Notes on multi-threading | |
1822 | ------------------------ | |
1823 | ||
9afbb681 | 1824 | For some systems, the OpenSSL `Configure` script knows what compiler options |
6ede7d73 DMSP |
1825 | are needed to generate a library that is suitable for multi-threaded |
1826 | applications. On these systems, support for multi-threading is enabled | |
9afbb681 | 1827 | by default; use the `no-threads` option to disable (this should never be |
6ede7d73 DMSP |
1828 | necessary). |
1829 | ||
1830 | On other systems, to enable support for multi-threading, you will have | |
9afbb681 DDO |
1831 | to specify at least two options: `threads`, and a system-dependent option. |
1832 | (The latter is `-D_REENTRANT` on various systems.) The default in this | |
6ede7d73 | 1833 | case, obviously, is not to include support for multi-threading (but |
9afbb681 DDO |
1834 | you can still use `no-threads` to suppress an annoying warning message |
1835 | from the `Configure` script.) | |
6ede7d73 DMSP |
1836 | |
1837 | OpenSSL provides built-in support for two threading models: pthreads (found on | |
1838 | most UNIX/Linux systems), and Windows threads. No other threading models are | |
1839 | supported. If your platform does not provide pthreads or Windows threads then | |
9afbb681 | 1840 | you should use `Configure` with the `no-threads` option. |
6ede7d73 | 1841 | |
3d8905f8 RS |
1842 | For pthreads, all locks are non-recursive. In addition, in a debug build, |
1843 | the mutex attribute `PTHREAD_MUTEX_ERRORCHECK` is used. If this is not | |
1844 | available on your platform, you might have to add | |
1845 | `-DOPENSSL_NO_MUTEX_ERRORCHECK` to your `Configure` invocation. | |
1846 | (On Linux `PTHREAD_MUTEX_ERRORCHECK` is an enum value, so a built-in | |
1847 | ifdef test cannot be used.) | |
1848 | ||
6ede7d73 DMSP |
1849 | Notes on shared libraries |
1850 | ------------------------- | |
1851 | ||
9afbb681 | 1852 | For most systems the OpenSSL `Configure` script knows what is needed to |
6ede7d73 DMSP |
1853 | build shared libraries for libcrypto and libssl. On these systems |
1854 | the shared libraries will be created by default. This can be suppressed and | |
9afbb681 DDO |
1855 | only static libraries created by using the `no-shared` option. On systems |
1856 | where OpenSSL does not know how to build shared libraries the `no-shared` | |
6ede7d73 DMSP |
1857 | option will be forced and only static libraries will be created. |
1858 | ||
1859 | Shared libraries are named a little differently on different platforms. | |
1860 | One way or another, they all have the major OpenSSL version number as | |
9afbb681 | 1861 | part of the file name, i.e. for OpenSSL 1.1.x, `1.1` is somehow part of |
6ede7d73 DMSP |
1862 | the name. |
1863 | ||
9afbb681 DDO |
1864 | On most POSIX platforms, shared libraries are named `libcrypto.so.1.1` |
1865 | and `libssl.so.1.1`. | |
6ede7d73 | 1866 | |
9afbb681 DDO |
1867 | on Cygwin, shared libraries are named `cygcrypto-1.1.dll` and `cygssl-1.1.dll` |
1868 | with import libraries `libcrypto.dll.a` and `libssl.dll.a`. | |
6ede7d73 DMSP |
1869 | |
1870 | On Windows build with MSVC or using MingW, shared libraries are named | |
9afbb681 DDO |
1871 | `libcrypto-1_1.dll` and `libssl-1_1.dll` for 32-bit Windows, |
1872 | `libcrypto-1_1-x64.dll` and `libssl-1_1-x64.dll` for 64-bit x86_64 Windows, | |
1873 | and `libcrypto-1_1-ia64.dll` and `libssl-1_1-ia64.dll` for IA64 Windows. | |
1874 | With MSVC, the import libraries are named `libcrypto.lib` and `libssl.lib`, | |
1875 | while with MingW, they are named `libcrypto.dll.a` and `libssl.dll.a`. | |
6ede7d73 DMSP |
1876 | |
1877 | On VMS, shareable images (VMS speak for shared libraries) are named | |
9afbb681 | 1878 | `ossl$libcrypto0101_shr.exe` and `ossl$libssl0101_shr.exe`. However, when |
6ede7d73 | 1879 | OpenSSL is specifically built for 32-bit pointers, the shareable images |
9afbb681 | 1880 | are named `ossl$libcrypto0101_shr32.exe` and `ossl$libssl0101_shr32.exe` |
6ede7d73 | 1881 | instead, and when built for 64-bit pointers, they are named |
9afbb681 | 1882 | `ossl$libcrypto0101_shr64.exe` and `ossl$libssl0101_shr64.exe`. |
6ede7d73 DMSP |
1883 | |
1884 | Notes on random number generation | |
1885 | --------------------------------- | |
1886 | ||
1887 | Availability of cryptographically secure random numbers is required for | |
1888 | secret key generation. OpenSSL provides several options to seed the | |
1889 | internal CSPRNG. If not properly seeded, the internal CSPRNG will refuse | |
1890 | to deliver random bytes and a "PRNG not seeded error" will occur. | |
1891 | ||
1892 | The seeding method can be configured using the `--with-rand-seed` option, | |
1893 | which can be used to specify a comma separated list of seed methods. | |
8c1cbc72 | 1894 | However, in most cases OpenSSL will choose a suitable default method, |
6ede7d73 | 1895 | so it is not necessary to explicitly provide this option. Note also |
b99c463d P |
1896 | that not all methods are available on all platforms. The FIPS provider will |
1897 | silently ignore seed sources that were not validated. | |
6ede7d73 DMSP |
1898 | |
1899 | I) On operating systems which provide a suitable randomness source (in | |
1900 | form of a system call or system device), OpenSSL will use the optimal | |
1901 | available method to seed the CSPRNG from the operating system's | |
1902 | randomness sources. This corresponds to the option `--with-rand-seed=os`. | |
1903 | ||
1904 | II) On systems without such a suitable randomness source, automatic seeding | |
9afbb681 | 1905 | and reseeding is disabled (`--with-rand-seed=none`) and it may be necessary |
6ede7d73 | 1906 | to install additional support software to obtain a random seed and reseed |
9afbb681 DDO |
1907 | the CSPRNG manually. Please check out the manual pages for `RAND_add()`, |
1908 | `RAND_bytes()`, `RAND_egd()`, and the FAQ for more information. | |
6ede7d73 | 1909 | |
203c18f1 AM |
1910 | Notes on assembler modules compilation |
1911 | -------------------------------------- | |
1912 | ||
1913 | Compilation of some code paths in assembler modules might depend on whether the | |
1914 | current assembler version supports certain ISA extensions or not. Code paths | |
1915 | that use the AES-NI, PCLMULQDQ, SSSE3, and SHA extensions are always assembled. | |
1916 | Apart from that, the minimum requirements for the assembler versions are shown | |
1917 | in the table below: | |
1918 | ||
1919 | | ISA extension | GNU as | nasm | llvm | | |
1920 | |---------------|--------|--------|---------| | |
1921 | | AVX | 2.19 | 2.09 | 3.0 | | |
1922 | | AVX2 | 2.22 | 2.10 | 3.1 | | |
1923 | | ADCX/ADOX | 2.23 | 2.10 | 3.3 | | |
1924 | | AVX512 | 2.25 | 2.11.8 | 3.6 (*) | | |
1925 | | AVX512IFMA | 2.26 | 2.11.8 | 6.0 (*) | | |
1926 | | VAES | 2.30 | 2.13.3 | 6.0 (*) | | |
1927 | ||
1928 | --- | |
1929 | ||
1930 | (*) Even though AVX512 support was implemented in llvm 3.6, prior to version 7.0 | |
1931 | an explicit -march flag was apparently required to compile assembly modules. But | |
1932 | then the compiler generates processor-specific code, which in turn contradicts | |
1933 | the idea of performing dispatch at run-time, which is facilitated by the special | |
1934 | variable `OPENSSL_ia32cap`. For versions older than 7.0, it is possible to work | |
1935 | around the problem by forcing the build procedure to use the following script: | |
1936 | ||
1937 | #!/bin/sh | |
1938 | exec clang -no-integrated-as "$@" | |
1939 | ||
1940 | instead of the real clang. In which case it doesn't matter what clang version | |
1941 | is used, as it is the version of the GNU assembler that will be checked. | |
1942 | ||
1943 | --- | |
1944 | ||
6ede7d73 DMSP |
1945 | <!-- Links --> |
1946 | ||
1947 | [openssl-users]: | |
257e9d03 | 1948 | <https://mta.openssl.org/mailman/listinfo/openssl-users> |
6ede7d73 DMSP |
1949 | |
1950 | [SUPPORT]: | |
1951 | ./SUPPORT.md | |
1952 | ||
1953 | [GitHub Issues]: | |
257e9d03 | 1954 | <https://github.com/openssl/openssl/issues> |
6ede7d73 DMSP |
1955 | |
1956 | [raise an issue]: | |
257e9d03 | 1957 | <https://github.com/openssl/openssl/issues/new/choose> |
6ede7d73 DMSP |
1958 | |
1959 | [10-main.conf]: | |
1960 | Configurations/10-main.conf |