summaryrefslogtreecommitdiff
path: root/man/systemd.journal-fields.xml
Commit message (Collapse)AuthorAgeFilesLines
* 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
* doc: resolve missing/extraneous words or inappropriate formsJan Engelhardt2014-02-171-1/+1
| | | | | | | | Issues fixed: * missing words required by grammar * duplicated or extraneous words * inappropriate forms (e.g. singular/plural), and declinations * orthographic misspellings
* nspawn,man: use a common vocabulary when referring to selinux security contextsLennart Poettering2014-02-101-2/+2
| | | | | | | | | | | Let's always call the security labels the same way: SMACK: "Smack Label" SELINUX: "SELinux Security Context" And the low-level encapsulation is called "seclabel". Now let's hope we stick to this vocabulary in future, too, and don't mix "label"s and "security contexts" and so on wildly.
* man: improve wording and comma usage in systemd.journal-fields(7)Jason St. John2013-12-101-8/+8
| | | | Improve wording under "Description" and "_KERNEL_DEVICE="
* journald: log the slice of a process along with each message in _SYSTEMD_SLICE=Lennart Poettering2013-09-171-8/+11
|
* man: wording and grammar updatesJan Engelhardt2013-09-101-1/+1
| | | | | | | | | This includes regularly-submitted corrections to comma setting and orthographical mishaps that appeared in man/ in recent commits. In this particular commit: - the usual comma fixes - expand contractions (this is prose)
* journal: add logging of effective capabilities _CAP_EFFECTIVEShawn Landden2013-07-161-0/+9
| | | | I think this is the most important of the capabilities bitmasks to log.
* man: wording and grammar updatesJan Engelhardt2013-07-091-4/+4
|
* man: describe OBJECT_PID=Zbigniew Jędrzejewski-Szmek2013-07-021-2/+62
|
* man: improve grammar and word formatting in numerous man pagesJason St. John2013-07-021-20/+20
| | | | | | | | | | Use proper grammar, word usage, adjective hyphenation, commas, capitalization, spelling, etc. To improve readability, some run-on sentences or sentence fragments were revised. [zj: remove the space from 'file name', 'host name', and 'time zone'.]
* man: use <constant> for various constants which look ugly with quotesZbigniew Jędrzejewski-Szmek2013-06-261-19/+20
|
* man: always supply quotes around literalsZbigniew Jędrzejewski-Szmek2013-06-261-6/+6
| | | | | | | | When manpages are displayed on a terminal, <literal>s are indistinguishable from surrounding text. Add quotes everywhere, remove duplicate quotes, and tweak a few lists for consistent formatting. https://bugzilla.redhat.com/show_bug.cgi?id=874631
* man: improve readability of "_TRANSPORT=" section in systemd.journal-fields(7)Jason St. John2013-06-141-16/+68
| | | | | | The list and descriptions of valid transports was difficult to read, so break the long sentence up into discrete man page list items to improve readability.
* man: document COREDUMP_UNIT and COREDUMP_USER_UNITZbigniew Jędrzejewski-Szmek2013-02-071-6/+30
| | | | | Also fix formatting for kernel related fields, enabling them to show up in the directives index.
* man: document the _SYSTEMD_USER_UNIT journal fieldMirco Tischler2013-01-181-1/+3
|
* man: add links to directive index to see-alsosZbigniew Jędrzejewski-Szmek2013-01-151-1/+2
| | | | | systemd.directives(5) is renamed to systemd.directives(7). Section 7 is "Miscellaneous".
* man: minor updatesLennart Poettering2012-10-261-7/+11
|
View Lorry Controller Status