libacpica 0.0.8

Bindings to the ACPI Component Architecture
Documentation
  • Coverage
  • 3.16%
    135 out of 4275 items documented0 out of 397 items with examples
  • Size
  • Source code size: 12.1 MB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 89.85 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 22s Average build duration of successful builds.
  • all releases: 22s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Documentation
  • gz/acpica-sys
    1 0 1
  • crates.io
  • Dependencies
    • —
  • Versions
  • Owners
  • gz

acpica-sys

Builds acpica, and has bindings to it. To actually use most of it, various symbols will need to be provided, described in section 9 of the ACPICA reference manual.

This is a fork of the existing acpica-sys crate with minor modifications:

  • Use GCC
  • Modified build
  • More recent acpica sources

Check https://crates.io/crates/libacpica for more details.

Updating ACPICA sources

Some steps that might be useful to follow:

  • Download new sources from https://acpica.org/downloads
  • Rename acpica to acpica-old
  • Unpack new acpica sources, rename folder to acpica
  • cp acpica-old/source/include/platform/acnrk.h acpica/source/include/platform/acnrk.h
  • Include the acnrk header file inside acenv.h in the platform list:

Should look like this:

#if defined(NRK)
#include "acnrk.h"

#elif defined(_LINUX) || defined(__linux__)
#include "aclinux.h"
  • mv src/raw64.rs src/raw64.bak.rs
  • bash update-bindings.sh (Make sure rust-bindgen is installed for this step)
  • Inspect raw64.rs see if it approximately represents src/raw64.bak.rs file.
  • Switch whatever project uses this to new version of the crate and see if it compiles
  • rm src/raw64.bak.rs
  • rm -rf acpica-old

Some issues that can be expected and what to do about them:

  • Compilation error due to __va_list_tag, AcpiOsVprintf etc. -> Just remove those definitons.
  • Compilation error error[E0433]: failed to resolve: maybe a missing crate std? -> Replace with core, or remove those definiton if unwanted.
  • error[E0308]: mismatched types expected i32, found u32: Make sure UINT8, UINT32, UINT64 map to u8, u32, u64 respectively (and not i8, i32, i64).
  • Linker throws multiple definition of a symbol errors:
|   = note: ld: ./target/x86_64-nrk/debug/deps/liblibacpica-e827d49529440c52.rlib(utglobal.o):(.data+0x0): multiple definition of `AcpiGbl_FixedEventInfo'; ./target/x86_64-nrk/debug/deps/liblibacpica-70ca8cf5bc7406ee.rlib(utglobal.o):(.data+0x0): first defined here

Some older version of libacpica creeped in through a transitive dependency (e.g., rust-topology). Clone rust-topology locally and use update libacpica there or use a cargo patch section to override.

  • Linker error looking for libc functions?
|   = note: ld: ./target/x86_64-nrk/debug/deps/liblibacpica-1986a2fed1aa7eb7.rlib(utdebug.o): in function `AcpiDebugPrint':
|           utdebug.c:(.text+0x169): undefined reference to `strlen'

Check compile time defines for ACPI_USE_STANDARD_HEADERS and ACPI_USE_SYSTEM_CLIBRARY.