ppc750cl 0.3.3

Disassembler for PowerPC 750CL
Documentation
  • Coverage
  • 86.87%
    225 out of 259 items documented0 out of 0 items with examples
  • Size
  • Source code size: 352.76 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 13.99 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 13s Average build duration of successful builds.
  • all releases: 14s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • encounter/powerpc-rs
    10 2 0
  • crates.io
  • Dependencies
    • —
  • Versions
  • Owners
  • encounter

ppc750cl Build Status Latest Version Api Rustdoc Rust Version

Rust tools for working with the PowerPC 750CL / 750CXe family of processors.

Building

cargo run --package ppc750cl-genisa
cargo build --release

Instruction Set

For those unfamiliar with PowerPC, here are some basics.

  • PowerPC 7xx is a family of RISC CPUs produced from 1997 to 2012.
    • They operate with 32-bit words and every instruction is 32-bits wide.
  • This project focuses (only) on compatibility with the PowerPC 750CL and 750CXe.
    • PowerPC 750CL ("Broadway") is used in the Nintendo Wii.
    • PowerPC 750CXe ("Gekko") is used in the Nintendo GameCube.
    • They add a "paired-singles" SIMD unit and a bunch of other instructions.

isa.yaml

The file isa.yaml contains a full definition of the PowerPC 750CL / 750CXe instruction set.

It powers the disassembler and assembler.

Similarly to LLVM TableGen, the program ppc750cl-genisa generates a Rust file implementing an instruction decoder.

Safety & Correctness

  • The disassembler has been fuzzed over all ~4.29 billion possible instructions (via ppc750cl-fuzz).
  • It is safe to run the disassembler over untrusted byte arrays.
  • However, no guarantees on correctness are made (yet). Expect bugs.

Performance

With a single thread on Ryzen 9 3900X:

  • Disassembling & printing: ~12M insn/s (~50 MB/s)
  • Disassembling only: ~275M insn/s (~1 GB/s)