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

x86test-types

Common types for x86test runnter and the x86test procedural macro

5 releases

0.0.5 Mar 3, 2022
0.0.4 Jan 25, 2022
0.0.3 Apr 24, 2020
0.0.2 Sep 12, 2019
0.0.1 Aug 24, 2019

#106 in Testing

Download history 38/week @ 2022-04-20 95/week @ 2022-04-27 91/week @ 2022-05-04 125/week @ 2022-05-11 65/week @ 2022-05-18 76/week @ 2022-05-25 82/week @ 2022-06-01 62/week @ 2022-06-08 51/week @ 2022-06-15 43/week @ 2022-06-22 44/week @ 2022-06-29 49/week @ 2022-07-06 44/week @ 2022-07-13 58/week @ 2022-07-20 56/week @ 2022-07-27 46/week @ 2022-08-03

209 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