Debug Session

Set up and run lldb debugging sessions for FLEKS simulation code.

3|2|Updated Jul 5, 2023
One-click install
npx skills add https://github.com/SWMFsoftware/FLEKS --skill debug-session-swmfsoftware
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debug Session
Source: https://github.com/SWMFsoftware/FLEKS/tree/main/.agent/skills/debug-session
Command: npx skills add https://github.com/SWMFsoftware/FLEKS --skill debug-session-swmfsoftware

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of setting up and initiating debugging sessions for the FLEKS simulation code, whether using a graphical IDE like VS Code or command-line tools like lldb.

Core Features & Use Cases

  • VS Code Integration: Provides guidance on configuring VS Code for debugging FLEKS, including launch configurations and breakpoint setting.
  • Command-Line Debugging: Offers essential lldb commands and example usage for debugging directly from the terminal.
  • MPI Debugging: Outlines strategies for debugging parallel FLEKS runs across multiple MPI processes.
  • Use Case: When a FLEKS simulation produces unexpected results, this Skill helps you quickly set up a debug environment to step through the code, inspect variables, and identify the root cause of the issue.

Quick Start

Use the debug session skill to start an lldb debugging session in the run directory.

Frequently Asked Questions about Debug Session

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug FLEKS simulation code using VS Code?

Debugging FLEKS with VS Code involves configuring launch settings to initiate a session, set breakpoints, and inspect variables to identify the root cause of unexpected simulation results.

Can I debug MPI parallel FLEKS runs with lldb?

Debugging MPI parallel FLEKS runs with lldb is supported. The Skill outlines strategies for debugging across multiple MPI processes, including attaching to running processes and single-rank debugging.

What lldb commands are needed to start a debugging session in the run directory?

Starting an lldb debugging session in the run directory requires essential commands provided by the Skill, which facilitate attaching to processes and analyzing backtraces directly from the terminal.

How do I fix missing symbols and optimization issues during a debug session?

Addressing missing symbols and optimization issues during a debug session involves specific troubleshooting steps provided by the Skill to ensure accurate backtrace analysis and variable inspection for FLEKS.

Does the FLEKS debug session support attaching to running processes?

Attaching to running processes is supported by the FLEKS debug session. This allows you to inspect an active simulation and perform single-rank debugging for both serial and MPI parallel scenarios.

What is the best way to debug serial FLEKS simulation code?

The best way to debug serial FLEKS simulation code is by using VS Code or lldb to step through the code, inspect variables, and identify the root cause of unexpected results in a configured debug environment.