summaryrefslogtreecommitdiff
path: root/man/journalctl.xml
Commit message (Collapse)AuthorAgeFilesLines
* man/journalctl: mention systemd-cat, make the description more directZbigniew Jędrzejewski-Szmek2022-11-221-7/+16
| | | | | | | | | | We said "query the journal". This is true but also very generic. Let's say "print log entries from the journal" instead, so that users who are looking for "logging" are more likely to figure out that the journalctl is the tool for them. Also, mention systemd-journal-remote.service which can write the journal too. And give some hints how to figure out how to write *to* the journal.
* tree-wide: BLS and DPS are now on uapi-group websiteZbigniew Jędrzejewski-Szmek2022-11-211-1/+1
|
* man: document effect of --user on --unit with journalctlLeon M. George2022-10-201-1/+7
| | | | Relates to #25061.
* Revert "journal: Add --convert= command to journalctl"Daan De Meyer2022-10-081-11/+0
| | | | | | This reverts commit 721620e8a32907ffe546a582c5ac7136b6367510. This commit was accidentally merged as part of #22998
* journal: Add --convert= command to journalctlDaan De Meyer2022-10-071-0/+11
| | | | | | | | --convert writes the journal files read by journalctl to the given location. The location should be specified as a full journal file path (e.g. /a/b/c/converted.journal). The directory specifies where the converted journal files will be stored. The filename specifies the naming convention the converted journal files will follow.
* shared/logs-show: add new --output= format "short-delta"Daniel Braunwarth2022-09-231-0/+7
| | | | | | | This new output formatting option is similar to "short-monotonic" but also shows the time delta between two messages. This fixes #24641.
* man: similar → similarlyZbigniew Jędrzejewski-Szmek2022-08-231-11/+11
| | | | | | | | | Something *is* similar Something *works* similarly Something does something, similarly to how something else does something See https://sites.ulethbridge.ca/roussel/2017/11/29/similar-and-similarly-are-they-similar/ for a clear explanation.
* man,journalctl: introduce man/--help sectionsLennart Poettering2022-08-051-790/+647
| | | | | | | | | | | | | | So far the --help text and the man page of journactl were mostly a large pile of options shown next to each other. Let's add some basic structure, and group switches by sections such as "Filtering Options", "Output Options" and so on. Do this the same way in the --help text and in the man page. Since this moves everything around anyway, I also opted to rebreak all paragraphs in the man page. This makes the patch larger than necessary, but given that this whole patch doesn't really change contents besides section titles I figured this would be OK.
* man: fix grammatical error in --cursor-file descriptionVito Caputo2022-07-161-1/+1
| | | | Just a minor cleanup to fix unparseable wording
* journalctl: advertise --header a bit moreZbigniew Jędrzejewski-Szmek2022-03-041-7/+9
| | | | Fixes #2738.
* man+docs: adjust links to the new pageZbigniew Jędrzejewski-Szmek2022-01-121-2/+2
|
* 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.
View Lorry Controller Status