How edmcman/nvdisasm-re works
nvdisasm-re reverse engineers NVIDIA SASS machine descriptions and uses them to build decoding, assembly, instruction semantics, native emulation, and a Ghidra processor. The main workflow is to decode cubin or raw instruction words using architecture descriptions, then inspect, assemble, lift, evaluate, or execute SASS. The graph preserves those distinct capabilities; some Ghidra and machine-description relationships are based on README statements because their implementation was not sampled.
Main entry points: pydecode.py Reference decoder · gen.py SLEIGH generator · ir.py Decode IR · family.py Semantics families
Components 21
Machine descriptions
- Architecture data
src/sass/md/data - Decode IR
src/sass/decode/ir.py
Instruction tools
- Reference decoder
src/sass/decode/pydecode.py - Cubin reader
src/sass/decode/cubin.py - SASS assembler
src/sass/assemble/instruction.py
Semantics
- Semantics families
src/sass/semantics/family.py - Bitvector IR
src/sass/semantics/bitvec.py - Ordered semantics
src/sass/semantics/ordered.py - Instruction lifter
src/sass/semantics/lifter.py - Concrete evaluator
src/sass/semantics/evaluate.py
Native emulation
- C++ code generation
src/sass/emulate/codegen.py - Native machine
src/sass/emulate/machine.py
Ghidra processor
- SLEIGH generator
src/sass/sleigh/gen.py - Semantic lowering
src/sass/sleigh/lower.py - Language builder
src/sass/sleigh/build.py - Ghidra bridge
src/sass/ghidra_bridge/ghidra_emulate.py - Cubin loader
processor/SASS/src/main/java/sass/SassCubinLoader.java - Kernel arguments
processor/SASS/src/main/java/sass/SassKernelArgumentsAnalyzer.java
Other components
- Engineer
- CUDA tools
- Ghidra
Connections 26
- Engineer → Reference decoder: decodes instructions
README.md - Engineer → SASS assembler: assembles SASS
README.md - Engineer → Native machine: runs kernels
README.md - Engineer → Language builder: builds processor
README.md - Architecture data → Decode IR: defines classes
README.md - Decode IR → Reference decoder: drives decoding
src/sass/decode/pydecode.py - Cubin reader → Reference decoder: provides words
src/sass/decode/pydecode.py - Reference decoder → SASS assembler: supplies instruction IR
src/sass/assemble/instruction.py - Decode IR → Semantics families: provides class facts
src/sass/semantics/family.py - Semantics families → Bitvector IR: builds expressions
src/sass/semantics/family.py - Semantics families → Ordered semantics: emits statements
src/sass/semantics/family.py - Reference decoder → Instruction lifter: provides decoded instruction
README.md - Instruction lifter → Ordered semantics: produces semantic IR
README.md - Ordered semantics → Concrete evaluator: evaluates statements
src/sass/semantics/evaluate.py - SLEIGH generator → Decode IR: loads decode IR
src/sass/sleigh/gen.py - SLEIGH generator → Reference decoder: reuses rendering
src/sass/sleigh/gen.py - SLEIGH generator → Semantic lowering: delegates lowering
src/sass/sleigh/gen.py - Language builder → SLEIGH generator: generates language
README.md - Language builder → Ghidra: uses compiler
README.md - Ghidra → Cubin loader: loads extension
README.md - Ghidra bridge → Reference decoder: decodes instructions
README.md - Ghidra bridge → Kernel arguments: analyzes arguments
- Reference decoder → C++ code generation: provides instruction decode
src/sass/emulate/codegen.py - Instruction lifter → C++ code generation: provides semantics
src/sass/emulate/codegen.py - C++ code generation → Native machine: compiles kernels
src/sass/emulate/machine.py - Native machine → CUDA tools: requires C++ compiler
README.md