How rach-kaplin/m.a.r.s. works
M.A.R.S. is a command-line microarchitecture research tool: users configure active hardware probes, run selected measurements, and receive a CPU-characteristics summary. The application registers enabled measurers, a probe service coordinates them against shared result data, and the summary printer presents the findings. Measurement modules probe distinct cache, translation, execution, and branch-prediction properties; platform services provide architecture-specific timing, operating-system controls, performance counters, and event discovery. Several measurement implementations and application call sites were not excerpted, so those links are marked unverified rather than inferred as confirmed calls.
Main entry points: measurer_registry.hpp Measurer Registry · cpu_info_data.hpp CPU Measurement Results · application.cpp Application Runner · exec_ports_measurer.cpp Execution Ports
Components 23
Application
- CLI Entry
src/cli/main.cpp - Configuration
src/app/config_loader.cpp - Application Runner
src/app/application.cpp - Measurer Registry
include/core/measurer_registry.hpp - Probe Service
include/core/probe_service.hpp - Logging
include/infra/logging.hpp
Hardware Probes
- Cache Sizing
src/measurement/cache/cache_measurer.cpp - TLB Sizing
src/measurement/tlb/tlb_measurer.cpp - ROB Sizing
src/measurement/rob/rob_measurer.cpp - Execution Ports
src/measurement/exec_ports/exec_ports_measurer.cpp - Uop Cache
src/measurement/uops_cache/uops_cache_measurer.cpp - Branch Target Buffer
src/measurement/branch_target_buffer/branch_target_buffer_measurer.cpp - Branch History
src/measurement/branch_history_table/branch_history_table_measurer.cpp - Return Stack
src/measurement/return_address_stack/return_address_stack_measurer.cpp - Store-Load Forwarding
src/measurement/store_to_load_forwarding/store_to_load_forwarding_measurer.cpp - Write Buffer
src/measurement/write_buffer/write_buffer_measurer.cpp
Platform Services
- CPU Architecture
src/platform/detail/arch_x86.cpp - OS Measurement Controls
src/platform/linux/os_linux.cpp - Event Discovery
src/platform/linux/events_discovery_linux.cpp - Performance Counters
src/platform/linux/pmc_linux.cpp
Results
- CPU Measurement Results
include/shared_types/cpu_info_data.hpp - Summary Printer
include/core/summary_printer.hpp
Other components
- Researcher
Connections 38
- Researcher → CLI Entry: starts
- CLI Entry → Configuration: loads options
- CLI Entry → Application Runner: starts
src/cli/main.cpp - Application Runner → Measurer Registry: registers probes
src/app/application.cpp - Application Runner → Probe Service: runs probes
src/app/application.cpp - Application Runner → Summary Printer: prints summary
src/app/application.cpp - Application Runner → Logging: configures logging
src/app/application.cpp - Probe Service → Measurer Registry: gets measurers
include/core/probe_service.hpp - Measurer Registry → Cache Sizing: registers
- Measurer Registry → TLB Sizing: registers
- Measurer Registry → ROB Sizing: registers
- Measurer Registry → Execution Ports: registers
- Measurer Registry → Uop Cache: registers
- Measurer Registry → Branch Target Buffer: registers
- Measurer Registry → Branch History: registers
- Measurer Registry → Return Stack: registers
- Measurer Registry → Store-Load Forwarding: registers
- Measurer Registry → Write Buffer: registers
- Cache Sizing → CPU Measurement Results: writes results
- TLB Sizing → CPU Measurement Results: writes results
- ROB Sizing → CPU Measurement Results: writes results
- Execution Ports → CPU Measurement Results: writes results
- Uop Cache → CPU Measurement Results: writes results
- Branch Target Buffer → CPU Measurement Results: writes results
- Branch History → CPU Measurement Results: writes results
- Return Stack → CPU Measurement Results: writes results
- Store-Load Forwarding → CPU Measurement Results: writes results
- Write Buffer → CPU Measurement Results: writes results
- Summary Printer → CPU Measurement Results: reads results
include/core/summary_printer.hpp - Cache Sizing → CPU Architecture: uses timing
- TLB Sizing → OS Measurement Controls: uses controls
- Execution Ports → Event Discovery: discovers events
- Execution Ports → Performance Counters: reads counters
- Branch Target Buffer → CPU Architecture: generates probes
- Uop Cache → Event Discovery: discovers events
- Uop Cache → Performance Counters: reads counters
- Write Buffer → Event Discovery: discovers events
- Write Buffer → Performance Counters: reads counters