Cargo Features

boring-patch has no features set by default.

[dependencies]
boring-patch = { version = "4.9.7-1", features = ["fips", "fips-link-precompiled", "rpk", "pq-experimental", "underscore-wildcards", "kx-safe-default", "kx-client-pq-supported", "kx-client-pq-preferred", "kx-client-nist-required"] }
fips

Controlling the build

Use a FIPS-validated version of boringssl.

Enables fips of boring-sys-patch

Link with precompiled FIPS-validated bcm.o module.

Enables fips-link-precompiled of boring-sys-patch

rpk

Enables Raw public key API (https://datatracker.ietf.org/doc/html/rfc7250) This feature is necessary in order to compile the bindings for the default branch of boringSSL. Alternatively, a version of boringSSL that implements the same feature set can be provided by setting BORING_BSSL{,_FIPS}_SOURCE_PATH and BORING_BSSL{,_FIPS}_ASSUME_PATCHED.

Enables rpk of boring-sys-patch

pq-experimental

Applies a patch to the boringSSL source code that enables support for PQ key exchange. This feature is necessary in order to compile the bindings for the default branch of boringSSL. Alternatively, a version of boringSSL that implements the same feature set can be provided by setting BORING_BSSL{,_FIPS}_SOURCE_PATH and BORING_BSSL{,_FIPS}_ASSUME_PATCHED.

Enables pq-experimental of boring-sys-patch

underscore-wildcards

Applies a patch to enable ffi::X509_CHECK_FLAG_UNDERSCORE_WILDCARDS. Same caveats as those for pq-experimental feature apply.

Enables underscore-wildcards of boring-sys-patch

kx-safe-default kx-client-nist-required? kx-client-pq-preferred? kx-client-pq-supported?

Controlling key exchange preferences at compile time
Choose key exchange preferences at compile time. This prevents the user from choosing their own preferences.

kx-client-pq-supported kx-client-pq-preferred? = kx-safe-default

Support PQ key exchange. The client will prefer classical key exchange, but will upgrade to PQ key exchange if requested by the server. This is the safest option if you don't know if the peer supports PQ key exchange. This feature implies "kx-safe-default".

kx-client-pq-preferred = kx-client-pq-supported, kx-safe-default

Prefer PQ key exchange. The client will prefer PQ exchange, but fallback to classical key exchange if requested by the server. This is the best option if you know the peer supports PQ key exchange. This feature implies "kx-safe-default" and "kx-client-pq-supported".

kx-client-nist-required = kx-safe-default

Disable key exchange involving non-NIST key exchange on the client side.
Implies "kx-safe-default".