X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.journal-fields.xml;h=59bb8ad70a26f80dc6c7e1b2fc84b615af693ec4;hb=871b876ecc6921a70b5f5e15cb9f85e0b6f2d1a5;hp=5f2a32cb00e29a2b44d6a10964be2bf9cfc6b2dd;hpb=ffa16db02673ffa155ffb2649e72a935a1ff70f5;p=elogind.git
diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
index 5f2a32cb0..59bb8ad70 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=
@@ -226,9 +242,10 @@
timestamp of the message, if
any is known that is different
from the reception time of the
- journal. The time in usec
- since the epoch formatted as
- decimal string.
+ journal. This is the time in
+ usec since the epoch UTC
+ formatted as decimal
+ string.
@@ -260,6 +277,31 @@
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.
+
+
+
@@ -270,7 +312,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
@@ -293,7 +340,9 @@
The wallclock time
(CLOCK_REALTIME) at the point
in time the entry was received
- by the journal. This has
+ by the journal, in usec since
+ the epoch UTC formatted as
+ decimal string. This has
different properties from
_SOURCE_REALTIME_TIMESTAMP=
as it is usually a bit later
@@ -308,10 +357,12 @@
The monotonic time
(CLOCK_MONOTONIC) at the point
in time the entry was received
- by the journal. To be useful
- as an address for the entry
- this should be combined with
- with boot ID in
+ by the journal in usec
+ formatted as decimal
+ string. To be useful as an
+ address for the entry this
+ should be combined with with
+ boot ID in
_BOOT_ID=.
@@ -323,7 +374,8 @@
systemd1,
journalctl1,
- journald.conf5
+ journald.conf5,
+ sd-journal3