General troubleshooting (Magyar)
Ez a cikk néhány általános hibaelhárítási módszert ismertet. Alkalmazásspecifikus problémák esetén kérjük, tekintse meg az adott program wikioldalát.
Általános eljárások
Rendkívül fontos, hogy mindig el legyenek olvasva a megjelenő hibaüzenetek. Néha nehéz lehet a megfelelő hibaüzenetekhez hozzájutni. (Például a grafikus felhasználói felülettel rendelkező alkalmazásoknál nehéz lehet hozzájutni a hibaüzenetekhez).
- Futtassa az alkalmazást parancssorban annak érdekében, hogy a kimenetet ellenőrizni lehessen.
- Ha továbbra sincs elég információ a hibakereséshez, akkor növelje a kimenet részletességét. (Általában ez az alkalmazás futtatásakor a
--verbose/-v/-Vvagy--debug/-dsegítségével érhető el). - Néha nincs ilyen paraméter az alkalmazás futtatásához, és a kimenet részletességének megnövelését direktívaként kell megadni az alkalmazás beállításfájljában.
- Egy alkalmazás naplófájlokat is használhat, amelyek általában a
/var/log,$HOME/.cachevagy$HOME/.localkönyvtárban találhatók. - Ha nincs mód a részletesség növelésére, akkor mindig van lehetőség a strace és hasonló programok futtatására.
- Ha továbbra sincs elég információ a hibakereséshez, akkor növelje a kimenet részletességét. (Általában ez az alkalmazás futtatásakor a
- Ellenőrizze a rendszernaplót. Lehetséges, hogy egy hiba nyomokat hagy a naplóban is, különösen amikor a hiba más alkalmazásoktól függ.
- A dmesg parancs a kernel gyűrűpufferéből (angolul: ring buffer) olvas. Ez akkor hasznos, amikor a számítógép adathordozója valamilyen okból nem érhető el, de ez hiányos naplókat is eredményezhet, mivel a kernel gyűrűpufferének a mérete nem végtelen. Ha lehetséges, akkor Ön használja a journalctl parancsot.
- A journalctl több szűrési lehetőséggel rendelkezik, mint a dmesg, és alapértelmezés szerint ember által olvasható időbélyegeket használ.
- Mindig érdemes kicsit beleolvasni a vonatkozó hibakövető rendszerekbe (angolul: issue trackers) annak érdekében, hogy kiderüljön, vannak-e már a felhasználók által beküldött hibajelentések. Lehetséges ugyanis, hogy már mások beküldték a nálunk is jelentkező hiba hibajelentését, és sokszor ott olvasható is lesz a probléma megoldása.
- A szoftver közvetlen fejlesztőinek (upstream-ek) választásától függően általában létezni szokott egy hibajegyző rendszer, és néha egy fórum is, vagy akár például egy IRC csatorna is szokott létezni.
- Létezik az Arch Linux bug tracker (ez, ahogy a neve is mondja, egy hibakövető rendszer az Arch Linux számára), amelyet elsősorban a szoftvercsomagolási hibákkal kapcsolatban kell használni.
További támogatás
Ha Önnek további segítségre van szüksége, akkor a kérdéseit felteheti a fórumban vagy a megfelelő IRC csatornán is.
Amikor Ön támogatást kér, akkor a teljes kimenetet/naplókat tegye közzé. Tehát ne csak azokat a dolgokat tegye közzé, amelyeket Ön lényegesnek tart. Az információforrások a következők:
- Bármely parancs teljes kimenetét tegye közzé. Tehát ne csak azokat a kimenetrészeket tegye közzé amelyeket Ön relevánsnak gondol, hanem egy az egyben az összes kimenetet tegye közzé.
- Tegye közzé a systemd naplóját (systemd journal).
- A bőségesebb kimenet érdekében használja a
systemd.log_level=debugboot paramétert. Ez hatalmas mennyiségű kimenetet fog előállítani, ezért csak akkor engedélyezze, amikor valóban szükség van rá. - Ne használja a
-xparamétert, mert ez feleslegesen zsúfolttá teszi a kimenetet és ezáltal a kimenet nehezebben lesz olvasható. - Használja a
-bkapcsolót, kivéve, ha Önnek a korábbi rendszerindításból származó naplókra van szüksége. Ennek hiánya rendkívül nagy méretű szövegbeillesztésekhez vezethet, amelyek akár a pastebin-re történő szövegfeltöltésekhez is túl nagyok lehetnek.
- A bőségesebb kimenet érdekében használja a
- Releváns beállításfájlok. (Ezek a releváns config fájlok.)
- Érintett illesztőprogramok (Ezek az érintett driver-ek.)
- Érintett szoftvercsomagok verziói.
- Kernel:
journalctl -kvagydmesg. (Mindkettő root jogosultságokkal). -
Xorg: A beállítástól függően a használt képernyőkezelő is releváns itt.
- Az
Xorg.logtöbb helyen is megtalálható lehet: A rendszernaplóban, a/var/log/könyvtárban vagy az$HOME/.local/share/xorg/könyvtárban. - Néhány képernyőkezelő (display manager), mint például a LightDM, a
Xorg.logfájlt is elhelyezheti a saját naplókönyvtárában.
- Az
- A pacman: Ha egy friss frissítés elrontott valamit, akkor nézze meg a
/var/log/pacman.logfájlban.- Hasznos lehet a pacman
--debugparaméterének a használata.
- Hasznos lehet a pacman
Az információk közzétételének egyik jobb módja a pastebin használata.
Ezután megjelenik egy link, amelyet Ön beilleszthet a fórumba vagy az IRC csatornán a beszélgetéshez.
Ezenkívül érdemes lehet áttekinteni a hogyan kell megfelelően jelenteni a problémákat című cikket, mielőtt kérdezne.
Boot problémák
A rendszerindítási (bootolási) problémák diagnosztizálásakor nagyon fontos tudni, hogy a rendszerindítás (bootolás) pontosan melyik szakaszban hibásodik meg.
- Firmware (UEFI vagy BIOS) szakasza
- Általában csak nagyon alapvető hibakeresési eszközökkel rendelkezik.
- Győződjön meg arról, hogy a Secure Boot (biztonságos rendszerindítás) le van tiltva.
- Ha a rendszerbetöltő (boot loader) nem található, akkor egy UEFI shell segíthet.
-
Boot loader szakasza
- Az egyik leggyakoribb dolog, amit itt csinálunk, az a kernelparaméterek módosítása.
- A rendszerbetöltési szakaszban (bootolási szakaszban) előforduló gyakori rendszerindítási problémákat (bootolási problémákat) az ACPI okozhatja.
-
initramfs szakasza
- Általában vészhelyzeti parancssort biztosít (emergency shell).
- A kiválasztott hookoktól függően vagy a dmesg, vagy a naplófájl érhető el benne.
- Tényleges rendszer szakasza
- Attól függően, hogy mennyire sérült a rendszer, elegendő lehet a hibakereső parncssor (debug shell) egyszerű meghívása.
Ha bármelyik szakasz által biztosított hibakereső segédprogramok nem elegendőek a hibás komponens megjavításához, akkor például próbáljon meg egy USB adathordozót a legújabb Arch Linux ISO lemezképfájllal használni.
Console messages
After the boot process, the screen is cleared and the login prompt appears, leaving users unable to read init output and error messages. This default behavior may be modified using methods outlined in the sections below.
Note that regardless of the chosen option, kernel messages can be displayed for inspection after booting by using journalctl -k or dmesg. To display all logs from the current boot use journalctl -b.
Flow control
This is basic management that applies to most terminal emulators, including virtual consoles (VC):
- Press
Ctrl+sto pause the output. - And
Ctrl+qto resume it.
This pauses not only the output, but also programs which try to print to the terminal, as they will block on the write() calls for as long as the output is paused. If your init appears frozen, make sure the system console is not paused.
To see error messages which are already displayed, see Getty#Have boot messages stay on tty1.
Printing more kernel messages
Most kernel messages are hidden during boot. You can see more of these messages by adding different kernel parameters. The simplest ones are:
-
debug, which has the following effects:- The kernel will raise its console logging level such that all messages in the kernel log buffer will be printed to the console. [1]
- systemd will raise its log level such that it will log debug messages that otherwise would not be produced anywhere. [2]
-
ignore_loglevel, which has the same effect on the kernel asdebugorloglevel=8(since debug messages are at7), but prevents the log level from being raised later in the boot.
Other parameters you can add that might be useful in certain situations are:
-
earlyprintk=vga,keepprints kernel messages very early in the boot process, in case the kernel would crash before output is shown. You must changevgatoefifor EFI systems. -
log_buf_len=16Mallocates a larger (16 MiB) kernel message buffer, to ensure that debug output is not overwritten.
Producing debug kernel messages
#Printing more kernel messages indicates how to print of the kernel log buffer to the console, but that buffer itself won't contain any messages it didn't already (aside from the debug systemd output). This heading discusses methods for getting more detailed information out of the kernel log.
Dynamic debugging
Messages printed with pr_debug or related functions such as dev_dbg(), drm_dbg(), and bt_dev_dbg() will not be produced unless you either:
- Modify the kernel source to define
DEBUGwhere desired. - Utilize the kernel's dynamic debug feature to enable debugging messages.
This section will discuss how to use dynamic debug, which is useful if you have already looked at your kernel log with everything up to informational logs, and would like even more debugging information from a particular location.
Firstly, you must be running a kernel that was compiled with the CONFIG_DYNAMIC_DEBUG kernel configuration option set. This is already the case for linux, so no action is required if you are using that kernel.
Then, you need to know where you want to see debug messages from. A couple of options are:
- Going with the kernel module name, if the issue seems to be isolated to a module. For example, to troubleshoot Intel graphics, you might concern yourself with the
i915DRM kernel module. - Going with a directory in the kernel that corresponds with functionality you are interested in. You will want to check out (or navigate online) the kernel source code to understand the structure. As an example, to inspect debug messages for all DRM kernel modules, you could go with the path drivers/gpu/drm.
Using that "source" of messages, you have to come up with a dynamic debug query that indicates which debug messages to enable, of the format:
match_type match_parameter flags
Where:
-
match_type is the type of match to make. Corresponding to the two options given earlier, this could be
moduleorfile. - match_parameter is the module or file path to watch. In the latter case, using asterisks for wildcards is permissible.
-
flags dictates what to do with the match. This could be
+pto start printing its messages, or-pto undo that.
Some examples of queries are:
-
module i915 +pto print debug messages from thei915kernel module. -
file drivers/gpu/drm/* +pto print debug messages from DRM drivers. -
file * +pto print debug messages.
Finally, to actually enact the query, you can either:
- Do so during runtime, by running:
# echo "query" > /sys/kernel/debug/dynamic_debug/control
- Do so at boot, by adding the
dyndbg="query"kernel parameter
This is a greatly simplified overview of dynamic debug's capabilities; see the documentation for further details.
Subsystem-specific debugging
There are also a number of separate debug parameters for enabling debugging in specific subsystems e.g. bootmem_debug, sched_debug. Also, initcall_debug can be useful to investigate boot freezes. (Look for calls that did not return.) Check the kernel parameter documentation for specific information.
netconsole
netconsole is a kernel module that sends all kernel log messages (i.e. dmesg) over the network to another computer, without involving user space (e.g. syslogd). Name "netconsole" is a misnomer because it is not really a "console", more like a remote logging service.
It can be used either built-in or as a module. Built-in netconsole initializes immediately after NIC cards and will bring up the specified interface as soon as possible. The module is mainly used for capturing kernel panic output from a headless machine, or in other situations where the user space is no more functional.
Be aware that you need to set the kernel options debug and ignore_loglevel for netconsole to send out kernel messages.
Helyreállító parancssorok
Helyreállító parancssorok (recovery shells). Getting an interactive shell at some stage in the boot process can help you pinpoint exactly where and why something is failing. There are several kernel parameters for doing so, but they all launch a normal shell which you can exit to let the kernel resume what it was doing:
-
rescuelaunches a shell shortly after the root file system is remounted read/write -
emergencylaunches a shell even earlier, before most file systems are mounted -
init=/bin/sh(as a last resort) changes the init program to a root shell.rescueandemergencyboth rely on systemd, but this should work even if systemd is broken.
Another option is systemd's debug-shell which adds a root shell on tty9 (accessible with Ctrl+Alt+F9). It can be enabled by either adding systemd.debug_shell to the kernel parameters, or by enabling debug-shell.service.
Debugging kernel modules
See Kernel modules#Obtaining information.
Debugging hardware
- You can display extra debugging information about your hardware by following udev#Debug output.
- Ensure that Microcode updates are applied on your system.
- To test the RAM, see Stress testing#Memtest86+.
- To see if your system is overheating, use lm_sensors.
- To check your storage health, see S.M.A.R.T.
Debugging freezes
Unfortunately, freezes are usually hard to debug and some of them take a lot of time to reproduce. There are some types of freezes which are easier to debug than others:
- Is sound still playing? If so, just the display may be frozen. This may be a problem with the video driver.
- Is the machine still responding? Try SSH if switching to another TTY does not work.
- Is the disk activity LED (if present) indicating that a lot is being written to disk? Heavy swapping may temporarily freeze the system. See this StackExchange answer for information about freezes on large writes.
If nothing else helps, try a clean shutdown. Pressing the power button once may unfreeze the system and show the classic "shutdown screen" which displays all the units that are getting stopped. Alternatively, using the magic SysRq keys may also help to achieve a clean shutdown. This is very important because the journal may contain hints why the machine froze. The journal may not be written to disk on an unclean shutdown. Hard freezes in which the whole machine is unresponsible are harder to debug since logs can not be written to disk in time.
Remote logging may help if the freeze does not permit writing anything to disk. A crude remote logging solution, which needs to be invoked from another device, can be used for basic debugging:
$ ssh freezing_host journalctl -f
Many fatal freezes in which the whole system does not respond anymore and require a forced shutdown may be related to buggy firmware, drivers or hardware. Trying a different kernel (see Kernel#Debugging regressions) or even a different Linux distribution or operating system, updating the firmware and running hardware diagnostics may help finding the problem.
If a freeze does not permit gathering any kind of logs or other information required for debugging, try reproducing the freeze in a live environment. If a graphical environment is required to reproduce the freeze or if the freeze can be reproduced on the archiso, use the live environment of a different distribution, which is preferably not based on Arch Linux to eliminate the possibility that the freeze is related to the version or patches of the kernel. Should the freeze still happen in a live environment, chances are that it may be hardware-related. If it does not happen anymore, it is necessary to be aware of the differences of both systems. Different configurations, differences in versions and kernel parameters and other, similar changes may have fixed the freeze.
However, a blinking caps lock LED may indicate a kernel panic. Some setups may not show the TTY when a kernel panic occurred, which may be confusing and can be interpreted as another kind of freeze.
Regressziók hibakeresése
If an update causes an issue but downgrading the specific package fixes it, it is likely a regression. If this happened after a normal full system upgrade, check your pacman.log to determine which package(s) may have caused the issue. The most important part of debugging regressions is checking if the issue was already fixed, as this can save much time. To do so, first ensure the application is fully updated (e.g. ensure the application is the same version as in the official repositories). If it already is or if updating it does not fix the issue, try using the development version, usually a VCS version, which may already be packaged in the AUR. If this fixes the issue and the version with the fixes is not yet in the official repositories, wait until the new version arrives in them and then switch back to it.
If the issue still persists, debug the issue and/or bisect the application and report the bug on the upstream bug tracker so it can be fixed.
Egyes perifériák nem használhatók a kernel frissítése után
This will manifest commonly (but probably not only) as:
- newly plugged USB devices showing up with dmesg but not in
/dev/, - file systems unable to be mounted if they were not already used before the kernel update,
- the inability to use a wired/wireless connection on a laptop if it was not already used before the kernel update,
-
FATAL: Module module not found in directory /lib/module/kernelversionwhen using modprobe to load a module that was not already used before the kernel package update.
As partially covered in System maintenance#Restart or reboot after upgrades, the kernel is not updated when you update the package but only once you reboot afterwards. Meanwhile, the kernel modules, located in /usr/lib/modules/kernelversion/ are removed by pacman when installing the new kernel. As explained in FS#16702, this approach avoids leaving files on the system not handled by the package manager but leads to the aforementioned symptoms. To fix them, reboot systematically after updating the kernel. The long-term evolution, yet to be implemented, will be to use versioned kernel packages : the main blocker being how to handle the removal of the previous kernel versions once they are not needed anymore.
Another solution is available as kernel-modules-hook, where two pacman hooks use rsync to keep the kernel modules on the file system after the kernel update and linux-modules-cleanup.service that marks the old modules for removal four weeks after once enabled.
Package management
See Pacman#Troubleshooting for general topics, and pacman/Package signing#Troubleshooting for issues with PGP keys.
Fixing a broken system
If a partial upgrade was performed, try updating your whole system. A reboot may be required.
# pacman -Syu
If you usually boot into a GUI and that is failing, perhaps you can press Ctrl+Alt+F1 through Ctrl+Alt+F6 and get to a working tty to run pacman through.
If the system is broken enough that you are unable to run pacman, boot using a monthly Arch ISO from a USB flash drive, an optical disc or a network with PXE. (Do not follow any of the rest of the installation guide.)
Mount your root file system:
# mount /dev/rootFileSystemDevice /mnt
Mount any other partitions that you created separately, adding the prefix /mnt to all of them, i.e.:
# mount /dev/bootDevice /mnt/boot
Try using your system's pacman while chrooted:
# arch-chroot -S /mnt # pacman -Syu
If that fails, exit the chroot, and try:
# pacman -Syu --sysroot /mnt
If that fails, try:
# pacman -Syu --root /mnt --cachedir /mnt/var/cache/pacman/pkg
fuser
fuser is a command-line utility for identifying processes using resources such as files, file systems and TCP/UDP ports.
fuser is provided by the psmisc package, which should be already installed as a dependency of the base meta package. See fuser(1) for details.
Session permissions
/usr/lib/udev/rules.d/70-uaccess.rules and [5])First, make sure you have a valid local session within X:
$ loginctl show-session $XDG_SESSION_ID
This should contain Remote=no and Active=yes in the output. If it does not, make sure that X runs on the same tty where the login occurred. This is required in order to preserve the logind session.
Basic polkit actions do not require further set-up. Some polkit actions require further authentication, even with a local session. A polkit authentication agent needs to be running for this to work. See polkit#Authentication agents for more information on this.
Message: "error while loading shared libraries"
If, while using a program, you get an error similar to:
error while loading shared libraries: libusb-0.1.so.4: cannot open shared object file: No such file or directory
Use pacman or pkgfile to search for the package that owns the missing library:
$ pacman -F libusb-0.1.so.4
extra/libusb-compat 0.1.5-1
usr/lib/libusb-0.1.so.4
In this case, the libusb-compat package needs to be installed. Alternatively, the program requesting the library may need to be rebuilt following a soname bump.
The error could also mean that the package that you used to install your program does not list the library as a dependency in its PKGBUILD: if it is an official package, report a bug; if it is an AUR package, report it to the maintainer using its page in the AUR website.
További olvasnivaló a témában
- A how-to in troubleshooting for newcomers
- List of Tools for UBCD - Memtest-like tools to add to grub.cfg on UltimateBootCD.com
- Wikipedia:BIOS Boot partition
- Keyboard shortcuts#Kernel (SysRq)
- systemd documentation on Debug Logging to a Serial Console
- How to Isolate Linux ACPI Issues on Archive.org