thirdparty/util-linux
2
0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

logger: (man) fix examples

Browse source 
Signed-off-by: Karel Zak <kzak@redhat.com>
This commit is contained in:
Karel Zak 2023-01-13 12:18:27 +01:00
parent faeb1b64b3
commit a8e071fa20
1 changed files with 8 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

10
misc-utils/logger.1.adoc
View file

@ -77,7 +77,7 @@ Note that the system logging infrastructure (for example *systemd* when listenin
*--journald*[**=**__file__]:: *--journald*[**=**__file__]::
Write a *systemd* journal entry. The entry is read from the given _file_, when specified, otherwise from standard input. Each line must begin with a field that is accepted by *journald*; see *systemd.journal-fields*(7) for details. The use of a MESSAGE_ID field is generally a good idea, as it makes finding entries easy. Examples: Write a *systemd* journal entry. The entry is read from the given _file_, when specified, otherwise from standard input. Each line must begin with a field that is accepted by *journald*; see *systemd.journal-fields*(7) for details. The use of a MESSAGE_ID field is generally a good idea, as it makes finding entries easy. Examples:
+
____ ____
logger --journald <<end logger --journald <<end
MESSAGE_ID=67feb6ffbaf24c5cbec13c008dd72309 MESSAGE_ID=67feb6ffbaf24c5cbec13c008dd72309
@ -88,6 +88,7 @@ ____
logger --journald=entry.txt logger --journald=entry.txt
____ ____
+
Notice that *--journald* will ignore values of other options, such as priority. If priority is needed it must be within input, and use PRIORITY field. The simple execution of *journalctl*(1) will display MESSAGE field. Use *journalctl --output json-pretty* to see rest of the fields. Notice that *--journald* will ignore values of other options, such as priority. If priority is needed it must be within input, and use PRIORITY field. The simple execution of *journalctl*(1) will display MESSAGE field. Use *journalctl --output json-pretty* to see rest of the fields.
+ +
To include newlines in MESSAGE, specify MESSAGE several times. This is handled as a special case, other fields will be stored as an array in the journal if they appear multiple times. To include newlines in MESSAGE, specify MESSAGE several times. This is handled as a special case, other fields will be stored as an array in the journal if they appear multiple times.
@ -230,8 +231,13 @@ For the priority order and intended purposes of these facilities and levels, see
The *logger* command is expected to be IEEE Std 1003.2 ("POSIX.2") compatible. The *logger* command is expected to be IEEE Std 1003.2 ("POSIX.2") compatible.
== EXAMPLES == EXAMPLES
____
logger System rebooted
*logger System rebooted* *logger -p local0.notice -t HOSTIDM -f /dev/idmc* *logger -n loghost.example.com System rebooted* logger -p local0.notice -t HOSTIDM -f /dev/idmc
logger -n loghost.example.com System rebooted
____
== AUTHORS == AUTHORS