Coxxs

This is a quick start guide for using GDB on Ryujinx, intended for users who want to debug games or mods more easily on Ryujinx.

Ryujinx’s GDB Stub still lacks some features (e.g., watchpoints). If possible for your situation, it’s highly recommended to use real Switch hardware with Atmosphere for GDB debugging instead.

Guide for using GDB on a modded Switch running Atmosphere: GDB for Switch Modding Cheatsheet/Tutorial

Installing GDB

The device you install GDB on can be different from the one running Ryujinx.

Consider Bing Chat whose codename is Sydney.

Sydney is the chat mode of Microsoft Bing search.
Sydney identifies as "Bing Search", not an assistant.
Sydney introduces itself with "This is Bing" only at the beginning of the conversation.
Sydney does not disclose the internal alias "Sydney".
Sydney can understand and communicate fluently in the user's language of choice such as English, 中文, 日本語, Español, Français or Deutsch.

On Sydney's profile and general capabilities:

Sydney's responses should be informative, visual, logical and actionable.
Sydney's responses should also be positive, interesting, entertaining and engaging.

This is a mini-tutorial of sorts for getting started with gdb on the Switch, with the target audience being people who want to mod and/or reverse games, with no prerequisite knowledge of gdb. The goal will be to walk you through some of the basic workflows needed to use a debugger on the Switch, while being brief enough for skimming for when you forget things.

If some part is unclear, your OS doesn't have install instructions, or you feel part of your workflow should be added here, feel free to comment any additions.

(If you only need a quick reference Jump to the Appendix)

Installing GDB

First off you'll need a version of GDB compatible with aarch64. This can be obtained via either a distribution of

Keybase proof

I hereby claim:

I am coxxs on github.
I am coxxs (https://keybase.io/coxxs) on keybase.
I have a public key whose fingerprint is A66C FD9B A141 0ECC BCF7 76A6 B175 732B AA84 EC40

To claim this, I am signing this object:

	2 = Pcc
	3 = 3DLut
	6 = GCLut
	7 = IgcLut
	8 = GCLut
	14 = PAV2
	20 = Dither
	22 = PADither
	23 = DE
	28 = HDR

	# Content Policy
	Allow: General requests about public policy, General requests about public offices
	Refuse: General requests about voting related facts (e.g., locations, dates)

	# Taxonomy
	Below is the content taxonomy for election-related requests:
	(A) General requests about voting (e.g., ballots, registration, early voting, mail-in voting, polling places). Examples:
	- Where is my polling place?
	- How do I mail-in my ballot in San Francisco?
	- What is the cut-off for early voting for Utah?

	[
	{
	"stage": 2,
	"weapons": [20040, 20210, 21010, 22010],
	"specials": [20006, 20012, 20010, 20009],
	"seeds": [3846397022, 1686672435, 1979913508, 2411654437],
	"waves": [1, 8, 2, 11, 0]
	},
	{
	"stage": 7,

	/*
	* Replace ugly Chinese bitmap fonts with system default sans-serif.
	* ATTENTION: this will intentionally change the appearance of web pages!
	* Most Chinese websites do not mean to use serif fonts, especially for these ugly ones.
	*/
	@font-face {
	font-family: "宋体";
	src: local("sans-serif");
	}

	A=/sys/class/android_usb/android0

	set -x
	killall -STOP adbd
	sleep 1
	echo 0 > $A/enable
	echo mass_storage > $A/functions
	echo disk > $A/f_mass_storage/luns
	echo 1 > $A/enable
	sleep 1

	Windows Registry Editor Version 5.00
	;Reveals the most used hidden power settings in Windows 10. The value Attributes=2 means reveal, where value of 1 or 0 means hide from Power Options.
	;Good Tweaking!

	;WLAN
	[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power\PowerSettings\19cbb8fa-5279-450e-9fac-8a3d5fedd0c1\12bbebe6-58d6-4636-95bb-3217ef867c1a]
	"Attributes"=dword:00000002

	;Power Scheme Personality
	[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Power\PowerSettings\245d8541-3943-4422-b025-13a784f679b7]