This package contains the logic to build LibreSSL and is intended to be consumed by the openssl-sys package.
Currently it builds LibreSSL 3.1.4, released 17 Aug 2020. We're not yet building 3.2.2 (the latest stable release since 18 Oct 2020), because openssl-sys isn't yet supporting it. (See discussion on this PR.)
To use, make sure that openssl-sys is built with the "vendored" feature
(the openssl
package also accepts that feature, and passes it on to openssl-sys).
Then add the following to your top-level Cargo.toml, for a package that has openssl-sys
as a direct or indirect dependency:
[patch.crates-io]
openssl-src = { git = "https://github.com/dubiousjim/libressl-src" }
This will substitute this repository into your build process where cargo would otherwise have used openssl-src. The downsides of this method are:
- this method only works on a top-level
Cargo.toml; it will not be inherited by other packages that depend on that package - a package with a
patchsection can't itself be published on crates.io (CHECK)
I'll try to get the maintainers of openssl-sys
to accommodate other methods, but for the moment
they're disinclined to do so.
For the time being, you'll also need to add this entry to the patch section, too:
autotools = { git = "https://github.com/dubiousjim/autotools-rs", branch = "master" }
But once a newer version of this package (> 0.2.1) is published, this will no longer be necessary.
This package builds and provides linking information for each of LibreSSL's libtls, libssl, and libcrypto. However openssl-sys will only include the last two of these. If you want to link against LibreSSL's libtls, consider the libtls package. (Though this doesn't yet seem to provide a mechanism for using a vendored copy of LibreSSL.)
This project is licensed under either of
- Apache License, Version 2.0, ( http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ( http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in libressl-src by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.