summaryrefslogtreecommitdiffstats
path: root/docs/var-log
diff options
context:
space:
mode:
Diffstat (limited to 'docs/var-log')
-rw-r--r--docs/var-log/README.logs25
-rw-r--r--docs/var-log/meson.build6
2 files changed, 31 insertions, 0 deletions
diff --git a/docs/var-log/README.logs b/docs/var-log/README.logs
new file mode 100644
index 0000000..3a39ce1
--- /dev/null
+++ b/docs/var-log/README.logs
@@ -0,0 +1,25 @@
+You are looking for the traditional text log files in /var/log, and they are
+gone?
+
+Here's an explanation on what's going on:
+
+You are running a systemd-based OS where traditional syslog has been replaced
+with the Journal. The journal stores the same (and more) information as classic
+syslog. To make use of the journal and access the collected log data simply
+invoke "journalctl", which will output the logs in the identical text-based
+format the syslog files in /var/log used to be. For further details, please
+refer to journalctl(1).
+
+Alternatively, consider installing one of the traditional syslog
+implementations available for your distribution, which will generate the
+classic log files for you. Syslog implementations such as syslog-ng or rsyslog
+may be installed side-by-side with the journal and will continue to function
+the way they always did.
+
+Thank you!
+
+Further reading:
+ man:journalctl(1)
+ man:systemd-journald.service(8)
+ man:journald.conf(5)
+ https://0pointer.de/blog/projects/the-journal.html
diff --git a/docs/var-log/meson.build b/docs/var-log/meson.build
new file mode 100644
index 0000000..35f756c
--- /dev/null
+++ b/docs/var-log/meson.build
@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: LGPL-2.1-or-later
+
+if conf.get('HAVE_SYSV_COMPAT') == 1 and get_option('create-log-dirs')
+ install_data('README.logs',
+ install_dir : docdir)
+endif