Cindy Lin
0c59e9e55b
Change-Id: Ic25803634289d53fd2431cdb525cfe3fe08a753a Reviewed-on: https://boringssl-review.googlesource.com/c/boringssl/+/76607 Commit-Queue: Cindy Lin <cinlin@google.com> Reviewed-by: David Benjamin <davidben@google.com> Commit-Queue: David Benjamin <davidben@google.com>
1.2 KiB
bssl-sys
A low-level binding crate for Rust that moves in lockstop with BoringSSL.
How it works
bssl-sys uses bindgen as part of the cmake build process to generate Rust compatibility shims for the targeted platform. It is important to generate it for the correct platform because bindgen uses LLVM information for alignment which varies depending on architecture.
To Use
-
Build
boringsslwith-DRUST_BINDINGS=<rust-triple>, which should match the Rust target triple when buildingbssl-sys. For example, to build on 64-bit Linux:cmake -GNinja -B build -DRUST_BINDINGS=x86_64-unknown-linux-gnu ninja -C build -
Install
bindgen. -
Install
cargo-deny.
After that, the bssl-sys crate can be built via cargo. By default, it looks for bindgen output and BoringSSL static libraries in the build directory. This can be reconfigured with BORINGSSL_BUILD_DIR environment variable. Note the environment variable is evaluated relative to rust/bssl-sys/src, so using an absolute path may be more convenient.