Google Git
Sign in
android / platform / external / rust / crates / acpi / 015c72bc14c6a7745fd6d381df65280ec5745e84
commit015c72bc14c6a7745fd6d381df65280ec5745e84[log] [tgz]
authorArmelle Laine <armellel@google.com>Tue Jun 11 22:57:09 2024 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Tue Jun 11 22:57:09 2024 +0000
tree892eca299e2e4ac1314a95cd8280fb112009b9b0
parentc90d01ba4c1aef2915a03661a79b33e3ad14fc86 [diff]
parent844b46124a9df875481a6430f09d7ed8245aaaf3 [diff]
Manual fix of rules.mk for acpi crate am: adb31cf3f8 am: 844b46124a

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/acpi/+/3070714

Change-Id: Id6b20b2ad0b953222d789ce96e11554241756f01
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
tree: 892eca299e2e4ac1314a95cd8280fb112009b9b0
  1. src/
  2. .cargo_vcs_info.json
  3. Cargo.toml
  4. Cargo.toml.orig
  5. LICENSE
  6. METADATA
  7. MODULE_LICENSE_APACHE2
  8. OWNERS
  9. README.md
  10. rules.mk
README.md

Acpi

Build Status Version Version Version

Documentation (rsdp)

Documentation (acpi)

Documentation (aml)

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:

  • 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 functionality is reexported by acpi.
  • 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).
  • aml parses the AML tables (can be useful, far from feature-complete).

There is also the acpi-dumper utility to easily dump a platform's ACPI tables (this currently only works on Linux).

Contributing

Contributions are more than welcome! You can:

  • Write code - the ACPI spec is huge and there are bound to be things we don't support yet!
  • Improve our documentation!
  • Use the crates within your kernel and file bug reports and feature requests!

Useful resources for contributing are:

You can run the AML test suite with cargo run --bin aml_tester -- -p tests. You can run fuzz the AML parser with cd aml && cargo fuzz run fuzz_target_1 (you may need to cargo install cargo-fuzz).

Licence

This project is dual-licenced under:

Unless you explicitly state otherwise, any contribution submitted for inclusion in this work by you, as defined in the Apache-2.0 licence, shall be dual licenced as above, without additional terms or conditions.