summaryrefslogtreecommitdiff
path: root/man/systemd.journal-fields.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: document __SEQNUM=/__SEQNUM_ID= journal pseudo fieldsLennart Poettering2023-02-081-0/+10
|
* man: clarify that MESSAGE= should not appear more than once in the same ↵Lennart Poettering2023-01-241-9/+16
| | | | | | | | | journal entry One would think this was clear already, but apparently it's not clear enough, hence let's be more explicit. Fixes: #26175
* tree-wide: also settle on "initrd" instead of "initial RAM disk"Lennart Poettering2022-09-231-2/+2
| | | | | With this the concept is now called the same way everywhere except where historical info is relevant or where the other names are API.
* journal: rename special journal field _SYSTEM_CONTEXT= → _RUNTIME_SCOPE=Lennart Poettering2022-08-251-5/+5
| | | | | | | | | | | | | | | | | | Previously the field "_SYSTEM_CONTEXT" knew he values "initrd" + "main". Let's change this to "_RUNTIME_SCOPE" and "initrd" + "system". Why? The sysext logic has a very similar concept of "scopes", declaring whether a sysext image is intended for the initrd or the main system. Let's thus use the same naming for both. sysext's extension-release files hence know SYSEXT_SCOPE=initrd|system, and the journal messages know _RUNTIME_SCOPE=initrd|system, which makes this reasonably systematic. Follow-up for: cae8edd93ca2ef90c41cb9b6322b6908d12947b5 (This is not an API break, since no version with this commit has ever been released.)
* journal: Add new _INITRD fieldDaan De Meyer2022-08-231-0/+8
| | | | | The _INITRD field is a boolean field (0 or 1) that specifies whether a message was processed by systemd-journald in the initrd or not.
* man: describe UNIT=/USER_UNIT=Zbigniew Jędrzejewski-Szmek2022-03-041-1/+16
| | | | Fixes 17538.
* man+docs: adjust links to the new pageZbigniew Jędrzejewski-Szmek2022-01-121-5/+4
|
* man: remove unintentionally repetitive wordsml2021-11-111-1/+1
|
* man: set constant tag to NUL or NULLYu Watanabe2020-11-121-1/+1
|
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-3/+3
|
* man: assorted small fixesZbigniew Jędrzejewski-Szmek2020-09-301-15/+10
| | | | This is almost all of #17177.
* log: include TID= field in structred log outputLennart Poettering2020-09-291-0/+7
| | | | | | | | It always was the intention to expose this as trusted field _TID=, i.e. automatically determine it from journald via some SCM_xyz field or so, but this is never happened, and it's unlikely this will be added anytime soon to the kernel either, hence let's just generate this sender side, even if it means it's untrusted.
* tree-wide: fixes for assorted grammar and spelling issuesZbigniew Jędrzejewski-Szmek2020-07-061-1/+2
| | | | Fixes #16363. Also includes some changes where I generalized the pattern.
* man: briefly document the DOCUMENTATION= structure log fieldLennart Poettering2020-05-291-0/+10
|
* man: document the new _LINE_BREAK= typeLennart Poettering2020-05-131-9/+10
|
* man: document new _NAMESPACE= journal fieldLennart Poettering2020-01-311-0/+9
|
* man: document INVOCATION_ID and USER_INVOCATION_ID journal fieldsAnita Zhang2019-12-111-0/+10
|
* man: add reference to journald man page from systemd.journal-fields(7)Lennart Poettering2019-11-281-8/+8
| | | | We had none so far. Which is weird.
* journalctl: Make journalctl --user-unit= match on _SYSTEMD_USER_SLICEArian van Putten2019-08-221-0/+1
| | | | | | | | | | | | | | | | | journalctl --unit= already did this, and allows you to tail all the logs for a certain slice easily. It seemed only natural to make --user-unit behave in a similar way. The _SYSTEMD_USER_SLICE field was not documented as being added by journald, so I have added that to the documentation too. Furthermore, I have documented the existing behaviour of --unit= and the new behaviour of --user-unit= The behaviour was actually not documented before, so I am also OK with removing the match for the --unit= command instead. The user would then have to manually provide _SYSTEMD_SLICE= filter to journalctl in both cases. Both options work for me.
* man: note that journal does not validate syslog fieldsJan Synacek2019-05-151-0/+5
|
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
* man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* tree-wide: drop all references to "journalctl --new-id128"Lennart Poettering2018-10-021-8/+4
| | | | Let's advertise "systemd-id128 new" instead.
* journal: store the original timestamp as SYSLOG_TIMESTAMP=Zbigniew Jędrzejewski-Szmek2018-07-051-10/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | This is useful if someone wants to recreate the original syslog datagram. We already include timestamp information as _SOURCE_REALTIME_TIMESTAMP=, and in normal use that timestamp, converted back to the form used by syslog (Mth dd HH:MM:SS) would usually give the value. But there are various circumstances where this might not be true. Most obviously, if the datagram is sent a bit later after being prepared, the time is rounded to the nearest second, and it might be off. This is especially bad around New Year when the syslog timestamp wraps around. Then the same timezone and locale need to be used to recreate the original timestamp. In the end doing this reliably is complicated, and it seems much easier to just unconditionally include the original timestamp. If the original timestamp cannot be located, we store the full log line. This way, it should be always possible to recreate the original input. Example: MESSAGE=x SYSLOG_TIMESTAMP=Sep 15 15:07:58 SYSLOG_RAW ^]^@^@^@^@^@^@^@<13>Sep 15 15:07:58 HOST: x^@y _PID=3318 _SOURCE_REALTIME_TIMESTAMP=1530743976393553 Fixes #2398.
* journal: store the original syslog input as SYSLOG_RAW=Zbigniew Jędrzejewski-Szmek2018-07-041-0/+15
| | | | | | | | | | | | | | | | | | | | | | | This allows the original stream to be recreated and/or verified. The new field is written if any stripping was done or if the input message contained embeded NULs. $ printf '<13>Sep 15 15:07:58 HOST: x\0y' | nc -w1 -u -U /run/systemd/journal/dev-log $ journalctl -o json-pretty ... { ... "MESSAGE" : "x", "SYSLOG_RAW" : [ 60, 49, 51, 62, 83, 101, 112, 32, 49, 53, 32, 49, 53, 58, 48, 55, 58, 53, 56, 32, 72, 79, 83, 84, 58, 32, 120, 0, 121 ] } $ journalctl -o export ... | cat -v ... MESSAGE=x SYSLOG_RAW ^]^@^@^@^@^@^@^@<13>Sep 15 15:07:58 HOST: x^@y This mostly fixes #4863.
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* tree-wide: remove Lennart's copyright linesLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | These lines are generally out-of-date, incomplete and unnecessary. With SPDX and git repository much more accurate and fine grained information about licensing and authorship is available, hence let's drop the per-file copyright notice. Of course, removing copyright lines of others is problematic, hence this commit only removes my own lines and leaves all others untouched. It might be nicer if sooner or later those could go away too, making git the only and accurate source of authorship information.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* man: fix _STREAM_ID, _LINE_BREAK descriptionsZbigniew Jędrzejewski-Szmek2018-01-201-2/+2
| | | | | Pointed out by Дилян Палаузов (https://github.com/dilyanpalauzov). Fixes #7870.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: de-emphasize journal field _SYSTEMD_SESSIONAlan Jenkins2017-10-181-6/+7
| | | | See previous commit message.
* journald: make maximum size of stream log lines configurable and bump it to ↵Lennart Poettering2017-09-221-0/+22
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 48K (#6838) This adds a new setting LineMax= to journald.conf, and sets it by default to 48K. When we convert stream-based stdout/stderr logging into record-based log entries, read up to the specified amount of bytes before forcing a line-break. This also makes three related changes: - When a NUL byte is read we'll not recognize this as alternative line break, instead of silently dropping everything after it. (see #4863) - The reason for a line-break is now encoded in the log record, if it wasn't a plain newline. Specifically, we distuingish "nul", "line-max" and "eof", for line breaks due to NUL byte, due to the maximum line length as configured with LineMax= or due to end of stream. This data is stored in the new implicit _LINE_BREAK= field. It's not synthesized for plain \n line breaks. - A randomized 128bit ID is assigned to each log stream. With these three changes in place it's (mostly) possible to reconstruct the original byte streams from log data, as (most) of the context of the conversion from the byte stream to log records is saved now. (So, the only bits we still drop are empty lines. Which might be something to look into in a future change, and which is outside of the scope of this work) Fixes: https://bugs.freedesktop.org/show_bug.cgi?id=86465 See: #4863 Replaces: #4875
* man: systemd.journal-fields: Note about originator PID (#5724)Michal Koutný2017-04-241-1/+3
|
* man: fix journalctl --new-id128 option name (#5786)Lucas Werkmeister2017-04-231-1/+1
| | | | | | | --new-id works because it’s an unambiguous prefix, but the full option name is --new-id128. (#5381 did the same in one other manpage, but I didn’t check for other manpages using the abbreviated version back then.)
* man: use https:// in URLsAsciiWolf2017-02-211-2/+2
|
* man: systemd.journal-fields: document _SYSTEMD_INVOCATION_ID (#5316)Lucas Werkmeister2017-02-121-0/+10
| | | #4067 added documentation to systemd.exec(5), but not systemd.journal-fields(7).
* man: systemd.journal-fields: add info about _TRANSPORT=auditEvgeny Vereshchagin2015-10-031-0/+10
|
* man: typo fixesThomas Hindoe Paaboel Andersen2015-07-251-1/+1
|
* man: fully document sd-bus' error APIsLennart Poettering2015-07-081-1/+0
| | | | | [@zonque: Some minor nits fixed as pointed out by @ronnychevalier, dropped class='sd-bus-errors' to fix python logic]
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-4/+1
| | | | | | | | | | | | | | | | | | | | | | | This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.
* man: generate configured paths in manpagesFilipe Brandenburger2015-05-281-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.
* treewide: Correct typos and spell plural of bus consistentTorstein Husebø2015-05-111-1/+1
|
* man: fix a bunch of linksZbigniew Jędrzejewski-Szmek2015-03-131-1/+1
| | | | All hail linkchecker!
* Reindent man pages to 2chZbigniew Jędrzejewski-Szmek2015-02-031-577/+488
|
* docs: remove repeating words from man/*xmlKarel Zak2014-07-231-1/+1
|
* man: add a mapping for external manpagesZbigniew Jędrzejewski-Szmek2014-07-071-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | It is annoying when we have dead links on fd.o. Add project='man-pages|die-net|archlinux' to <citerefentry>-ies. In generated html, add external links to http://man7.org/linux/man-pages/man, http://linux.die.net/man/, https://www.archlinux.org/. By default, pages in sections 2 and 4 go to man7, since Michael Kerrisk is the autorative source on kernel related stuff. The rest of links goes to linux.die.net, because they have the manpages. Except for the pacman stuff, since it seems to be only available from archlinux.org. Poor gummiboot gets no link, because gummitboot(8) ain't to be found on the net. According to common wisdom, that would mean that it does not exist. But I have seen Kay using it, so I know it does, and deserves to be found. Can somebody be nice and put it up somewhere?
* coredump: coredumpctl is so useful now, make it a first-class citizenLennart Poettering2014-06-191-2/+2
| | | | | Drop the "systemd-" prefix, renaming it from "systemd-coredumpctl" to "coredumpctl".
* man: explain that the journal field SYSLOG_IDENTIFIER is usually derived ↵Lennart Poettering2014-03-251-1/+4
| | | | from program_invocation_short_name
View Lorry Controller Status