1ca1e0163e
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 PR-URL: https://github.com/nodejs/node/pull/29550 Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl> Reviewed-By: Anna Henningsen <anna@addaleax.net> |
||
---|---|---|
.. | ||
config | ||
openssl | ||
openssl_asm_avx2.gypi | ||
openssl_asm.gypi | ||
openssl_common.gypi | ||
openssl_no_asm.gypi | ||
openssl-cl_asm_avx2.gypi | ||
openssl-cl_asm.gypi | ||
openssl-cl_no_asm.gypi | ||
openssl-cli.gypi | ||
openssl.gyp | ||
openssl.gypi | ||
README.md |
This has a new binding scheme in building OpenSSL-1.1.0 library with
Node.js. OpenSSL-1.1.0 uses a new build system with Perl
for various
supported platforms. See openssl/Configurations/README
and
openssl/Configurations/README.design
in the OpenSSL source for
details.
In order to build OpenSSL library without Perl
in the build of Node.js
for various supported platforms, platform dependent files (e.g. asm
and header files ) are pre-generated and stored into the
config/archs
directory.
-
config/Makefile
andconfig/generate_gypi.pl
Makefile has supported platform list and generates and copies platform dependent files (e.g. asm files) into arch directory with
generate_gypi.pl
. Platform dependent gypi files also created obtaining build information fromconfigdata.pm
that is generated withConfigure
in the OpenSSL build system.For Windows,
Configure
generatesmakefile
that is only available tonmake
command.config/Makefile_VC-WIN32
andconfig/Makefile_VC-WIN64A
are made by hand for the use of GNU make. Ifmakefile
rules or targets are changed in the version up of OpenSSL, they should be also updated. -
gyp and gypi files (
openssl*.{gyp,gypi}
)openssl.gyp
has two targets of openssl and openssl-cli referred fromnode.gyp
. They include asm and no_asm gypi files with arch dependent gypi according to its build options and platforms. The gyp data which is common with asm and no_asm are stored inopenssl_common.gypi
. -
header files (
config/*.{h,h.tmpl}
)bn_conf.h
,dso_conf.h
andopensslconf.h
are platform dependent in the OpenSSL sources. They are replaced withconfig/*.h.tmpl
files to include the file in the../../../config/
and referred to each arch file that depends on asm and no-asm option.
Supported architectures for use of ASM
Here is a list of supported architectures for use of ASM in OpenSSL.
--dest-os | --dest-cpu | OpenSSL target arch | CI |
---|---|---|---|
aix | ppc | aix-gcc | o |
aix | ppc64 | aix64-gcc | o |
linux | ia32 | linux-elf | o |
linux | x32 | linux-x32 | - |
linux | x64 | linux-x86_64 | o |
linux | arm | linux-armv4 | o |
linux | arm64 | linux-aarch64 | o |
linux | ppc | linux-ppc | o |
linux | ppc64 | linux-ppc64 | o |
linux | ppc64(*1) | linux-ppc64le | o |
linux | s390 | linux32-s390x | o |
linux | s390x | linux64-s390x | o |
mac | ia32 | darwin-i386-cc | - |
mac | x64 | darwin64-x86-cc | o |
win | ia32 | VC-WIN32 | - |
win | x64 | VC-WIN64A | o |
solaris | ia32 | solaris-x86-gcc | o |
solaris | x64 | solaris64-x86_64-gcc | o |
freebsd | ia32 | BSD-x86 | - |
freebsd | x64 | BSD-x86_64 | o |
openbsd | ia32 | BSD-x86 | - |
openbsd | x64 | BSD-x86_64 | - |
others | others | linux-elf | - |
(*1: This needs to be configured with the variable of node_byteorder: little)
These are listed in config/Makefile. Please refer config/opensslconf_asm.h for details.
Upgrading OpenSSL
Please refer config/README.md.