#os #amd64 #x86 #x86-64 #ia32

nightly x86

Library to program x86 (amd64) hardware. Contains x86 specific data structure descriptions, data-tables, as well as convenience function to call assembly instructions typically not exposed in higher level languages.

65 releases (43 breaking)

0.43.0 Sep 30, 2021
0.41.0 Aug 2, 2021
0.40.0 Jun 10, 2021
0.37.0 Mar 1, 2021
0.0.1 Mar 28, 2015

#71 in Hardware support

Download history 561/week @ 2021-06-30 1092/week @ 2021-07-07 980/week @ 2021-07-14 835/week @ 2021-07-21 1437/week @ 2021-07-28 1919/week @ 2021-08-04 1379/week @ 2021-08-11 1331/week @ 2021-08-18 1847/week @ 2021-08-25 1838/week @ 2021-09-01 1528/week @ 2021-09-08 1261/week @ 2021-09-15 1919/week @ 2021-09-22 1123/week @ 2021-09-29 1940/week @ 2021-10-06 1183/week @ 2021-10-13

5,995 downloads per month
Used in 21 crates (17 directly)

MIT license

2MB
7.5K SLoC

x86 / amd64 library Crates.io docs.rs/x86 Standard checks

Library to program x86 (amd64) hardware. Contains x86 specific data structure descriptions, data-tables, as well as convenience function to call assembly instructions typically not exposed in higher level languages.

Currently supports:

  • I/O registers
  • Control registers
  • Debug registers
  • MSR registers
  • Segmentation
  • Descriptor-tables (GDT, LDT, IDT)
  • IA32-e page table layout
  • Interrupts (with xAPIC and x2APIC, I/O APIC drivers)
  • Task state
  • Performance counter information
  • Intel SGX: Software Guard Extensions
  • Random numbers (rdrand, rdseed)
  • Time (rdtsc, rdtscp)
  • Querying CPUID (uses raw_cpuid library)
  • Transactional memory (Intel RTM and HLE)
  • Virtualization (Intel VMX)

This library depends on libcore so it can be used in kernel level code.

Testing

We use two forms of tests for the crate. Regular tests with #[test] that run in a ring 3 process and #[x86test] tests that run in a VM (and therefore grant a privileged execution environment, see x86test).

# To execute x86tests run:
$ RUSTFLAGS="-C relocation-model=dynamic-no-pic -C code-model=kernel" RUST_BACKTRACE=1 cargo test --features vmtest

# To execute the regular tests, run:
$ cargo test --features utest

Features

  • performance-counter: Includes the performance counter information. Note this feature can increase compilation time significantly due to large, statically generated hash-tables that are included in the source. Therefore, it is disabled by default.

Documentation

Dependencies