mirror of
https://github.com/hyprwm/Hyprland
synced 2024-11-22 21:45:58 +01:00
71 lines
2.5 KiB
Markdown
71 lines
2.5 KiB
Markdown
# Issue Guidelines
|
|
|
|
First of all, please remember to:
|
|
- Check that your issue is not a duplicate
|
|
- Read the [FAQ](https://github.com/vaxerski/Hyprland/wiki/FAQ)
|
|
- Read the [Configuring Page](https://github.com/vaxerski/Hyprland/wiki/Configuring-Hyprland)
|
|
|
|
<br/>
|
|
|
|
# Reporting suggestions
|
|
Suggestions are welcome.
|
|
|
|
Many features can be implemented using bash scripts and Hyprland sockets, read up on those [Here](https://github.com/vaxerski/Hyprland/wiki/IPC). Please do not suggest features that can be implemented as such.
|
|
|
|
<br/>
|
|
|
|
# Reporting bugs
|
|
|
|
All bug reports should have the following:
|
|
- Steps to reproduce
|
|
- Expected outcome
|
|
- Noted outcome
|
|
|
|
If your bug is one that doesn't crash Hyprland, but feels like invalid behavior, that's all you need to say.
|
|
|
|
If your bug crashes Hyprland, append additionally:
|
|
- The Hyprland log
|
|
- Coredump / Coredump analysis (with a stacktrace)
|
|
- Your config
|
|
|
|
**Important**: Please do NOT use any package for reporting bugs! Clone and compile from source.
|
|
|
|
## Obtaining the Hyprland log
|
|
If you are in a TTY, and the hyprland session that crashed was the last one you launched, the log will be printed with
|
|
```
|
|
cat /tmp/hypr/$(ls -t /tmp/hypr/ | head -n 1)/hyprland.log
|
|
```
|
|
feel free to send it to a file, save, copy, etc.
|
|
|
|
if you are in a Hyprland session, and you want the log of the last session, use
|
|
```
|
|
cat /tmp/hypr/$(ls -t /tmp/hypr/ | head -n 2 | tail -n 1)/hyprland.log
|
|
```
|
|
|
|
basically, directories in /tmp/hypr are your sessions.
|
|
|
|
## Obtaining the Hyprland coredump
|
|
If you are on systemd, you can simply use
|
|
```
|
|
coredumpctl
|
|
```
|
|
then go to the end (press END on your keyboard) and remember the PID of the last `Hyprland` occurrence. It's the first number after the time, for example `2891`.
|
|
|
|
exit coredumpctl (ctrl+c) and use
|
|
```
|
|
coredumpctl info [PID]
|
|
```
|
|
where `[PID]` is the PID you remembered.
|
|
|
|
## Obtaining the debug Hyprland coredump
|
|
In very rare cases, the normal coredump would not be enough.
|
|
If that's the case, you could try obtaining the debug coredump.
|
|
1. [Compile Hyprland with debug mode](http://wiki.hyprland.org/Contributing-and-Debugging/#build-in-debug-mode)
|
|
> Note: The config file used will be `hyprlandd.conf` instead of `hyprland.conf`
|
|
|
|
2. Reproduce the crash in debug mode.
|
|
3. `env DEBUGINFOD_URLS="https://debuginfod.archlinux.org/" coredumpctl debug [PID]`(see section above)
|
|
4. Wait until the `(gdb)` appears
|
|
5. If gdb asks you `press y to continue without paging?` Type `y`
|
|
6. `bt -full`
|
|
7. copy the output of the command and provide that.
|