cover_crypt_test v3.0.3
CoverCrypt
Implementation of the CoverCrypt algorithm.
Building and testing
The crate is separated in 3 main modules:
cover_crypt_core
: contains the cryptographic code for CoverCrypt.api.rs
: exposes the public API with policy managementinterfaces
: contains interfaces useful for Cosmian matching those in crypto_base as well as a Foreign Function Interface (FFI) useful to integrate with other languages. In particular, the code in this module demonstrates the use of hybrid cryptography involving ABE and AES and exposes it as a FFI.
To build the core only, run
cargo build --release
To build the Cosmian interfaces without FFI, pass the interfaces
feature flag, i.e.
cargo build --release --features interfaces
To build everything, including the FFI, pass the ffi
feature flag, or use --all-features
i.e.
cargo build --release --all-features
The latter will build a shared library and one can verify that the FFI symbols are present using (linux)
objdump -T target/release/libcover_crypt.so
The code contains numerous tests that you can run using
cargo test --release --all-features
Building the library for a different glibc
Go to the build directory for an example on hw to build for GLIBC 2.17
Building for Pyo3
maturin develop --cargo-extra-args="--release --features python
Benchmarks
Benchmarking is using Criterion library.
Run all benchmarks:
cargo bench --features ffi
note: unfortunately, we cannot automatically tell Criterion to run benchmarks with ffi
feature activated, we need to specify it.
Run only non-FFI benchmarks:
cargo bench
Flamegraph
To generate a Flamegraph on Criterion's benchmark:
cargo flamegraph --bench benches --features ffi -- --bench