Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/model-checking/kani
Kani Rust Verifier
https://github.com/model-checking/kani
model-checking rust verification
Last synced: about 23 hours ago
JSON representation
Kani Rust Verifier
- Host: GitHub
- URL: https://github.com/model-checking/kani
- Owner: model-checking
- License: apache-2.0
- Created: 2021-03-26T18:49:50.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T04:03:06.000Z (about 2 months ago)
- Last Synced: 2024-10-29T12:25:55.463Z (about 2 months ago)
- Topics: model-checking, rust, verification
- Language: Rust
- Homepage: https://model-checking.github.io/kani
- Size: 31.1 MB
- Stars: 2,219
- Watchers: 23
- Forks: 89
- Open Issues: 526
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-rust-formalized-reasoning - Kani - verifier):star:[:lab_coat:](https://www.cs.cornell.edu/~avh/dyn-trait-icse-seip-2022-preprint.pdf):fire: - bit-precise model-checker, ensures that unsafe Rust code is actually safe. (Projects / Verification)
README
[](https://github.com/model-checking/kani/actions/workflows/kani.yml)
[](https://github.com/model-checking/kani/actions/workflows/cbmc-latest.yml)
The Kani Rust Verifier is a bit-precise model checker for Rust.
Kani is particularly useful for verifying unsafe code blocks in Rust, where the "[unsafe superpowers](https://doc.rust-lang.org/stable/book/ch19-01-unsafe-rust.html#unsafe-superpowers)" are unchecked by the compiler.
___
Kani verifies:
* Memory safety (e.g., null pointer dereferences)
* User-specified assertions (i.e., `assert!(...)`)
* The absence of panics (e.g., `unwrap()` on `None` values)
* The absence of some types of unexpected behavior (e.g., arithmetic overflows)
## Installation
To install the latest version of Kani ([Rust 1.58+; Linux or Mac](https://model-checking.github.io/kani/install-guide.html)), run:
```bash
cargo install --locked kani-verifier
cargo kani setup
```
See [the installation guide](https://model-checking.github.io/kani/install-guide.html) for more details.
## How to use Kani
Similar to testing, you write a harness, but with Kani you can check all possible values using `kani::any()`:
```rust
use my_crate::{function_under_test, meets_specification, precondition};
#[kani::proof]
fn check_my_property() {
// Create a nondeterministic input
let input = kani::any();
// Constrain it according to the function's precondition
kani::assume(precondition(input));
// Call the function under verification
let output = function_under_test(input);
// Check that it meets the specification
assert!(meets_specification(input, output));
}
```
Kani will then try to prove that all valid inputs produce acceptable outputs, without panicking or executing unexpected behavior.
Otherwise Kani will generate a trace that points to the failure.
We recommend following [the tutorial](https://model-checking.github.io/kani/kani-tutorial.html) to learn more about how to use Kani.
## GitHub Action
Use Kani in your CI with `model-checking/kani-github-action@VERSION`. See the
[GitHub Action section in the Kani
book](https://model-checking.github.io/kani/install-github-ci.html)
for details.
## Security
See [SECURITY](https://github.com/model-checking/kani/security/policy) for more information.
## Contributing
If you are interested in contributing to Kani, please take a look at [the developer documentation](https://model-checking.github.io/kani/dev-documentation.html).
## License
### Kani
Kani is distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) for details.
### Rust
Kani contains code from the Rust project.
Rust is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), with portions covered by various BSD-like licenses.
See [the Rust repository](https://github.com/rust-lang/rust) for details.