anycore-dbg-supplement 0.0.4

A bundle of auxiliary scripts for the Anycore project

Pre-Simulation readiness checking

• Checkpointing/SyscallAnalysis/prerun_check.py - Perform a prerun check based on the info in manifest DB.
• Checkpointing/SyscallAnalysis/generate_manifest.py - Analyze the System Call trace for an entire SPEC simulation (dumped by a special version of spike). Then produce the manifest for it. Finally save the manifest into DB.

Misc.

• SpecResultVerification/spike_trim.py - Trim out the extra header/tail message produced by spike or pk during the simulation. Useful if you want to automatically verify the STDOUT output of a SPEC simulation.
• Checkpointing/ChkptDescFileGen/smpt2ckptdesc.py - Convert the Simpoint output file to the checkpoint job description file accepted by Spike.
• Checkpointing/DumpHTIF/chkpt_htif_dump.py - Show the HTIF syscalls recorded in a checkpoint file. When restoring a checkpoint, those syscalls will be executed in sequence to bring back the state of HTIF FESVR.
• TetherSim/SimTetheringController.py - Controller for 721sims working in tethering mode.

To work with trace dump

• CpuTraceAnalysis/trace2google.py - Analyze the trace dumped by spike or 721sim and output the result in Google's Trace Event Format.

• To visualize the result, use speedscope (recommend) or Chromium's about://tracing .

  • if ignore_symbol.yaml exists in CWD, it will be read to filter out the defined function calls. See CpuTraceAnalysis/ignore_symbol.yaml for an example.

• CpuTraceAnalysis/trace2tracevis.py - Analyze and visualize the trace dumped by spike or 721sim in a homebrew timeline frontend (using timeline-js).

  • if ignore_symbol.yaml exists in CWD - Will be read to filter out the defined function calls. See CpuTraceAnalysis/ignore_symbol.yaml for an example.
  • It's recommended to use trace2google.py. Because the trace_vis frontend uses timeline-js, which is not intended for visualizing tracing result, it can be very slow and unresponsive when working with trace with a large amount of event.

Viewing the trace2google.py output with speedscope

Viewing the trace2google.py output with Chrome's about:tracing

Viewing the trace using homebrew TraceVis frontend (use timeline-js)

WIP.