Start gdb-multiarch and connect to the Switch/Yuzu GDB stub. This MUST be called before any other tool. Connects to the IP/port configured via SWITCH_IP and SWITCH_PORT environment variables (defaults: 192.168.1.235:22225). Automatically loads Switch debug commands, attaches to the game, and sets $main to the base address of cross2_Release.nss. Do NOT manually run 'target remote', 'attach', or 'set $main' — this tool handles all of that.

Stop the gdb-multiarch session and disconnect from Yuzu.

Execute a raw GDB command (CLI or MI). For Switch-specific operations, prefer the dedicated switch_* tools. IMPORTANT: Do NOT use 'target remote' or 'target extended-remote' — the session auto-connects to the Switch on first use. Do NOT use 'attach' or 'monitor wait application' — handled automatically. $main is already set to the base address of the game executable.

Get the current status of the GDB session.

Get information about all threads.

Select a specific thread.

Get the stack backtrace (standard GDB backtrace).

Select a specific stack frame.

Get information about the current stack frame.

Set a breakpoint at a function, file:line, or *address. For offset-from-main breakpoints, use switch_break_at instead.

List all breakpoints with structured data.

Delete a breakpoint by number.

Enable a breakpoint by number.

Disable a breakpoint by number.

Continue execution until next breakpoint or completion. Only use when program is PAUSED.

Step into the next instruction.

Step over to the next line.

Interrupt (pause) a running program.

Evaluate a C/C++ expression.

Get local variables for a stack frame.

Get CPU register values.

Call a function in the target process. WARNING: executes code in the debugged program.

Set a breakpoint at an offset relative to the base of main ($main). Example: offset '0x3a5f10' sets a breakpoint at $main+0x3a5f10.

NOP the instruction at the given offset from main. Writes ARM64 NOP (0xD503201F) at $main+offset.

Stub the function at the given offset from main. Writes ARM64 RET (0xD65F03C0) at $main+offset, making the function return immediately.

Replace the instruction at an offset from main with a new instruction. Offset and instruction are both hex values.

Get the current PC as an offset relative to the base of main.

Convert an absolute address or register value to an offset relative to the base of main. Example: address '$x0' or '0x8012345'.

Print the backtrace as absolute addresses by walking the frame pointer chain. Often misses the first address — use 'p/x $lr' for that.

Print the backtrace with offsets relative to the base of main. Walks the frame pointer chain and resolves each return address to a module-relative offset.

Combined trace: runs get_pc, localize $lr, and my_bt2 in one command. Returns the current PC offset, calling offset, and full backtrace with offsets relative to main.

Print a hex dump (xxd-style) of memory at the given address.

Dump the original instructions at an offset (4 instructions / 16 bytes) as 'replace' commands, so you can restore them after hooking.