This crate contains the logic to build OpenSSL and is intended to be consumed by
the openssl-sys crate. You likely in theory aren't interacting with this too
much!
There are currently two maintained branches, matching the two maintained OpenSSL versions:
mainwhich builds OpenSSL 3.1release/111which builds OpenSSL 1.1.1
The crates versions follow the X.Y.Z+B pattern:
- The major version
Xis the upstream OpenSSL version:111for 1.1.1300for 3.0 (to be higher than111)
- The minor
Yand patchZversions are incremented when making changes to the crate, either OpenSSL update or internal changes. Bcontains the full upstream OpenSSL version, like1.1.1kor3.0.7. Note that this field is actually ignored in comparisons and only there for documentation.
Building OpenSSL for windows-msvc targets, users can choose whether to enable
assembly language routines, which requires nasm.
The build process will automatically detect whether nasm.exe is installed in
PATH. If found, the assembly language routines will be enabled (in other words,
the no-asm option will NOT be configured).
You can manipulate this behavior by setting the OPENSSL_RUST_USE_NASM environment
variable:
1: Force enable the assembly language routines. (panic ifnasm.exeis not available.)0: Force disable the assembly language routines even if thenasm.execan be found in PATH.- not set: Let the build process automatically detect whether
nasm.exeis installed. If found, enable. If not, disable.
However, this environment variable does NOT take effects on non-windows platforms.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in openssl-src by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.