From: Jan Synacek <jsynacek@redhat.com>
Date: Tue, 14 May 2019 08:45:08 +0000 (+0200)
Subject: man: note that journal does not validate syslog fields
X-Git-Tag: v243-rc1~436
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=63ea8032f28052f7cda860e5324c0a83dee7ed23;p=thirdparty%2Fsystemd.git

man: note that journal does not validate syslog fields
---

diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
index 960b2ec6336..fa374bf0f80 100644
--- a/man/systemd.journal-fields.xml
+++ b/man/systemd.journal-fields.xml
@@ -104,6 +104,11 @@
           usually derived from glibc's
           <varname>program_invocation_short_name</varname> variable, see
           <citerefentry project='die-net'><refentrytitle>program_invocation_short_name</refentrytitle><manvolnum>3</manvolnum></citerefentry>.)</para>
+          <para>Note that the journal service does not validate the values of any structured
+          journal fields whose name is not prefixed with an underscore, and this includes any
+          syslog related fields such as these. Hence, applications that supply a facility, PID,
+          or log level are expected to do so properly formatted, i.e. as numeric integers formatted
+          as decimal strings.</para>
         </listitem>
       </varlistentry>