Skip to content

Commit

Permalink
doc: fix assembler requirement for OpenSSL-1.1.1
Browse files Browse the repository at this point in the history
Add new requirements of assembler version for AVX-512 support
in OpenSSL-1.1.1.

PR-URL: #25381
Reviewed-By: Daniel Bevenius <daniel.bevenius@gmail.com>
Reviewed-By: Shigeki Ohtsu <ohtsu@ohtsu.org>
Backport-PR-URL: #25688
  • Loading branch information
shigeki authored and targos committed Jan 28, 2019
1 parent 5225214 commit 5d5c528
Showing 1 changed file with 14 additions and 5 deletions.
19 changes: 14 additions & 5 deletions BUILDING.md
Expand Up @@ -130,20 +130,29 @@ Depending on the host platform, the selection of toolchains may vary.


#### OpenSSL asm support #### OpenSSL asm support


OpenSSL-1.1.0 requires the following assembler version for use of asm OpenSSL-1.1.1 requires the following assembler version for use of asm
support on x86_64 and ia32. support on x86_64 and ia32.


For use of AVX-512,

* gas (GNU assembler) version 2.26 or higher
* nasm version 2.11.8 or higher in Windows

Note that AVX-512 is disabled for Skylake-X by OpenSSL-1.1.1.

For use of AVX2,

* gas (GNU assembler) version 2.23 or higher * gas (GNU assembler) version 2.23 or higher
* Xcode version 5.0 or higher * Xcode version 5.0 or higher
* llvm version 3.3 or higher * llvm version 3.3 or higher
* nasm version 2.10 or higher in Windows * nasm version 2.10 or higher in Windows


If compiling without one of the above, use `configure` with the Please refer to
`--openssl-no-asm` flag. Otherwise, `configure` will fail.

The forthcoming OpenSSL-1.1.1 will have different requirements. Please refer to
https://www.openssl.org/docs/man1.1.1/man3/OPENSSL_ia32cap.html for details. https://www.openssl.org/docs/man1.1.1/man3/OPENSSL_ia32cap.html for details.


If compiling without one of the above, use `configure` with the
`--openssl-no-asm` flag. Otherwise, `configure` will fail.

## Building Node.js on supported platforms ## Building Node.js on supported platforms


The [bootstrapping guide](https://github.com/nodejs/node/blob/master/tools/bootstrap/README.md) The [bootstrapping guide](https://github.com/nodejs/node/blob/master/tools/bootstrap/README.md)
Expand Down

0 comments on commit 5d5c528

Please sign in to comment.