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=becffc738a4f56ae3d8760019f8d670396e4e625;hb=feb12d3ed2c7f9132c64773c7c41b9e3a608a814;hpb=41048afabb9af1db50af88647a5b93eb8168082c
diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
index becffc738..d790c35a0 100644
--- a/man/systemd.journal-fields.xml
+++ b/man/systemd.journal-fields.xml
@@ -8,16 +8,16 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
@@ -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=
@@ -261,6 +277,67 @@
originating host.
+
+
+ _TRANSPORT=
+
+ How the entry was
+ received by the journal
+ service. One of
+ driver,
+ syslog,
+ journal,
+ stdout,
+ kernel for
+ internally generated messages,
+ for those received via the
+ local syslog socket with the
+ syslog protocol, for those
+ received via the native
+ journal protocol, for the
+ those read from a services'
+ standard output or error
+ 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.
+
+
@@ -271,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
@@ -328,7 +410,8 @@
systemd1,
journalctl1,
- journald.conf5
+ journald.conf5,
+ sd-journal3