Merge pull request #1409 from trapexit/docs
Some checks failed
CodeQL / Analyze (cpp) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
mkdocs / deploy (push) Has been cancelled

Add details about logging to syslog
This commit is contained in:
trapexit 2025-01-25 20:58:57 -06:00 committed by GitHub
commit aa97bac533
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 17 additions and 2 deletions

View File

@ -1,4 +1,6 @@
# Error Handling
# Error Handling and Logging
## Error Handling
POSIX filesystem functions offer a single return code meaning that
there is some complication regarding the handling of multiple branches
@ -35,3 +37,16 @@ For create functions `mkdir`, `mknod`, and `symlink` which don't
return a file descriptor and therefore can have `all` or `epall`
policies it will return success if any of the calls succeed and an
error otherwise.
## Logging
Filesystems, and therefore mergerfs, are doing lots of small actions
at high speed. It simply isn't reasonable to log all the actions of
the system. That said: certain details are logged at startup and when
performing mainance tasks. These are logged via `syslog` and on
`systemd` based systems can be viewed by running
```
journalctl -t mergerfs
```

View File

@ -80,7 +80,7 @@ nav:
- config/statfs.md
- config/flush-on-close.md
- config/export-support.md
- error_handling.md
- error_handling_and_logging.md
- runtime_interfaces.md
- remote_filesystems.md
- tips_notes.md