A tool that lists statistics related to the usage of unsafe Rust code in a Rust
crate and all its dependencies.
This cargo plugin was originally based on the code from two other projects:
Try to find and use a system-wide installed OpenSSL library:
cargo install --locked cargo-geiger
Or, build and statically link OpenSSL as part of the cargo-geiger executable:
cargo install --locked cargo-geiger --features vendored-openssl
Alternatively pre-built binary releases are available from GitHub releases.
- Navigate to the same directory as the
Cargo.tomlyou want to analyze. cargo geiger
This tool is not meant to advise directly whether the code ultimately is truly insecure or not.
The purpose of cargo-geiger is to provide statistical input to auditing e.g. with:
The use of unsafe is nuanced and necessary in some cases and any motivation to use it is outside the scope of cargo-geiger.
It is important that any reporting is handled with care:
Cargo Geiger exposes three libraries:
cargo-geiger– Unversioned and highly unstable library exposing the internals of thecargo-geigerbinary. As such, any function contained within this library may be subject to change.cargo-geiger-serde– A library containing the serializable report typesgeiger– A library containing a few decoupled cargo components used by cargo-geiger
See the changelog.
https://en.wikipedia.org/wiki/Geiger_counter
Unsafe code, like ionizing radiation, is unavoidable in some situations and should be safely contained!
