systemd-journald.service.xml revision ba6b3039531a70466dd955c6faa9bf521b3dfbac
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync This file is part of systemd.
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync Copyright 2010 Lennart Poettering
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync systemd is free software; you can redistribute it and/or modify it
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync under the terms of the GNU Lesser General Public License as published by
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync the Free Software Foundation; either version 2.1 of the License, or
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync (at your option) any later version.
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync systemd is distributed in the hope that it will be useful, but
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync WITHOUT ANY WARRANTY; without even the implied warranty of
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync Lesser General Public License for more details.
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync You should have received a copy of the GNU Lesser General Public License
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync along with systemd; If not, see <http://www.gnu.org/licenses/>.
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync <refentryinfo>
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync <authorgroup>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </authorgroup>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </refentryinfo>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <refnamediv>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </refnamediv>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <refsynopsisdiv>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <para><filename>systemd-journald.service</filename></para>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <para><filename>/usr/lib/systemd/systemd-journald</filename></para>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </refsynopsisdiv>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync system service that collects and stores logging
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync data. It creates and maintains structured, indexed
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync journals based on logging information that is received
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync from the kernel, from user processes via the libc
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync call, from STDOUT/STDERR of system services or via its
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync native API. It will implicitly collect numerous meta
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync data fields for each log messages in a secure and
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync unfakeable way. See
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>systemd.journal-fields</refentrytitle><manvolnum>7</manvolnum></citerefentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync for more information about the collected meta data.
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <para>Log data collected by the journal is primarily
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync text based but can also include binary data where
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync necessary. All objects stored in the journal can be up
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync to 2^64-1 bytes in size.</para>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <para>By default the journal stores log data in
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync lost at reboot. To make the data persistent it
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync is sufficient to create
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <filename>systemd-journald</filename> will then store
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync the data.</para>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync forward all received log messages to the AF_UNIX
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync SOCK_DGRAM socket
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <filename>/run/systemd/journal/syslog</filename> (if it exists) which
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync may be used by UNIX syslog daemons to process the data
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync further.</para>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync for information about the configuration of this
7f21d92108ecca490de4b14e2a0a747b2a966beavboxsync service.</para>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </refsect1>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <variablelist>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <varlistentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync is flushed to
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync make it persistent (if this is
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync enabled). This may be used after
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync but is generally not required since
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync the first journal write when
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync writable triggers the flushing
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </varlistentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <varlistentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync rotation of the journal
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </varlistentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </variablelist>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </refsect1>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync <citerefentry><refentrytitle>systemd.journal-fields</refentrytitle><manvolnum>7</manvolnum></citerefentry>
8810985701f1c6beb8f74c235c216e18b67192b0vboxsync </refsect1>