How gem5/gem5 works
gem5 is a modular computer-system simulator used to evaluate hardware designs and system software. The principal workflow is to configure a simulated system, instantiate its SimObjects, and execute simulation; Python configuration and the C++ configuration manager are visible, but the standard runtime entry point was not sampled, so that connection is shown as unverified. The graph also preserves processor, GPU, memory-coherence, power-model, and optional SystemC capabilities. Relationships are limited to README statements and source-index references or excerpts; unsampled subsystems are not treated as inspected.
Main entry points: logic.h McPAT logic models · sc_object_manager.cpp SystemC object manager · basic_circuit.h CACTI circuit model · cxx_manager.cc C++ config manager
Components 31
Configuration
- Example configurations
configs - Parameter types
src/python/m5/params/__init__.py - SimObject definitions
src/python/m5/SimObject.py - Parameter proxies
src/python/m5/proxy.py
Simulation core
- Simulation runtime
src/sim/main.cc - C++ config runner
util/cxx_config/main.cc - C++ config manager
src/sim/cxx_manager.cc - Statistics storage
src/base/stats/storage.cc
Compute models
- Minor CPU pipeline
src/cpu/minor/pipeline.cc - GPU global memory
src/gpu-compute/global_memory_pipeline.cc - GPU scalar memory
src/gpu-compute/scalar_memory_pipeline.cc
Memory and I/O
- GPU SDMA engine
src/dev/amdgpu/sdma_engine.cc - PCI copy engine
src/dev/pci/copy_engine.cc - Memory backdoors
src/mem/backdoor_manager.cc - Ruby controller
src/mem/ruby/slicc_interface/AbstractController.cc - Ruby TBE storage
src/mem/ruby/structures/TBEStorage.cc
Analysis and integration
- McPAT I/O model
ext/mcpat/iocontrollers.cc - McPAT logic models
ext/mcpat/logic.h - CACTI circuit model
ext/mcpat/cacti/basic_circuit.h - CACTI interface
ext/mcpat/cacti/cacti_interface.h - CACTI constants
ext/mcpat/cacti/const.h - CACTI parameters
ext/mcpat/cacti/parameter.h - McPAT components
ext/mcpat/basic_components.h - McPAT XML parser
ext/mcpat/xmlParser.h - SystemC object manager
ext/systemc/src/sysc/kernel/sc_object_manager.cpp - SystemC objects
ext/systemc/src/sysc/kernel/sc_object.h - SystemC processes
ext/systemc/src/sysc/kernel/sc_process.h - SystemC kernel IDs
ext/systemc/src/sysc/kernel/sc_kernel_ids.h - SystemC hash utility
ext/systemc/src/sysc/utils/sc_hash.h - SystemC embedding
util/systemc/gem5_within_systemc/main.cc
Other components
- Simulator user
Connections 24
- Simulator user → Example configurations: selects setup
README.md - Simulator user → C++ config runner: runs configuration
- Example configurations → Simulation runtime: configures simulation
- Parameter types → Parameter proxies: supports proxies
src/python/m5/proxy.py - C++ config runner → C++ config manager: constructs objects
util/cxx_config/main.cc - C++ config manager → SimObject definitions: configures objects
src/sim/cxx_manager.cc - Minor CPU pipeline → Statistics storage: records statistics
- GPU global memory → GPU scalar memory: coordinates memory
- GPU SDMA engine → Memory backdoors: issues memory writes
src/dev/amdgpu/sdma_engine.cc - Ruby controller → Ruby TBE storage: uses transaction storage
- McPAT I/O model → McPAT components: uses components
- McPAT I/O model → McPAT logic models: uses logic models
ext/mcpat/iocontrollers.cc - McPAT logic models → CACTI circuit model: uses circuit model
ext/mcpat/logic.h - McPAT logic models → CACTI interface: uses interface
ext/mcpat/logic.h - McPAT logic models → CACTI constants: uses constants
ext/mcpat/logic.h - McPAT logic models → CACTI parameters: uses parameters
ext/mcpat/logic.h - McPAT logic models → McPAT XML parser: uses parser
ext/mcpat/logic.h - CACTI circuit model → CACTI interface: references interface
ext/mcpat/cacti/basic_circuit.h - CACTI circuit model → CACTI constants: references constants
ext/mcpat/cacti/basic_circuit.h - SystemC object manager → SystemC objects: manages objects
ext/systemc/src/sysc/kernel/sc_object_manager.cpp - SystemC object manager → SystemC kernel IDs: uses kernel IDs
ext/systemc/src/sysc/kernel/sc_object_manager.cpp - SystemC object manager → SystemC processes: references processes
ext/systemc/src/sysc/kernel/sc_object_manager.cpp - SystemC object manager → SystemC hash utility: uses hash table
ext/systemc/src/sysc/kernel/sc_object_manager.cpp - SystemC embedding → C++ config manager: configures simulation
util/systemc/gem5_within_systemc/main.cc