X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fjournalctl.xml;h=8883da278c82293050f009345a29364b950ff713;hp=296e3fd2ff01e01cc43e6f0ba8fc13fa270e672e;hb=8cb17a6dc88cecfcee3189765031e9e8a1f4106b;hpb=9e8a535faa370bab283cb2c3c52b0a0d44e9d193 diff --git a/man/journalctl.xml b/man/journalctl.xml index 296e3fd2f..8883da278 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -62,7 +62,7 @@ journal as written by systemd-journald.service8. - If called without parameter will show the full + If called without parameter it will show the full contents of the journal, starting with the oldest entry collected. @@ -114,8 +114,8 @@ - + Prints a short help text and exits. @@ -136,8 +136,15 @@ - + + + Show all (printable) fields in + full. + + + + Show all fields in full, even if they include unprintable @@ -146,26 +153,44 @@ - + - Show only most recent + Show only the most recent journal entries, and continuously print new entries as they are appended to the journal. - + + + + Immediately jump to + the end of the journal inside the + implied pager tool. This implies + to guarantee + that the pager won't buffer logs of + unbounded size. This may be overridden + with an explicit + with some other numeric value on the + command line. Note that this option is + only supported for the + less1 + pager. + + + + - Controls the number of - journal lines to show, counting from - the most recent ones. Takes a positive - integer argument. In follow mode - defaults to 10, otherwise is unset - thus not limiting how many lines are - shown. + Show the most recent + journal events and limit the number of + events shown. If + is used, + this option is implied. The argument, + a positive integer, is optional, and + defaults to 10. @@ -178,8 +203,16 @@ - + + + + Reverse output, so the newest + entries are displayed first. + + + + Controls the formatting of the journal entries that @@ -190,6 +223,7 @@ export, json, json-pretty, + json-sse, cat. short is the default and generates an output that is mostly identical to the @@ -211,12 +245,20 @@ information). json formats entries as JSON data structures, one per - line. json-pretty + line (see Journal + JSON Format for more + information). json-pretty also formats entries as JSON data structures, but formats them in multiple lines in order to make them more readable for - humans. cat + humans. json-sse + also formats entries as JSON data + structures, but wraps them in a format + suitable for Server-Sent + Events. cat generates a very terse output only showing the actual message of each journal entry with no meta data, not @@ -224,8 +266,32 @@ - + + + + Augment log lines with + explanation texts from the message + catalog. This will add explanatory + help texts to log messages in the + output where this is available. These + short help texts will explain the + context of an error or log event, + possible solutions, as well as + pointers to support forums, developer + documentation and any other relevant + manuals. Note that help texts are not + available for all messages, but only + for selected ones. For more + information on the message catalog + please refer to the Message + Catalog Developer + Documentation. + + + + Suppresses any warning message regarding inaccessible system @@ -234,8 +300,8 @@ - + Show entries interleaved from all available @@ -244,23 +310,42 @@ - + Show data only from - current boot. + current boot. This will add a match + for _BOOT_ID= for + the current boot ID of the + kernel. - - + + + + Show messages for the + specified systemd unit. This will add + a match for messages from the unit + (_SYSTEMD_UNIT=) + and additional matches for messages + from systemd and messages about + coredumps for the specified unit. + + - Takes an absolute - directory path as argument. If - specified will operate on the - specified journal directory instead of - the default runtime and system journal - paths. + + + + Show messages for the + specified user session unit. This will + add a match for messages from the unit + (_SYSTEMD_USER_UNIT= + and _UID=) and + additional matches for messages from + session systemd and messages about + coredumps for the specified unit. + @@ -287,12 +372,77 @@ info (6), debug (7). If a single log level is specified all - messages with this log levels or a + messages with this log level or a lower (hence more important) log level are shown. If a range is specified all messages within the range are shown, including both the start and the end - value of the range. + value of the range. This will add + PRIORITY= matches + for the specified + priorities. + + + + + + + Start showing entries + from the location in the journal + specified by the passed + cursor. + + + + + + + Start showing entries + on or newer than the specified date, + or on or older than the specified + date, respectively. Date specifications should be of + the format "2012-10-30 18:17:16". If + the time part is omitted, 00:00:00 is + assumed. If only the seconds component + is omitted, :00 is assumed. If the + date component is omitted, the + current day is assumed. Alternatively + the strings + yesterday, + today, + tomorrow are + understood, which refer to 00:00:00 of + the day before the current day, the + current day, or the day after the + current day, respectively. now + refers to the current time. Finally, + relative times may be specified, + prefixed with - or + +, referring to + times before or after the current + time, respectively. + + + + + + + Print all possible + data values the specified field can + take in all entries of the + journal. + + + + + + + Takes a + directory path as argument. If + specified journalctl will operate on the + specified journal directory instead of + the default runtime and system journal + paths. @@ -316,10 +466,38 @@ Instead of showing journal contents show internal header - information of the journal fiels + information of the journal fields accessed. + + + + Shows the current disk + usage of all + journal files. + + + + + + List the contents of + the message catalog, as table of + message IDs plus their short + description strings. + + + + + + Update the message + catalog index. This command needs to + be executed each time new catalog + files are installed, removed or + updated to rebuild the binary catalog + index. + + @@ -383,7 +561,7 @@ Environment - + $SYSTEMD_PAGER Pager to use when @@ -417,7 +595,7 @@ journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service If the separator "+" is used - two expression may be combined in a logical OR. The + two expressions may be combined in a logical OR. The following will show all messages from the Avahi service process with the PID 28097 plus all messages from the D-Bus service (from any of its