Merge pull request #1409 from trapexit/docs

Add details about logging to syslog

mkdocs/docs/error_handling.md → mkdocs/docs/error_handling_and_logging.md

@@ -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
+```

mkdocs/mkdocs.yml

@@ -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