Plexi09/eden-miror
1
0
Fork 0
mirror of https://git.eden-emu.dev/eden-emu/eden synced 2026-06-04 07:17:12 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
eden-miror/docs/Debug.md
xbzk ec2b9b0400
Some checks are pending
tx-src / sources (push) Waiting to run
Details
Check Strings / check-strings (push) Waiting to run
Details
[vk, renderdoc] fixed zero-sized streambuffer bug on old heap-absent GPUs (#4052) 
This fix a bug in which eden crashes when renderdoc is attached to vulkan.
that kept me away from renderdoc for around a year now.

the bug:

in video_core\renderer_vulkan\vk_staging_buffer_pool.cpp
in GetStreamBufferSize(...)
if device.HasDebuggingToolAttached()
but heap is empty/unavailable <-- Case in my old nvidia kepler gpu

the original method returns size 0, right?
the change honors same original behavior, while covers my case properly, returning MAX_STREAM_BUFFER_SIZE.

addl some log tip and some minimal doc. fully safe. let it rip.

Reviewed-on: https://git.eden-emu.dev/eden-emu/eden/pulls/4052
Reviewed-by: MaranBr <maranbr@eden-emu.dev>
Reviewed-by: Lizzie <lizzie@eden-emu.dev>
2026-06-03 05:02:13 +02:00

3.4 KiB
Raw Blame History

Debug Guidelines

Issue reports

When reporting issues or finding bugs, we often need backtraces, debug logs, or both in order to track down the issue.

Graphics Debugging

If your bug is related to a graphical issue--e.g. mismatched colors, vertex explosions, flickering, etc.--then you are required to include graphical debugging logs in your issue reports.

Graphics Debugging is found in General -> Debug on desktop, and Advanced Settings -> Debug on Android. Android users are all set; however, desktop users may need to install the Vulkan Validation Layers:

  • Windows: Install the Vulkan SDK
  • Linux, BSD, etc: Install vulkan-validation-layers, vulkan-layers, or similar from your package manager. It should be located in e.g. /usr/lib64/libVkLayer_khronos_validation.so

Once Graphics Debugging is enabled, run the problematic game again and continue. Note that the game may run extremely slow on weak hardware.

Debug Logs

Debug logs can be found in General -> Debug -> Open Log Location on desktop, and Share Debug Logs on Android. This MUST be included in all bug reports, except for certain UI bugs--but we still highly recommend them even for UI bugs.

Debugging (host code)

Ignoring SIGSEGV when debugging in host:

  • gdb: handle SIGSEGV nostop pass.
  • lldb: pro hand -p true -s false -n false SIGSEGV.

Debugging (guest code)

gdb

You must have GDB installed for aarch64 to debug the target. Install it through your package manager, e.g.:

  • On Arch:
    • sudo pacman -Syu aarch64-linux-gnu-gdb
  • On Gentoo:
    • sudo emerge --ask crossdev
    • sudo crossdev -t aarch64-unknown-linux-gnu --ex-gdb

Run ./build/bin/eden-cli -c <path to your config file (see logs where you run eden normally to see where it is)> -d -g <path to game>, or Enable GDB Stub at General > Debug, then hook up an aarch64-gdb:

  • target remote localhost:6543

Type c (for continue) and then if it crashes just do a bt (backtrace) and layout asm

gdb cheatsheet

  • mo <cmd>: Monitor commands, get info, get fastmem and get mappings are available. Type mo help for more info.
  • detach: Detach from remote (i.e restarting the emulator).
  • c: Continue
  • p <expr>: Print variable, p/x <expr> for hexadecimal.
  • r: Run
  • bt: Print backtrace
  • info threads: Print all active threads
  • thread <number>: Switch to the given thread (see info threads)
  • layout asm: Display in assembly mode (TUI)
  • si: Step assembly instruction
  • s or step: Step over LINE OF CODE (not assembly)
  • display <expr>: Display variable each step.
  • n: Next (skips over call frame of a function)
  • frame <number>: Switches to the given frame (from bt)
  • br <expr>: Set breakpoint at <expr>.
  • delete: Deletes all breakpoints.
  • catch throw: Breakpoint at throw. Can also use br __cxa_throw
  • br _mesa_error: Break on mesa errors (set environment variable MESA_DEBUG=1 beforehand), see MESA_DEBUG.

Expressions can be variable_names or 1234 (numbers) or *var (dereference of a pointer) or *(1 + var) (computed expression).

For more information type info gdb and read the man page.

RenderDoc (Graphic Debugging Tool)

Guidelines for graphical debugging using RenderDoc: RenderDoc usage