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