3.8 KiB
Flatpak for TOrzu fork of the Yuzu Emulator
Torzu is an experimental Nintendo Switch emulator forked from Yuzu. For more information, please visit our Git repository.
To install the Flatpak version of the emulator, please visit the releases page.
Reporting Bugs
If you encounter any crashes or stability issues, please report them in the issues section of this repository.
When reporting, make sure to select the appropriate template and follow the instructions in the template.
Obtaining Necessary Information for Bug Reports
Since Yuzu is a complex piece of software, it's very difficult to pinpoint a specific issue. Providing necessary contextual information will help us determine the root cause of the problem you are experiencing.
Usually, yuzu's own log file will reveal the issue. Please see How to obtain the log file for information on how to collect the log file from your system.
Sometimes, yuzu's own log file is insufficient to determine the cause, especially if you are reporting a crash or a freeze. Ideally, we will able to reproduce the issue on our own machines. But there are times when we can't reproduce the crash or freeze on our own machines due to hardware differences. This would require you to provide a debugger trace. Obtaining a debugger trace is a bit complicated, so please bear with us:
Obtaining a debugger trace after the crash
- Install debuggers in Flatpak:
flatpak install org.kde.Sdk//5.15-23.08
- Install debug information for yuzu:
flatpak install onion.torzu_emu.torzu.Debug
- Execute this command in your terminal:
flatpak-coredumpctl onion.torzu_emu.torzu -m yuzu --gdb-arguments "--batch -ex 'thread apply all bt'" > /tmp/yuzu-backtrace.log
- Please attach the file
/tmp/yuzu-backtrace.log
file to your report
Obtaining a debugger trace as the crash happens
- Install debuggers in Flatpak:
flatpak install org.kde.Sdk//5.15-23.08
- Install debug information for yuzu:
flatpak install onion.torzu_emu.torzu.Debug
- Execute this command in your terminal:
flatpak run --devel --command=sh onion.torzu_emu.torzu
- Type
gdb /app/bin/yuzu
in the coming up prompt and wait for the(gdb)
prompt to show up - Type r and hit Enter to launch yuzu under the debugger
- Before loading your game:
- Go to
Emulation
->Configure ...
menu: - Choose
General
on the left-sidebar, then chooseDebug
tab on the right panel. And then, select theCPU
tab on the second-level panel, you will see theToggle CPU optimizations
options. Please uncheck both the Enable Host MMU Emulation (general memory instructions) and Enable Host MMU Emulation (exclusive memory instructions) checkboxes (as those would interfere with the debugger) - Then go to the
Debug
tab and check theEnable CPU Debugging
checkbox and click theConfirm
button at the buttom of the dialog.
- Go to
- Load the game that caused the crash and repeat the steps you think that may have crashed or freezed yuzu
- When the crash or freeze happens, switch back to the terminal and type
bt
at the(gdb)
prompt - If
gdb
asks--Type <RET> for more, q to quit, c to continue without paging--
, type c to show all the output - Copy and paste all the output to a new text file, and attach this file to your report
- Type q to kill both the debugger and crashed yuzu
- (Optional) You might want to undo step (6) to avoid performance penalty after this process