X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.journal-fields.xml;h=d790c35a03d0f5d3ad0afe5874f8b12b09bbffa2;hp=99b1caab9bd7c7a6a93325634f4cc547f7622a39;hb=feb12d3ed2c7f9132c64773c7c41b9e3a608a814;hpb=5430f7f2bc7330f3088b894166bf3524a067e3d8
diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
index 99b1caab9..d790c35a0 100644
--- a/man/systemd.journal-fields.xml
+++ b/man/systemd.journal-fields.xml
@@ -53,11 +53,12 @@
Entries in the journal resemble an environment
block in their syntax, however with fields that can
include binary data. Primarily, fields are formatted
- ASCII strings, and binary formatting is used only
- where formatting as ASCII makes little sense. New
- fields may be freely defined by applications, but a
- few fields have special meaning. All fields with
- special meaning are optional.
+ UTF-8 text strings, and binary formatting is used only
+ where formatting as UTF-8 text strings makes little
+ sense. New fields may freely be defined by
+ applications, but a few fields have special
+ meaning. All fields with special meanings are
+ optional.
@@ -74,9 +75,11 @@
message string for this
entry. This is supposed to be
the primary text shown to the
- user. It is not translated,
- and is not supposed to be
- parsed for meta data.
+ user. It is usually not
+ translated (but might be in
+ some cases), and is not
+ supposed to be parsed for meta
+ data.
@@ -129,6 +132,19 @@
+
+ ERRNO=
+
+ The low-level Unix error
+ number causing this entry, if
+ any. Contains the numeric
+ value of
+ errno3
+ formatted as decimal
+ string.
+
+
+
SYSLOG_FACILITY=
SYSLOG_IDENTIFIER=
@@ -281,14 +297,50 @@
journal protocol, for the
those read from a services'
standard output or error
- output, resp. for those read
- from the kernel.
+ output, and for those read
+ from the kernel, resp.
+
+ Kernel Journal Fields
+
+ Kernel fields are fields that are used by
+ messages originating in the kernel and stored in the
+ journal.
+
+
+
+ _KERNEL_DEVICE=
+
+ The kernel device
+ name. If the entry is
+ associated to a block device,
+ the major and minor of the
+ device node, separated by ':'
+ and prefixed by 'b'. Similar
+ for character devices, but
+ prefixed by 'c'. For network
+ devices the interface index,
+ prefixed by 'n'. For all other
+ devices '+' followed by the
+ subsystem name, followed by
+ ':', followed by the kernel
+ device name.
+
+
+
+ _KERNEL_SUBSYSTEM=
+
+ The kernel subsystem name.
+
+
+
+
+
Address Fields
@@ -296,7 +348,12 @@
addresses of journal entries are serialized into
fields prefixed with double underscores. Note that
these aren't proper fields when stored in the journal,
- but addressing meta data of entries.
+ but addressing meta data of entries. They cannot be
+ written as part of structured log entries via calls
+ such as
+ sd_journal_send3. They
+ may also not be used as matches for
+ sd_journal_add_match3
@@ -353,7 +410,8 @@
systemd1,
journalctl1,
- journald.conf5
+ journald.conf5,
+ sd-journal3