You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
54 lines
2.0 KiB
54 lines
2.0 KiB
# Crossbeam Epoch
|
|
|
|
[![Build Status](https://github.com/crossbeam-rs/crossbeam/workflows/CI/badge.svg)](
|
|
https://github.com/crossbeam-rs/crossbeam/actions)
|
|
[![License](https://img.shields.io/badge/license-MIT_OR_Apache--2.0-blue.svg)](
|
|
https://github.com/crossbeam-rs/crossbeam/tree/master/crossbeam-epoch#license)
|
|
[![Cargo](https://img.shields.io/crates/v/crossbeam-epoch.svg)](
|
|
https://crates.io/crates/crossbeam-epoch)
|
|
[![Documentation](https://docs.rs/crossbeam-epoch/badge.svg)](
|
|
https://docs.rs/crossbeam-epoch)
|
|
[![Rust 1.36+](https://img.shields.io/badge/rust-1.36+-lightgray.svg)](
|
|
https://www.rust-lang.org)
|
|
[![chat](https://img.shields.io/discord/569610676205781012.svg?logo=discord)](https://discord.gg/BBYwKq)
|
|
|
|
This crate provides epoch-based garbage collection for building concurrent data structures.
|
|
|
|
When a thread removes an object from a concurrent data structure, other threads
|
|
may be still using pointers to it at the same time, so it cannot be destroyed
|
|
immediately. Epoch-based GC is an efficient mechanism for deferring destruction of
|
|
shared objects until no pointers to them can exist.
|
|
|
|
Everything in this crate except the global GC can be used in `no_std` environments, provided that
|
|
`alloc` feature is enabled.
|
|
|
|
## Usage
|
|
|
|
Add this to your `Cargo.toml`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
crossbeam-epoch = "0.9"
|
|
```
|
|
|
|
## Compatibility
|
|
|
|
Crossbeam Epoch supports stable Rust releases going back at least six months,
|
|
and every time the minimum supported Rust version is increased, a new minor
|
|
version is released. Currently, the minimum supported Rust version is 1.36.
|
|
|
|
## License
|
|
|
|
Licensed under either of
|
|
|
|
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
|
|
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
|
|
|
|
at your option.
|
|
|
|
#### Contribution
|
|
|
|
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.
|