wiki: simplify stacktrace instructions and add outputting to file (#769)

This commit is contained in:
trianta 2024-09-07 09:47:03 -05:00 committed by GitHub
parent e76d199d92
commit 1c75fe8f08
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -48,18 +48,20 @@ Report an issue on GitHub or on the Discord server.
## Obtaining a debug stacktrace ## Obtaining a debug stacktrace
Systemd-only. > Systemd-only.
Build hyprland in debug (`make debug`) and run. Get it to crash. Then, in a tty or terminal, do 1. Build Hyprland in debug (`make debug`).
`coredumpctl debug Hyprland`. 2. Start Hyprland and get it to crash.
3. In a tty or terminal, do `coredumpctl debug Hyprland`.
If gdb asks you for symbols, say `y`, if it asks about paging, say `c`. - If gdb asks you for symbols, say `y`.
- If it asks about paging, say `c`.
Once you get to `(gdb)`, run `bt -full` and post the output. 4. Once you get to `(gdb)`, start file logging with `set logging on`.
- For a specific file, use `set logging file output.log`.
5. Run `bt -full`, then `exit` once finished, and attach the output.
## Obtaining a trace log ## Obtaining a trace log
launch Hyprland with `HYPRLAND_TRACE=1 AQ_TRACE=1` environment variables set. Launch Hyprland with `HYPRLAND_TRACE=1 AQ_TRACE=1` environment variables set.
These variables will enable _very_ verbose logging and it's not recommended to enable them unless debugging, as they These variables will enable _very_ verbose logging and it's not recommended to enable them unless debugging, as they
might cause slowdowns and _massive_ log files. might cause slowdowns and _massive_ log files.