Archive-Team
/
zfs
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 103 Wiki Activity

added horizontal rules to try and reinforce the notion that each section is independent of others

Richard Elling 2019-06-07 10:24:29 -07:00
parent bf6c2ffe00
commit 25ea50ccd8
1 changed files with 4 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Troubleshooting.md

@ -1,5 +1,7 @@
# DRAFT # DRAFT
This page contains tips for troubleshooting ZFS on Linux and what info developers might want for bug triage. This page contains tips for troubleshooting ZFS on Linux and what info developers might want for bug triage.
***
## About Log Files ## About Log Files
Log files can be very useful for troubleshooting. In some cases, interesting information is stored in multiple log files that are correlated to system events. Log files can be very useful for troubleshooting. In some cases, interesting information is stored in multiple log files that are correlated to system events.
@ -12,6 +14,7 @@ Typically, Linux kernel log messages are available from `dmesg -T`, `/var/log/sy
The ZFS kernel modules use an internal log buffer for detailed logging information. The ZFS kernel modules use an internal log buffer for detailed logging information.
This log information is available in the pseudo file `/proc/spl/kstat/zfs/dbgmsg` for ZFS builds where ZFS module parameter [zfs_dbgmsg_enable = 1](https://github.com/zfsonlinux/zfs/wiki/ZFS-on-Linux-Module-Parameters#zfs_dbgmsg_enable) This log information is available in the pseudo file `/proc/spl/kstat/zfs/dbgmsg` for ZFS builds where ZFS module parameter [zfs_dbgmsg_enable = 1](https://github.com/zfsonlinux/zfs/wiki/ZFS-on-Linux-Module-Parameters#zfs_dbgmsg_enable)
***
## Unkillable Process ## Unkillable Process
Symptom: `zfs` or `zpool` command appear hung, does not return, and is not killable Symptom: `zfs` or `zpool` command appear hung, does not return, and is not killable
@ -22,6 +25,7 @@ Log files of interest: [Generic Kernel Log](#generic-kernel-log), [ZFS Kernel Mo
Important information: if a kernel thread is stuck, then a backtrace of the stuck thread can be in the logs. Important information: if a kernel thread is stuck, then a backtrace of the stuck thread can be in the logs.
In some cases, the stuck thread is not logged until the deadman timer expires. See also [debug tunables](https://github.com/zfsonlinux/zfs/wiki/ZFS-on-Linux-Module-Parameters#debug) In some cases, the stuck thread is not logged until the deadman timer expires. See also [debug tunables](https://github.com/zfsonlinux/zfs/wiki/ZFS-on-Linux-Module-Parameters#debug)
***
## ZFS Events ## ZFS Events
ZFS uses an event-based messaging interface for communication of important events to ZFS uses an event-based messaging interface for communication of important events to
other consumers running on the system. The ZFS Event Daemon (zed) is a userland daemon that other consumers running on the system. The ZFS Event Daemon (zed) is a userland daemon that