summaryrefslogtreecommitdiff
path: root/BUILDING.md
diff options
context:
space:
mode:
authorShigeki Ohtsu <ohtsu@ohtsu.org>2018-03-07 22:31:05 +0900
committerShigeki Ohtsu <ohtsu@ohtsu.org>2018-04-10 06:45:45 +0900
commit08af7dba2aa7ea49858d0f05c68fd21cdadf4c15 (patch)
tree0532d2d842912ca468287b2e22c1293020208bab /BUILDING.md
parent7812ec735ba50493c417a4860aa491fcee67d149 (diff)
downloadandroid-node-v8-08af7dba2aa7ea49858d0f05c68fd21cdadf4c15.tar.gz
android-node-v8-08af7dba2aa7ea49858d0f05c68fd21cdadf4c15.tar.bz2
android-node-v8-08af7dba2aa7ea49858d0f05c68fd21cdadf4c15.zip
build: add OpenSSL-1.1.0 support
- For Windows, nasm is new build requirements and openssl_no_asm is set to 1 with warning if it is not installed. - For use of openssl assemble codes, either gas_version >= 2.23, xcode_version >= 5.0 ,llvm_version >= 3.3 or nasm_version >= 2.10 is needed. Otherwise, openssl_no_asm is set to 1 with warning. - FIPS is not supported in OpenSSL-1.1.0 so that it leads an error when openssl_fips options is enabled in configure. Fixes: https://github.com/nodejs/node/issues/4270 PR-URL: https://github.com/nodejs/node/pull/19794 Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Rod Vagg <rod@vagg.org> Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>
Diffstat (limited to 'BUILDING.md')
-rw-r--r--BUILDING.md56
1 files changed, 18 insertions, 38 deletions
diff --git a/BUILDING.md b/BUILDING.md
index e3bd7a7e9d..19b227af40 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -88,6 +88,23 @@ Depending on host platform, the selection of toolchains may vary.
* Visual Studio 2017 or the Build Tools thereof
+#### OpenSSL asm support
+
+OpenSSL-1.1.0 requires the following asssembler version for use of asm
+support.
+
+* 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
+
+Otherwise, `--openssl-no-asm` is added with warning in configure.
+
+*Note:* The forthcoming OpenSSL-1.1.1 will require higher
+ version. Please refer
+ https://www.openssl.org/docs/man1.1.1/man3/OPENSSL_ia32cap.html for
+ details.
+
## Building Node.js on supported platforms
*Note:* All prerequisites can be easily installed by following
@@ -377,44 +394,7 @@ as `deps/icu` (You'll have: `deps/icu/source/...`)
## Building Node.js with FIPS-compliant OpenSSL
-It is possible to build Node.js with the
-[OpenSSL FIPS module](https://www.openssl.org/docs/fipsnotes.html) on POSIX
-systems. Windows is not supported.
-
-Building in this way does not mean the runtime is FIPS 140-2 validated, but
-rather that the runtime uses a validated module. In addition, the validation for
-the underlying module is only valid if it is deployed in accordance with its
-[security policy](http://csrc.nist.gov/groups/STM/cmvp/documents/140-1/140sp/140sp1747.pdf).
-If you need FIPS validated cryptography it is recommended that you read both
-the [security policy](http://csrc.nist.gov/groups/STM/cmvp/documents/140-1/140sp/140sp1747.pdf)
-and [user guide](https://openssl.org/docs/fips/UserGuide-2.0.pdf).
-
-### Instructions
-
-1. Obtain a copy of openssl-fips-x.x.x.tar.gz.
- To comply with the security policy you must ensure the path
- through which you get the file complies with the requirements
- for a "secure installation" as described in section 6.6 in
- the [user guide](https://openssl.org/docs/fips/UserGuide-2.0.pdf).
- For evaluation/experimentation, you can simply download and verify
- `openssl-fips-x.x.x.tar.gz` from https://www.openssl.org/source/
-2. Extract source to `openssl-fips` folder and `cd openssl-fips`
-3. `./config`
-4. `make`
-5. `make install`
- (NOTE: to comply with the security policy you must use the exact
- commands in steps 3-5 without any additional options as per
- Appendix A in the [security policy](http://csrc.nist.gov/groups/STM/cmvp/documents/140-1/140sp/140sp1747.pdf).
- The only exception is that `./config no-asm` can be
- used in place of `./config`, and the FIPSDIR environment variable
- may be used to specify a non-standard install folder for the
- validated module, as per User Guide sections 4.2.1, 4.2.2, and 4.2.3.
-6. Get into Node.js checkout folder
-7. `./configure --openssl-fips=/path/to/openssl-fips/installdir`
- For example on ubuntu 12 the installation directory was
- `/usr/local/ssl/fips-2.0`
-8. Build Node.js with `make -j`
-9. Verify with `node -p "process.versions.openssl"` (for example `1.0.2a-fips`)
+This version of Node.js does not support FIPS.
## Building Node.js with external core modules