4fbe94
From 705a67a53a8a1b836ef17f048366bbf33357afc1 Mon Sep 17 00:00:00 2001
4fbe94
From: Jan Synacek <jsynacek@redhat.com>
4fbe94
Date: Tue, 14 May 2019 10:45:08 +0200
4fbe94
Subject: [PATCH] man: note that journal does not validate syslog fields
4fbe94
4fbe94
(cherry picked from commit 63ea8032f28052f7cda860e5324c0a83dee7ed23)
4fbe94
4fbe94
Resolves: #1707175
4fbe94
---
4fbe94
 man/systemd.journal-fields.xml | 5 +++++
4fbe94
 1 file changed, 5 insertions(+)
4fbe94
4fbe94
diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
4fbe94
index c079274c32..0c95c4cd95 100644
4fbe94
--- a/man/systemd.journal-fields.xml
4fbe94
+++ b/man/systemd.journal-fields.xml
4fbe94
@@ -111,6 +111,11 @@
4fbe94
           <varname>program_invocation_short_name</varname> variable,
4fbe94
           see
4fbe94
           <citerefentry project='die-net'><refentrytitle>program_invocation_short_name</refentrytitle><manvolnum>3</manvolnum></citerefentry>.)</para>
4fbe94
+          <para>Note that the journal service does not validate the values of any structured
4fbe94
+          journal fields whose name is not prefixed with an underscore, and this includes any
4fbe94
+          syslog related fields such as these. Hence, applications that supply a facility, PID,
4fbe94
+          or log level are expected to do so properly formatted, i.e. as numeric integers formatted
4fbe94
+          as decimal strings.</para>
4fbe94
         </listitem>
4fbe94
 
4fbe94
       </varlistentry>