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.
147 lines
7.9 KiB
TOML
147 lines
7.9 KiB
TOML
[meta]
|
|
source_os = "android"
|
|
target_distro_family = "debian"
|
|
|
|
# Android user on their first Debian/Ubuntu/Mint install.
|
|
# Assumes NO terminal experience. Ubuntu/Mint are the recommended starting points
|
|
# for Android migrants because of automatic updates and GUI app stores (GNOME Software/Discover).
|
|
|
|
[log_paths]
|
|
steam = "~/.local/share/Steam/logs/content_log.txt"
|
|
proton = "~/.local/share/Steam/logs/proton_log.txt"
|
|
|
|
# ── Package management ────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "apt-lock"
|
|
sources = ["journald"]
|
|
match_text = "Could not get lock /var/lib/dpkg/lock"
|
|
severity = "warn"
|
|
title = "App installer is busy"
|
|
body = "The software installer (Ubuntu/Mint calls it 'apt') is already running — probably doing automatic background updates, similar to how Android apps update silently. Wait a minute and try again. If it's stuck: open a terminal and type: sudo rm /var/lib/dpkg/lock-frontend /var/lib/dpkg/lock — then: sudo dpkg --configure -a"
|
|
|
|
[[patterns]]
|
|
id = "dpkg-interrupted"
|
|
sources = ["journald"]
|
|
match_text = "dpkg was interrupted"
|
|
severity = "warn"
|
|
title = "App install was cut short"
|
|
body = "A previous install didn't finish cleanly — like pulling the charging cable out mid-update on your phone. Fix it: open a terminal and type: sudo dpkg --configure -a — then try your install again."
|
|
|
|
[[patterns]]
|
|
id = "apt-unmet-dependency"
|
|
sources = ["journald"]
|
|
match_text = "Unmet dependencies"
|
|
severity = "warn"
|
|
title = "App needs another app first"
|
|
body = "The software you're trying to install needs something else installed first — similar to a game on Android requiring Google Play Services. Let the installer fix it automatically: sudo apt --fix-broken install"
|
|
|
|
# ── Terminal basics ───────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "permission-denied"
|
|
sources = ["journald"]
|
|
match_text = "Permission denied"
|
|
severity = "info"
|
|
title = "Permission denied"
|
|
body = "Linux files and folders are protected by a permission system. If a command fails with this error, you may need to run it as admin — put 'sudo' before the command: sudo <command> — and enter your password. Your password won't show as you type, that's normal."
|
|
|
|
# ── AppArmor ──────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "apparmor-denial"
|
|
sources = ["journald"]
|
|
match_text = "apparmor=\"DENIED\""
|
|
severity = "info"
|
|
title = "App blocked by security policy"
|
|
body = "Ubuntu/Debian includes a security layer called AppArmor — like Android's app permissions system, but for the whole operating system. An app tried to do something outside its allowed permissions. Usually this resolves itself; if an app keeps failing, check: sudo aa-status"
|
|
|
|
# ── System ────────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "kernel-driver-firmware"
|
|
sources = ["kmsg"]
|
|
match_text = "firmware: failed to load"
|
|
severity = "warn"
|
|
title = "Hardware driver file missing"
|
|
body = "Some hardware needs a 'firmware' file — a small program that tells Linux how to talk to a specific chip. Install the main firmware package: sudo apt install firmware-linux linux-firmware — restart after. Ubuntu usually handles this automatically; you may see this on Debian."
|
|
|
|
[[patterns]]
|
|
id = "oom-killer"
|
|
sources = ["kmsg"]
|
|
match_text = "Out of memory: Kill process"
|
|
severity = "warn"
|
|
title = "System ran out of memory — closed an app"
|
|
body = "Linux had to close a program to free up memory — similar to Android killing background apps when RAM is full. If this keeps happening, try closing programs you're not using."
|
|
|
|
[[patterns]]
|
|
id = "disk-io-error"
|
|
sources = ["kmsg"]
|
|
match_text = "Buffer I/O error on device"
|
|
severity = "warn"
|
|
title = "Storage error"
|
|
body = "Something went wrong reading or writing to the drive. This is a hardware-level issue. Install a diagnostic tool: sudo apt install smartmontools — then check: sudo smartctl -a /dev/sda"
|
|
|
|
# ── Audio ─────────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "pipewire-connect-fail"
|
|
sources = ["journald"]
|
|
match_text = "Failed to connect to PipeWire"
|
|
severity = "warn"
|
|
title = "Sound system not responding"
|
|
body = "PipeWire is the audio manager — restart it: systemctl --user restart pipewire pipewire-pulse wireplumber — if that doesn't help, log out and back in."
|
|
|
|
[[patterns]]
|
|
id = "pulseaudio-connect-fail"
|
|
sources = ["journald"]
|
|
match_text = "Failed to connect to pulseaudio"
|
|
severity = "warn"
|
|
title = "Sound system not responding"
|
|
body = "The audio system (PulseAudio) stopped working. Restart it: pulseaudio --kill && pulseaudio --start — or log out and back in."
|
|
|
|
[[patterns]]
|
|
id = "bluetooth-rfkill-blocked"
|
|
sources = ["journald"]
|
|
match_text = "Blocked through rfkill"
|
|
severity = "warn"
|
|
title = "Bluetooth blocked by software switch"
|
|
body = "Run: rfkill unblock bluetooth — in a terminal. Like turning Airplane Mode off on your phone."
|
|
|
|
[[patterns]]
|
|
id = "cups-server-error"
|
|
sources = ["journald"]
|
|
match_text = "Unable to connect to CUPS server"
|
|
severity = "info"
|
|
title = "Printer service not running"
|
|
body = "The printing service isn't running. Unlike Android where you'd use a manufacturer app, Linux uses a universal print system called CUPS. Start it: sudo systemctl start cups && sudo systemctl enable cups"
|
|
|
|
# ── Network ───────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "networkmanager-activation-fail"
|
|
sources = ["journald"]
|
|
match_text = "Activation failed"
|
|
severity = "info"
|
|
title = "Wi-Fi connection failed"
|
|
body = "Couldn't connect to the network. Double-check the password, or try: nmcli device status — in a terminal to see your network devices."
|
|
|
|
# ── Media ─────────────────────────────────────────────────────────────────────
|
|
|
|
[[patterns]]
|
|
id = "missing-codec"
|
|
sources = ["journald"]
|
|
match_text = "GStreamer: Failed to find plugin"
|
|
severity = "info"
|
|
title = "Media format not supported"
|
|
body = "Linux doesn't include some video/audio formats by default for legal reasons — unlike Android which bundles them. Install them on Ubuntu/Mint: sudo apt install ubuntu-restricted-extras — this adds MP3, MP4, and other common formats."
|
|
|
|
# ── 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, most apps use shared system libraries rather than bundling their own — unlike Windows .exe files. Find the right package: apt-file search libname.so.6 (swap in the missing filename). Or search: apt-cache search libname. Install it: sudo apt install libpackagename. Note: pip and pip3 cannot fix this — Python packages are not system libraries."
|