From b632f55c29cf516af266c92304844adb98ef5fbd Mon Sep 17 00:00:00 2001 From: Michal Schmidt Date: Thu, 3 Sep 2015 13:41:19 +0200 Subject: [PATCH] logger: improve logger --journald man page example The example use of logger --journald in the man page has a couple of flaws: - It's missing a "MESSAGE=" field. This is supposed to be the primary human readable text. Without it the log entry is invisible in a plain "journalctl" output. - The MESSAGE_ID is supposed to be a 128-bit hexadecimal string that globally uniquely identifies the message type. One can generate such an id with "journalctl --new-id". This patches fixes the above and also changes the example to use a here-document instead of printf. In my opinion it makes the expected multi-line data format more obvious. Signed-off-by: Michal Schmidt --- misc-utils/logger.1 | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/misc-utils/logger.1 b/misc-utils/logger.1 index 36c923d52..5deb3f0a1 100644 --- a/misc-utils/logger.1 +++ b/misc-utils/logger.1 @@ -81,7 +81,13 @@ for details. The use of a MESSAGE_ID field is generally a good idea, as it makes finding entries easy. Examples: .IP .nf -\fB printf \(dq%s\\n%s\\n%s\\n\(dq MESSAGE_ID=42 DOGS=bark \(dqCARAVAN=goes on\(dq | logger --journald +\fB logger --journald <