pyr0ball
d7c41f07fe
Real-world trigger: libQt6PrintSupport.so.6 missing from CheatEngine portable binary on Linux Mint 22.3. Windows/macOS migrants double-click a binary, nothing happens, and they have no idea why — the dynamic linker error goes to journald silently. Robin catches 'cannot open shared object file: No such file or directory' in journald and explains the Linux shared library model, pointing to the right package manager command (apt/pacman/dnf/zypper) per distro family. Also documents why 'pip install pyqt6' doesn't fix system library errors. Added to 23 pattern files covering all source OS / target distro family combinations.
146 lines
6.9 KiB
TOML
146 lines
6.9 KiB
TOML
[meta]
|
|
source_os = "linux"
|
|
target_distro_family = "fedora"
|
|
|
|
# Arch/Manjaro/EndeavourOS user moving to Fedora.
|
|
# Body text assumes pacman, AUR, and rolling release familiarity.
|
|
|
|
[log_paths]
|
|
steam = "~/.local/share/Steam/logs/content_log.txt"
|
|
proton = "~/.local/share/Steam/logs/proton_log.txt"
|
|
|
|
# ── DNF / RPM ────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "dnf-lock"
|
|
sources = ["journald"]
|
|
match_text = "Another app is currently holding the dnf lock"
|
|
severity = "warn"
|
|
title = "DNF package manager is locked"
|
|
body = "dnf-automatic (Fedora's equivalent of Arch's unattended auto-updates, though Arch doesn't do auto-updates) is probably running. Wait it out or: sudo ps aux | grep dnf"
|
|
|
|
[[patterns]]
|
|
id = "dnf-dep-conflict"
|
|
sources = ["journald"]
|
|
match_text = "conflicts with"
|
|
severity = "warn"
|
|
title = "Package dependency conflict"
|
|
body = "Unlike pacman where you resolve conflicts manually, dnf tries to auto-resolve. It usually succeeds. If not: sudo dnf distro-sync — the Fedora equivalent of pacman -Syu for bringing the system fully in sync."
|
|
|
|
[[patterns]]
|
|
id = "dnf-gpg-key"
|
|
sources = ["journald"]
|
|
match_text = "GPG key retrieval failed"
|
|
severity = "warn"
|
|
title = "Repository GPG key missing"
|
|
body = "Import the key: sudo rpm --import /path/to/key.gpg — or re-run with: sudo dnf install --nogpgcheck (only if you trust the source). RPM Fusion keys are imported automatically when you enable the repo."
|
|
|
|
# ── SELinux (new concept for Arch users) ─────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "selinux-denial"
|
|
sources = ["journald"]
|
|
match_text = "type=AVC"
|
|
severity = "info"
|
|
title = "SELinux access denied"
|
|
body = "Fedora ships SELinux enforcing by default — there's nothing like this on Arch by default. A security policy is blocking an action. Check what's blocked: ausearch -m AVC -ts recent — get a fix suggestion: sealert -a /var/log/audit/audit.log — don't just set SELinux to permissive; that defeats the security model."
|
|
|
|
[[patterns]]
|
|
id = "selinux-context-wrong"
|
|
sources = ["journald"]
|
|
match_text = "restorecon"
|
|
severity = "info"
|
|
title = "SELinux file context mismatch"
|
|
body = "A file has the wrong security label — common when copying files from an Arch system or an external drive. Fix: sudo restorecon -Rv /path/to/file"
|
|
|
|
# ── System ────────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "kernel-driver-firmware"
|
|
sources = ["kmsg"]
|
|
match_text = "firmware: failed to load"
|
|
severity = "warn"
|
|
title = "Firmware file missing"
|
|
body = "sudo dnf install linux-firmware — same coverage as Arch's linux-firmware package. Some chips may need RPM Fusion nonfree: sudo dnf install rpmfusion-nonfree-release-$(rpm -E %fedora)"
|
|
|
|
[[patterns]]
|
|
id = "oom-killer"
|
|
sources = ["kmsg"]
|
|
match_text = "Out of memory: Kill process"
|
|
severity = "warn"
|
|
title = "OOM killer fired"
|
|
body = "A process was killed for RAM. Fedora enables zswap by default on modern releases. If you used zram on Arch, install zram-generator: sudo dnf install zram-generator"
|
|
|
|
[[patterns]]
|
|
id = "disk-io-error"
|
|
sources = ["kmsg"]
|
|
match_text = "Buffer I/O error on device"
|
|
severity = "warn"
|
|
title = "Disk I/O error"
|
|
body = "Check SMART: sudo smartctl -a /dev/sdX — install: sudo dnf install smartmontools"
|
|
|
|
# ── Audio ─────────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "pipewire-connect-fail"
|
|
sources = ["journald"]
|
|
match_text = "Failed to connect to PipeWire"
|
|
severity = "warn"
|
|
title = "PipeWire not responding"
|
|
body = "Both Arch and Fedora ship PipeWire. Restart: systemctl --user restart pipewire pipewire-pulse wireplumber"
|
|
|
|
[[patterns]]
|
|
id = "bluetooth-rfkill-blocked"
|
|
sources = ["journald"]
|
|
match_text = "Blocked through rfkill"
|
|
severity = "warn"
|
|
title = "Bluetooth rfkill blocked"
|
|
body = "rfkill unblock bluetooth — same as Arch."
|
|
|
|
# ── GPU / display ─────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "gpu-hang"
|
|
sources = ["kmsg"]
|
|
match_text = "GPU HANG"
|
|
severity = "warn"
|
|
title = "GPU hang"
|
|
body = "GPU stopped responding. For NVIDIA on Fedora, RPM Fusion is the right source: sudo dnf install akmod-nvidia — unlike Arch's nvidia-dkms from the official repos."
|
|
|
|
[[patterns]]
|
|
id = "xwayland-crash"
|
|
sources = ["journald"]
|
|
match_text = "XWayland server terminated unexpectedly"
|
|
severity = "warn"
|
|
title = "XWayland crashed"
|
|
body = "X11 apps dead until session restart. Fedora GNOME defaults to Wayland like Arch KDE/GNOME can."
|
|
|
|
# ── Network ───────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "networkmanager-activation-fail"
|
|
sources = ["journald"]
|
|
match_text = "Activation failed"
|
|
severity = "info"
|
|
title = "NetworkManager: connection failed"
|
|
body = "nmcli device status — same NetworkManager as Arch. Firmware issues: sudo dmesg | grep firmware"
|
|
|
|
# ── Gaming ────────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "proton-runtime-missing"
|
|
sources = ["applog:proton"]
|
|
match_text = "wine: cannot find"
|
|
severity = "warn"
|
|
title = "Proton runtime issue"
|
|
body = "Right-click game in Steam -> Properties -> Local Files -> Verify integrity. Steam on Fedora: sudo dnf install steam (from RPM Fusion free)."
|
|
|
|
# ── Dynamic linker / shared libraries ────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "missing-shared-library"
|
|
sources = ["journald"]
|
|
match_text = "cannot open shared object file: No such file or directory"
|
|
severity = "warn"
|
|
title = "App is missing a system library"
|
|
body = "This program needs a shared library that isn't installed. On Linux, apps use shared system libraries rather than bundling their own — unlike Windows .exe files. Find the right package: dnf provides 'libname.so.6'. Or search: dnf search libname. Install it: sudo dnf install packagename. Note: pip and pip3 cannot fix this — Python packages are not system libraries."
|