-
Notifications
You must be signed in to change notification settings - Fork 29.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
deps: update OpenSSL upgrade process
Particularly, ensure that the commit messages are self-explanatory so that reviewers can understand that the large commits are the result of a simple repeatable process. This should make them easier to review. See: #26327 (comment) Backport-PR-URL: #27419 PR-URL: #26378 Reviewed-By: Michael Dawson <[email protected]> Reviewed-By: Richard Lau <[email protected]>
- Loading branch information
1 parent
16478de
commit a8ad994
Showing
1 changed file
with
49 additions
and
23 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,4 @@ | ||
| ## Upgrading OpenSSL-1.1.0 | ||
| ## Upgrading OpenSSL | ||
|
|
||
| ### Requirements | ||
| - Linux environment (Only CentOS7.1 and Ubuntu16 are tested) | ||
|
|
@@ -22,12 +22,12 @@ Copyright (C) 2015 Free Software Foundation, Inc. | |
| $ nasm -v | ||
| NASM version 2.11.08 | ||
| ``` | ||
|
|
||
| ### 1. Obtain and extract new OpenSSL sources | ||
|
|
||
| Get a new source from https://www.openssl.org/source/ and extract | ||
| all files into `deps/openssl/openssl`. Then add all files and commit | ||
| them. | ||
|
|
||
| ```sh | ||
| $ cd deps/openssl/ | ||
| $ rm -rf openssl | ||
|
|
@@ -36,36 +36,58 @@ $ mv openssl-1.1.0h openssl | |
| $ git add --all openssl | ||
| $ git commit openssl | ||
| ```` | ||
| The commit message can be | ||
|
|
||
| The commit message can be (with the openssl version set to the relevant value): | ||
| ``` | ||
| deps: upgrade openssl sources to 1.1.0h | ||
|
|
||
| This updates all sources in deps/openssl/openssl with openssl-1.1.0h. | ||
| This updates all sources in deps/openssl/openssl by: | ||
| $ cd deps/openssl/ | ||
| $ rm -rf openssl | ||
| $ tar zxf ~/tmp/openssl-1.1.0h.tar.gz | ||
| $ mv openssl-1.1.0h openssl | ||
| $ git add --all openssl | ||
| $ git commit openssl | ||
| ``` | ||
| ### 2. Apply a floating patch | ||
| Currently, one floating patch is needed to build S390 asm files. | ||
| Currently, one floating patch is needed to build S390 asm files: | ||
| ``` | ||
| commit 094465362758ebf967b33c84d5c96230b46a34b3 | ||
| Author: Shigeki Ohtsu <[email protected]> | ||
| Date: Wed Mar 7 23:52:52 2018 +0900 | ||
| Author: Shigeki Ohtsu <[email protected]> | ||
| Date: Wed Mar 7 23:52:52 2018 +0900 | ||
|
|
||
| deps: add s390 asm rules for OpenSSL-1.1.0 | ||
|
|
||
| deps: add s390 asm rules for OpenSSL-1.1.0 | ||
| This is a floating patch against OpenSSL-1.1.0 to generate asm files | ||
| with Makefile rules and it is to be submitted to the upstream. | ||
|
|
||
| This is a floating patch against OpenSSL-1.1.0 to generate asm files | ||
| with Makefile rules and it is to be submitted to the upstream. | ||
| Fixes: https://github.com/nodejs/node/issues/4270 | ||
| PR-URL: https://github.com/nodejs/node/pull/19794 | ||
| Reviewed-By: James M Snell <[email protected]> | ||
| Reviewed-By: Rod Vagg <[email protected]> | ||
| Reviewed-By: Michael Dawson <[email protected]> | ||
|
|
||
| deps/openssl/openssl/crypto/poly1305/build.info | 2 ++ | ||
| ``` | ||
| Cherry pick it from the previous commit. | ||
| Find the SHA of the previous commit of this patch: | ||
| ```sh | ||
| $ git log -n1 --oneline -- deps/openssl/openssl/crypto/poly1305/build.info | ||
| ``` | ||
|
|
||
| Using the SHA found in the previous step, cherry pick it from the previous | ||
| commit (with the openssl version in the commit message set to the relevant | ||
| value): | ||
| ```sh | ||
| $ git cherry-pick 45b9f5df6ff1548f01ed646ebee75e3f0873cefd | ||
| ``` | ||
| ### 3. Execute `make` in `deps/openssl/config` directory | ||
|
|
||
| Just type `make` then it generates all platform dependent files into | ||
| `deps/openssl/config/archs` directory. | ||
|
|
||
| ### 3. Execute `make` in `deps/openssl/config` directory | ||
|
|
||
| Use `make` to regenerate all platform dependent files in | ||
| `deps/openssl/config/archs/`: | ||
| ```sh | ||
| $ cd deps/openssl/config; make | ||
| ``` | ||
|
|
@@ -100,15 +122,19 @@ $ git add deps/openssl/openssl/.gitignore | |
| $ git commit | ||
| ``` | ||
|
|
||
| The commit message can be | ||
| The commit message can be (with the openssl version set to the relevant value): | ||
| ``` | ||
| commit 8cb1de45c60f2d520551166610115531db673518 | ||
| Author: Shigeki Ohtsu <[email protected]> | ||
| Date: Thu Mar 29 16:46:11 2018 +0900 | ||
| deps: update archs files for OpenSSL-1.1.0 | ||
| `cd deps/openssl/config; make` updates all archs dependant files. | ||
| deps: update archs files for OpenSSL-1.1.0 | ||
| After an OpenSSL source update, all the config files need to be regenerated and | ||
| comitted by: | ||
| $ cd deps/openssl/config | ||
| $ make | ||
| $ git add deps/openssl/config/archs | ||
| $ git add deps/openssl/openssl/crypto/include/internal/bn_conf.h | ||
| $ git add deps/openssl/openssl/crypto/include/internal/dso_conf.h | ||
| $ git add deps/openssl/openssl/include/openssl/opensslconf.h | ||
| $ git commit | ||
| ``` | ||
|
|
||
| Finally, build Node and run tests. | ||