See the rpmalloc README for a detailed description of how the allocator works, peforms, and compares with other allocators.
To use rpmalloc as the global allocator in your Rust binary crate, in Cargo.toml
add:
[dependencies]
rpmalloc = "0.2.0"
And then in one of your .rs
files:
#[global_allocator]
static ALLOC: rpmalloc::RpMalloc = rpmalloc::RpMalloc;
It is also possible to configure how the allocator should be built through a set of feature flags that correspond to the rpmalloc C library ENABLE_x
defines:
- Overall:
statistics
,validate_args
,asserts
,guards
- Cache:
unlimited_cache
,unlimited_global_cache
,unlimited_thread_cache
,global_cache
,thread_cache
,adaptive_thread_cache
Example usage:
[dependencies]
rpmalloc = { version = "0.2.0", features = ["guards", "statistics"] }
See rpmalloc README for detailed descriptions of the config options.
Note that all of these have not been tested together with this Rust crate.
This crate has been tested to support the following platforms and Rust targets:
x86_64-pc-windows-msvc
x86_64-apple-darwin
x86_64-unknown-linux-gnu
PRs to increase the amount of supported targets are welcome, but they should add CI verification and avoid adding additional dependencies.
We welcome community contributions to this project.
Please read our Contributor Guide for more information on how to get started.
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Note that the rpmalloc library this crate uses is under public domain, and can also be licensed under MIT.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.