X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=91cc322604531ba8aef1c74fb9c75066c5f1b0ba;hb=a432cb691ca3c1e18b012cb8e9f6e5654b3652a2;hp=3786fdf51491f476a4b876adb55272ecbb141bbb;hpb=cfbc22abd0525570a6e58968d518ea9a7d0403ba;p=elogind.git diff --git a/man/journalctl.xml b/man/journalctl.xml index 3786fdf51..91cc32260 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -49,7 +49,9 @@ - journalctl OPTIONS MATCHES + journalctl + OPTIONS + MATCHES @@ -114,8 +116,8 @@ - + Prints a short help text and exits. @@ -136,8 +138,15 @@ - + + + Show all (printable) fields in + full. + + + + Show all fields in full, even if they include unprintable @@ -146,8 +155,8 @@ - + Show only the most recent journal entries, and continuously print @@ -156,19 +165,34 @@ - + + + + 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. The argument is - optional, and if specified is a - positive integer. If not specified and - in follow mode defaults to 10. If this - option is not passed and follow mode - is not enabled, how many lines are - shown is not - limited. + 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. @@ -181,8 +205,16 @@ - + + + + Reverse output, so the newest + entries are displayed first. + + + + Controls the formatting of the journal entries that @@ -215,7 +247,10 @@ 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 @@ -233,8 +268,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 @@ -243,8 +302,8 @@ - + Show entries interleaved from all available @@ -253,16 +312,84 @@ - + 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. + This parameter can be specified multiple times. + + + + + + + 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. + This parameter can be specified multiple times. + + + + + + + + Filter output by + message priorities or priority + ranges. Takes either a single numeric + or textual log level (i.e. between + 0/emerg and + 7/debug), or a + range of numeric/text log levels in + the form FROM..TO. The log levels are + the usual syslog log levels as + documented in + syslog3, + i.e. emerg (0), + alert (1), + crit (2), + err (3), + warning (4), + notice (5), + info (6), + debug (7). If a + single log level is specified all + 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. This will add + PRIORITY= matches + for the specified + priorities. - + Start showing entries from the location in the journal @@ -275,14 +402,14 @@ Start showing entries - newer or of the specified date, - resp. older or of the specified - date. Date specifications should be of + 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 ommitted, the + date component is omitted, the current day is assumed. Alternatively the strings yesterday, @@ -290,21 +417,31 @@ tomorrow are understood, which refer to 00:00:00 of the day before the current day, the - current day, resp the day after the - current day. now + 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 resp. after the current - time. + 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 an absolute + Takes a directory path as argument. If specified journalctl will operate on the specified journal directory instead of @@ -313,35 +450,17 @@ - - - - Filter output by - message priorities or priority - ranges. Takes either a single numeric - or textual log level (i.e. between - 0/emerg and - 7/debug), or a - range of numeric/text log levels in - the form FROM..TO. The log levels are - the usual syslog log levels as - documented in - syslog3, - i.e. emerg (0), - alert (1), - crit (2), - err (3), - warning (4), - notice (5), - info (6), - debug (7). If a - single log level is specified all - 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. + + + Takes a directory path + as argument. If specified journalctl + will operate on catalog file hierarchy + underneath the specified directory + instead of the root directory + (e.g. + will create + ROOT/var/lib/systemd/catalog/database). + @@ -377,6 +496,53 @@ journal files. + + + + List the contents of + the message catalog, as table of + message IDs plus their short + description strings. + + If any + ID128s are + specified, only those entries are shown. + + + + + + + + Show the contents of + the message catalog, with entries + separated by a line consisting of two + dashes and the id (the format is the + same as .catalog + files. + + If any + ID128s are + specified, only those entries are shown. + + + + + + + + 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. + + @@ -440,7 +606,7 @@ Environment - + $SYSTEMD_PAGER Pager to use when