#vm #os #amd64 #kvm #x86-64

x86test-types

Common types for x86test runnter and the x86test procedural macro

3 releases

0.0.3 Apr 24, 2020
0.0.2 Sep 12, 2019
0.0.1 Aug 24, 2019

#12 in #amd64

Download history 7/week @ 2021-08-11 2/week @ 2021-08-18 12/week @ 2021-08-25 4/week @ 2021-09-08 2/week @ 2021-09-15 5/week @ 2021-09-22 3/week @ 2021-09-29 3/week @ 2021-10-06 4/week @ 2021-10-13 2/week @ 2021-10-20 13/week @ 2021-10-27 21/week @ 2021-11-03 34/week @ 2021-11-10 22/week @ 2021-11-17 31/week @ 2021-11-24

111 downloads per month
Used in 2 crates

MIT/Apache

2MB
8K 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