From: Shigeki Ohtsu <ohtsu@ohtsu.org>
Date: Sat, 10 Nov 2018 01:54:00 +0000 (+0900)
Subject: doc: fix assembler requirement for OpenSSL-1.1.1
X-Git-Tag: archive/raspbian/10.15.2_dfsg-2+rpi1^2~10
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=6c61cf21d15df775ab2a798e6f5d4de0092fac03;p=nodejs.git

doc: fix assembler requirement for OpenSSL-1.1.1

Add new requirements of assembler version for AVX-512 support
in OpenSSL-1.1.1.

Gbp-Pq: Topic ssl
Gbp-Pq: Name 5703c7f9a657b361e8ea5f8b6eb1174fe5598a64.patch
---

diff --git a/BUILDING.md b/BUILDING.md
index 36d87c0f1..c302802d9 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -129,20 +129,29 @@ Depending on the host platform, the selection of toolchains may vary.
 
 #### 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.
 
+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
 * Xcode version 5.0 or higher
 * llvm version 3.3 or higher
 * nasm version 2.10 or higher in Windows
 
-If compiling without one of the above, use `configure` with the
-`--openssl-no-asm` flag. Otherwise, `configure` will fail.
-
-The forthcoming OpenSSL-1.1.1 will have different requirements. Please refer to
+Please refer to
  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
 
 The [bootstrapping guide](https://github.com/nodejs/node/blob/master/tools/bootstrap/README.md)