From 23d25f97c8fa3001527a7dde7dffb8931a7d0f26 Mon Sep 17 00:00:00 2001 From: Jay Lee Date: Tue, 24 May 2022 16:53:50 -0700 Subject: [PATCH] *: correct README path and publish date Signed-off-by: Jay Lee --- CHANGELOG.md | 2 +- README.md | 98 +----------------------------------------- jemallocator/README.md | 97 +++++++++++++++++++++++++++++++++++++++++ 3 files changed, 99 insertions(+), 98 deletions(-) mode change 100644 => 120000 README.md create mode 100644 jemallocator/README.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 427f9d4..cb262e4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,4 @@ -# 0.5.0 - 2022-05-19 +# 0.5.0 - 2022-05-25 - Update jemalloc to 5.3.0 (#23) diff --git a/README.md b/README.md deleted file mode 100644 index 6276212..0000000 --- a/README.md +++ /dev/null @@ -1,97 +0,0 @@ -# jemallocator - -[![ci]][github actions] [![Latest Version]][crates.io] [![docs]][docs.rs] - -This project is the successor of [jemallocator](https://github.com/gnzlbg/jemallocator). - -The project is published as `tikv-jemallocator` and `jemallocator` for historical reasons. The two crates are the same except names. It's OK to use either crate. But due to lack of permissions, only `jemallocator` and `jemalloc-sys` are updated. If you want to use other crates, `tikv-xxx` versions are still required. - -> Links against `jemalloc` and provides a `Jemalloc` unit type that implements -> the allocator APIs and can be set as the `#[global_allocator]` - -## Overview - -The `jemalloc` support ecosystem consists of the following crates: - -* `jemalloc-sys`: builds and links against `jemalloc` exposing raw C bindings to it. -* `jemallocator`: provides the `Jemalloc` type which implements the - `GlobalAlloc` and `Alloc` traits. -* `jemalloc-ctl`: high-level wrapper over `jemalloc`'s control and introspection - APIs (the `mallctl*()` family of functions and the _MALLCTL NAMESPACE_)' - -## Documentation - -* [Latest release (docs.rs)][docs.rs] - -To use `jemallocator` add it as a dependency: - -```toml -# Cargo.toml -[dependencies] - -[target.'cfg(not(target_env = "msvc"))'.dependencies] -jemallocator = "0.5" -``` - -To set `jemallocator::Jemalloc` as the global allocator add this to your project: - -```rust -# main.rs -#[cfg(not(target_env = "msvc"))] -use jemallocator::Jemalloc; - -#[cfg(not(target_env = "msvc"))] -#[global_allocator] -static GLOBAL: Jemalloc = Jemalloc; -``` - -And that's it! Once you've defined this `static` then jemalloc will be used for -all allocations requested by Rust code in the same program. - -## Platform support - -The following table describes the supported platforms: - -* `build`: does the library compile for the target? -* `run`: do `jemallocator` and `jemalloc-sys` tests pass on the target? -* `jemalloc`: do `jemalloc`'s tests pass on the target? - -Tier 1 targets are tested on all Rust channels (stable, beta, and nightly). All -other targets are only tested on Rust nightly. - -| Linux targets: | build | run | jemalloc | -|-------------------------------------|-----------|---------|--------------| -| `aarch64-unknown-linux-gnu` | ✓ | ✓ | ✗ | -| `powerpc64le-unknown-linux-gnu` | ✓ | ✓ | ✗ | -| `x86_64-unknown-linux-gnu` (tier 1) | ✓ | ✓ | ✓ | -| **MacOSX targets:** | **build** | **run** | **jemalloc** | -| `x86_64-apple-darwin` (tier 1) | ✓ | ✓ | ✗ | - -## Features - -The `jemallocator` crate re-exports the [features of the `jemalloc-sys` -dependency](https://github.com/tikv/jemallocator/blob/master/jemalloc-sys/README.md). - -## License - -This project is 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 `jemallocator` by you, as defined in the Apache-2.0 license, -shall be dual licensed as above, without any additional terms or conditions. - -[Latest Version]: https://img.shields.io/crates/v/jemallocator.svg -[crates.io]: https://crates.io/crates/jemallocator -[docs]: https://docs.rs/jemallocator/badge.svg -[docs.rs]: https://docs.rs/jemallocator/ -[ci]: https://github.com/tikv/jemallocator/actions/workflows/main.yml/badge.svg -[github actions]: https://github.com/tikv/jemallocator/actions diff --git a/README.md b/README.md new file mode 120000 index 0000000..39c4a18 --- /dev/null +++ b/README.md @@ -0,0 +1 @@ +jemallocator/README.md \ No newline at end of file diff --git a/jemallocator/README.md b/jemallocator/README.md new file mode 100644 index 0000000..6a253db --- /dev/null +++ b/jemallocator/README.md @@ -0,0 +1,97 @@ +# tikv-jemallocator + +[![ci]][github actions] [![Latest Version]][crates.io] [![docs]][docs.rs] + +This project is the successor of [jemallocator](https://github.com/gnzlbg/jemallocator). + +The project is published as `tikv-jemallocator` and `jemallocator` for historical reasons. The two crates are the same except names. It's OK to use either crate. But due to lack of permissions, only `jemallocator` and `jemalloc-sys` are updated. If you want to use other crates, `tikv-xxx` versions are still required. + +> Links against `jemalloc` and provides a `Jemalloc` unit type that implements +> the allocator APIs and can be set as the `#[global_allocator]` + +## Overview + +The `jemalloc` support ecosystem consists of the following crates: + +* `tikv-jemalloc-sys`: builds and links against `jemalloc` exposing raw C bindings to it. +* `tikv-jemallocator`: provides the `Jemalloc` type which implements the + `GlobalAlloc` and `Alloc` traits. +* `tikv-jemalloc-ctl`: high-level wrapper over `jemalloc`'s control and introspection + APIs (the `mallctl*()` family of functions and the _MALLCTL NAMESPACE_)' + +## Documentation + +* [Latest release (docs.rs)][docs.rs] + +To use `tikv-jemallocator` add it as a dependency: + +```toml +# Cargo.toml +[dependencies] + +[target.'cfg(not(target_env = "msvc"))'.dependencies] +tikv-jemallocator = "0.5" +``` + +To set `tikv_jemallocator::Jemalloc` as the global allocator add this to your project: + +```rust +# main.rs +#[cfg(not(target_env = "msvc"))] +use tikv_jemallocator::Jemalloc; + +#[cfg(not(target_env = "msvc"))] +#[global_allocator] +static GLOBAL: Jemalloc = Jemalloc; +``` + +And that's it! Once you've defined this `static` then jemalloc will be used for +all allocations requested by Rust code in the same program. + +## Platform support + +The following table describes the supported platforms: + +* `build`: does the library compile for the target? +* `run`: do `tikv-jemallocator` and `tikv-jemalloc-sys` tests pass on the target? +* `jemalloc`: do `tikv-jemalloc`'s tests pass on the target? + +Tier 1 targets are tested on all Rust channels (stable, beta, and nightly). All +other targets are only tested on Rust nightly. + +| Linux targets: | build | run | jemalloc | +|-------------------------------------|-----------|---------|--------------| +| `aarch64-unknown-linux-gnu` | ✓ | ✓ | ✗ | +| `powerpc64le-unknown-linux-gnu` | ✓ | ✓ | ✗ | +| `x86_64-unknown-linux-gnu` (tier 1) | ✓ | ✓ | ✓ | +| **MacOSX targets:** | **build** | **run** | **jemalloc** | +| `x86_64-apple-darwin` (tier 1) | ✓ | ✓ | ✗ | + +## Features + +The `tikv-jemallocator` crate re-exports the [features of the `tikv-jemalloc-sys` +dependency](https://github.com/tikv/jemallocator/blob/master/jemalloc-sys/README.md). + +## License + +This project is 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 `tikv-jemallocator` by you, as defined in the Apache-2.0 license, +shall be dual licensed as above, without any additional terms or conditions. + +[Latest Version]: https://img.shields.io/crates/v/tikv-jemallocator.svg +[crates.io]: https://crates.io/crates/tikv-jemallocator +[docs]: https://docs.rs/tikv-jemallocator/badge.svg +[docs.rs]: https://docs.rs/tikv-jemallocator/ +[ci]: https://github.com/tikv/jemallocator/actions/workflows/main.yml/badge.svg +[github actions]: https://github.com/tikv/jemallocator/actions