Fixup debug output (#1617)

This commit is contained in:
trapexit 2026-02-12 23:50:38 -05:00 • committed by GitHub
parent be4d388813
commit 3222de6c9c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
17 changed files with 1451 additions and 630 deletions

View file

@ -24,32 +24,37 @@ directly.](mailto:support@spawn.link)**
* Solution already ruled out and why.
* The details from the output of the
[mergerfs.collect-info](tooling.md#mergerfscollect-info) tool.
* Alternatively:
* Version of mergerfs: `mergerfs --version`
* mergerfs settings / arguments: from fstab, systemd unit, command
line, OMV plugin, etc.
* Version of the OS: `uname -a` and `lsb_release -a`
* List of branches, their filesystem types, sizes (before and after
issue): `df -h`, `lsblk -o NAME,FSTYPE,FSSIZE,SIZE,MOUNTPOINTS,RM,RO,ROTA`
* **All** information about the relevant paths and files: permissions, ownership, etc.
* **All** information about the application making the requests: version, uid/gid
* **All** information about the relevant paths and files: permissions,
ownership, etc. Some of this is collected by the tool but only the
branch root details.
* **All** information about the application making the requests:
version, uid/gid. Try though to replicate any issues with common
core utilities.
* Try to recreate the problem in the simplest way using standard
programs: `ln`, `mv`, `cp`, `ls`, `dd`, etc. With the most simple
mergerfs setup possible such as using only a single branch, well
supported branch filesystem, maybe reduce to using a single thread,
etc.
* Runtime environment:
* Is mergerfs running within a container?
* Are the client apps using mergerfs running in a container?
* A `strace` of the app having problems:
* `strace -fvTtt -s 256 -o /tmp/app.strace.txt <cmd>`
* A `strace` of mergerfs **while** the program is trying to do
whatever it is failing to do:
* `strace -fvTtt -s 256 -p <mergerfsPID> -o /tmp/mergerfs.strace.txt`
* **Precise** directions on replicating the issue. Do not leave
**anything** out.
* Try to recreate the problem in the simplest way using standard
programs: `ln`, `mv`, `cp`, `ls`, `dd`, etc. With the most simple
mergerfs setup possible.
* A `strace` of mergerfs **before** and **while** the program is
trying to do whatever it is failing to do:
* `strace -fvTtt -s 256 -p <mergerfsPID> -o
/tmp/mergerfs.strace.txt`
* If mergerfs is blocking or appears stuck:
* `gdb -q --batch -ex "set pagination off" -ex "thread apply all
bt full" -ex quit --pid <mergerfsPID> > /tmp/mergerfs.stacktrace.txt`
* **Precise** step-by-step directions on replicating the issue. Do not
leave **anything** out.
### Contact / Issue submission
In order of preference.
* github.com: [https://github.com/trapexit/mergerfs/issues](https://github.com/trapexit/mergerfs/issues)
* discord: [https://discord.gg/MpAr69V](https://discord.gg/MpAr69V)
* reddit: [https://www.reddit.com/r/mergerfs](https://www.reddit.com/r/mergerfs)