summaryrefslogtreecommitdiff
path: root/man/journalctl.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: rename less-variables→common-variablesZbigniew Jędrzejewski-Szmek2021-03-011-1/+1
| | | | Some are not about less, e.g. $SYSTEMD_URLIFY.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* Merge pull request #16640 from keszybz/various-patchesLennart Poettering2020-08-191-1/+1
|\ | | | | Improve systemd-analyze security a bit and other assorted bits
| * journal: adjust line about when the journal begins and endsZbigniew Jędrzejewski-Szmek2020-08-171-1/+1
| | | | | | | | | | | | | | This comes up occasionally with new users. The phrase "Logs begin ..." is ambiguous because it can be taken to mean the logs being displayed or all logs (the intended meaning). Let's rephrase this as "Journal begins ..." to make this clearer.
* | man: document the new --image= switches in journalctl/sysusers/tmpfilesLennart Poettering2020-08-051-7/+20
|/
* man: fix some manvolnumAnita Zhang2020-07-111-1/+1
|
* tree-wide: fixes for assorted grammar and spelling issuesZbigniew Jędrzejewski-Szmek2020-07-061-6/+6
| | | | Fixes #16363. Also includes some changes where I generalized the pattern.
* man: fix links to various external man pagesZbigniew Jędrzejewski-Szmek2020-06-251-1/+1
| | | | | In cases where we used both die-net and man-pages for the same reference, I switched to use man-pages everywhere.
* man: document the new -o cat featureLennart Poettering2020-05-051-7/+9
|
* tree-wide: fix spelling errorsFrantisek Sumsal2020-04-211-1/+1
| | | | | | Based on a report from Fossies.org using Codespell. Followup to #15436
* man: add note that --no-hostname has limited effectZbigniew Jędrzejewski-Szmek2020-04-011-4/+9
| | | | | | | Clearly there is some confusion about the intent of this option, let's add a short note. https://bugzilla.redhat.com/show_bug.cgi?id=1819313
* journalctl: implement --facility=fooZbigniew Jędrzejewski-Szmek2020-02-291-0/+10
| | | | Fixes #9716.
* man: document --namespace= switch of journalctlLennart Poettering2020-01-311-0/+12
|
* journalctl: Make journalctl --user-unit= match on _SYSTEMD_USER_SLICEArian van Putten2019-08-221-2/+11
| | | | | | | | | | | | | | | | | 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: document the two new journalctl commandsLennart Poettering2019-05-091-12/+28
|
* journalctl: support `-b all` to negate effect of -bdana2019-03-191-2/+6
| | | | Also fix an issue where -b without argument didn't always behave as -b0
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-2/+2
| | | | | | | 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
* journalctl: New option --cursor-fileJörg Sommer2019-02-271-0/+11
| | | | | | | | | | | | | | | | The option cursor-file takes a filename as argument. If the file exists and contains a valid cursor, this is used to start the output after this position. At the end, the last cursor gets written to the file. This allows for an easy implementation of a timer that regularly looks in the journal for some messages. journalctl --cursor-file err-cursor -b -p err journalctl --cursor-file audit-cursor -t audit --grep DENIED Or you might want to walk the journal in steps of 10 messages: journalctl --cursor-file ./curs -n10 --since=today -t systemd
* man: update color of journal logs in DEBUG levelYu Watanabe2019-01-021-2/+2
| | | | Fixes #11303.
* Merge pull request #10525 from poettering/journal-vaccum-allZbigniew Jędrzejewski-Szmek2018-10-261-29/+28
|\ | | | | journald: add ability to vacuum active files too
| * man: document the new combined --vacuum*= and --rotate invocationLennart Poettering2018-10-251-29/+28
| |
* | man: journalctl: expand description of --allLucas Werkmeister2018-10-261-3/+3
|/ | | | | | | In the default journalctl output, unprintable entries are abbreviated as “[<amount> blob data]”; using the same term in the documentation helps users to quickly discover the option they need to add in order to see those entries.
* journalctl: port JSON output mode to new JSON APILennart Poettering2018-10-111-12/+35
| | | | | | Also, while we are at it, beef it up, by adding json-seq support (i.e. https://tools.ietf.org/html/rfc7464). This is particularly useful in conjunction with jq's --seq switch.
* journalctl: drop --new-id128 from help and man textsLennart Poettering2018-10-021-12/+0
| | | | | | | | | | Let's remove redundancy and not advertise "journalctl --new-id128" anymore, now that we have "systemd-id128 new" in a proper tool. This allows us to reduce the overly large journalctl command set a bit. Note that this just removes the --help and man text, the call remains available for compat reasons.
* 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.
* doc: more spelling fixesMichael Biebl2018-06-121-1/+1
|
* journalctl: add with-unit modeLuca Boccassi2018-05-251-0/+12
| | | | | | | | | | When dealing with a large number of template instances, for example when launching daemons per VRF, it is hard for operators to correlate log lines to arguments. Add a new with-unit mode which, if available, prefixes unit and user unit names when displaying its log messages instead of the syslog identifier. It will also use the full timestamp with timezones, like the short-full mode.
* man: update references to systemd-journal-{remote,upload}Yu Watanabe2018-05-081-2/+2
| | | | Fixes #8920 and #8921.
* 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: add an additional note about journalctl -uZbigniew Jędrzejewski-Szmek2018-03-241-1/+15
| | | | | | | | | Fixes #5387. I kept the _SYSTEMD_UNIT= example because it is easy to understand and not very verbose. _SYSTEMD_CGROUP has much longer entries which do not fit well in the narrow man page. Instead, I added an explanation of what -u is translated into.
* man: mention that oldest journal files are removedZbigniew Jędrzejewski-Szmek2018-03-241-1/+1
| | | | Fixes #7225.
* journalctl: make matching optionally case sensitiveZbigniew Jędrzejewski-Szmek2018-01-281-1/+13
| | | | | | | | | | | | | Case sensitive or case insensitive matching can be requested using --case-sensitive[=yes|no]. Unless specified, matching is case sensitive if the pattern contains any uppercase letters, and case insensitive otherwise. This matches what forward-search does in emacs, and recently also --ignore-case in less. This works surprisingly well, because usually when one is wants to do case-sensitive matching, the pattern is usually camel-cased. In the less frequent case when case-sensitive matching is required with an all-lowercase pattern, --case-sensitive can be used to override the automatic logic.
* journalctl: regexp matchingZbigniew Jędrzejewski-Szmek2018-01-271-0/+11
|
* man: convert info to information or informationalYu Watanabe2017-12-041-1/+1
|
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* journalctl: add --output-fields= (#7181)Lars Karlitski2017-10-271-0/+14
| | | | | | | | | This option allows restricting the shown fields in the output modes that would normally show all fields. It allows clients that are only interested in a subset of the fields to access those more efficiently. Also, it makes the resulting size of the output more predictable. It has no effect on the various `short` output modes, because those already only show a subset of the fields.
* Add short-iso-precise for journalctl output (#5884)Ian Wienand2017-05-071-2/+12
| | | | This adds a short-iso-precise option for journalctl output. It is similar to short-iso, but includes microseconds.
* man: journalctl: update --new-id128 format count (#5423)Lucas Werkmeister2017-02-221-1/+1
| | | The Python format was added in d489071fb3.
* man: use https:// in URLsAsciiWolf2017-02-211-3/+3
|
* man: link to sd-j-{remote,upload} from journalctl(1)Zbigniew Jędrzejewski-Szmek2017-01-111-1/+3
|
* man/journalctl: mention systemd-journal-remote(8) (#4929)Baruch Siach2016-12-201-1/+3
| | | Make it easier to figure out how to use the journalctl export format.
* man: use unicode ellipsis in more placesZbigniew Jędrzejewski-Szmek2016-12-111-4/+4
| | | | | | | | | | | | | | As requested in https://github.com/systemd/systemd/pull/4864#pullrequestreview-12372557. docbook will substitute triple dots for the ellipsis in man output, so this has no effect on the troff output, only on HTML, making it infinitesimally nicer. In some places we show output from programs, which use dots, and those places should not be changed. In some tables, the alignment would change if dots were changed to the ellipsis which is only one character. Since docbook replaces the ellipsis automatically, we should leave those be. This patch changes all other places.
* journalctl: allow --root argument for journal watchingZbigniew Jędrzejewski-Szmek2016-08-121-2/+4
| | | | | | | | It is useful to look at a (possibly inactive) container or other os tree with --root=/path/to/container. This is similar to specifying --directory=/path/to/container/var/log/journal --directory=/path/to/container/run/systemd/journal (if using --directory multiple times was allowed), but doesn't require as much typing.
* journalctl: add new output mode "short-full" (#3880)Lennart Poettering2016-08-031-18/+23
| | | | | | | | | | | This new output mode formats all timestamps using the usual format_timestamp() call we use pretty much everywhere else. Timestamps formatted this way are some ways more useful than traditional syslog timestamps as they include weekday, month and timezone information, while not being much longer. They are also not locale-dependent. The primary advantage however is that they may be passed directly to journalctl's --since= and --until= switches as soon as #3869 is merged. While we are at it, let's also add "short-unix" to shell completion.
* man: revise entry about specifying a file path (#3739)mulkieran2016-07-191-12/+20
| | | | | | | | | | * Specifying a device node has an effect much larger than a simple shortcut for a field/value match, so the original sentence is no longer a good way to start the paragraph. * Specifying a device node causes matches to be generated for all ancestor devices of the device specified, not just its parents. * Indicates that the path must be absolute, but that it may be a link. * Eliminates a few typos.
* man: minor typo "has already has happened" (#3635)Lukas Lösche2016-06-301-1/+1
|
* journalctl: add --no-hostname switchLennart Poettering2016-04-221-0/+7
| | | | | | This suppresses output of the hostname for messages from the local system. Fixes: #2342