mirror of
https://github.com/trapexit/mergerfs.git
synced 2026-11-19 14:36:36 -05:00
Fixup debug output (#1617)
This commit is contained in:
parent
be4d388813
commit
3222de6c9c
17 changed files with 1451 additions and 630 deletions
|
|
@ -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)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue