Skip to content

Commit bb664d0

Browse files
committed
Add deprecation notice to rsdp and publish as rsdp v2.0.1
1 parent 28275c5 commit bb664d0

File tree

2 files changed

+44
-2
lines changed

2 files changed

+44
-2
lines changed

rsdp/Cargo.toml

+1-2
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
11
[package]
22
name = "rsdp"
3-
version = "2.0.0"
3+
version = "2.0.1"
44
authors = ["Isaac Woods", "Restioson"]
55
repository = "https://github.com/rust-osdev/acpi"
66
description = "Zero-allocation library for locating and parsing the RSDP, the first ACPI table"
77
categories = ["hardware-support", "no-std"]
8-
readme = "../README.md"
98
license = "MIT/Apache-2.0"
109
edition = "2021"
1110

rsdp/README.md

+43
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Acpi
2+
⚠️**WARNING: The `rsdp` crate was previously a component of the `acpi` ecosystem, but has been deprecated. Its
3+
functionality is now entirely supported by the `acpi` crate, including a subset of functionality that will work in
4+
an environment that does not have an allocator. This crate will likely not receive further updates**⚠️
5+
6+
![Build Status](https://github.com/rust-osdev/acpi/actions/workflows/build.yml/badge.svg)
7+
[![Version](https://img.shields.io/crates/v/rsdp.svg?style=rounded-square)](https://crates.io/crates/rsdp/)
8+
[![Version](https://img.shields.io/crates/v/acpi.svg?style=rounded-square)](https://crates.io/crates/acpi/)
9+
[![Version](https://img.shields.io/crates/v/aml.svg?style=rounded-square)](https://crates.io/crates/aml/)
10+
11+
### [Documentation (`rsdp`)](https://docs.rs/rsdp)
12+
### [Documentation (`acpi`)](https://docs.rs/acpi)
13+
### [Documentation (`aml`)](https://docs.rs/aml)
14+
15+
A library to parse ACPI tables and AML, written in pure Rust. Designed to be easy to use from Rust bootloaders and kernels. The library is split into three crates:
16+
- `rsdp` parses the RSDP and can locate it on BIOS platforms. It does not depend on `alloc`, so is suitable to use from bootloaders without heap alloctors. All of its
17+
functionality is reexported by `acpi`.
18+
- `acpi` parses the static tables (useful but not feature-complete). It can be used from environments that have allocators, and ones that don't (but with reduced functionality).
19+
- `aml` parses the AML tables (can be useful, far from feature-complete).
20+
21+
There is also the `acpi-dumper` utility to easily dump a platform's ACPI tables (this currently only works on Linux).
22+
23+
## Contributing
24+
Contributions are more than welcome! You can:
25+
- Write code - the ACPI spec is huge and there are bound to be things we don't support yet!
26+
- Improve our documentation!
27+
- Use the crates within your kernel and file bug reports and feature requests!
28+
29+
Useful resources for contributing are:
30+
- [The ACPI specification](https://uefi.org/specifications)
31+
- [OSDev Wiki](https://wiki.osdev.org/ACPI)
32+
33+
You can run the AML test suite with `cargo run --bin aml_tester -- -p tests`.
34+
You can run fuzz the AML parser with `cd aml && cargo fuzz run fuzz_target_1` (you may need to `cargo install cargo-fuzz`).
35+
36+
## Licence
37+
This project is dual-licenced under:
38+
- Apache Licence, Version 2.0 ([LICENCE-APACHE](LICENCE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
39+
- MIT license ([LICENCE-MIT](LICENCE-MIT) or http://opensource.org/licenses/MIT)
40+
41+
Unless you explicitly state otherwise, any contribution submitted for inclusion in this work by you,
42+
as defined in the Apache-2.0 licence, shall be dual licenced as above, without additional terms or
43+
conditions.

0 commit comments

Comments
 (0)