X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fjournalctl.xml;h=564634b757da04f9d77f2ff80d53271b9e49eb96;hp=026bb22940d502e8c2b369d0bad5f176589313d7;hb=fe004b7c3a8325eb8d5420c1b940a5ade2691417;hpb=d99ae53a7327e1520ea4b9a3408c2d7f938c4b37 diff --git a/man/journalctl.xml b/man/journalctl.xml index 026bb2294..564634b75 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,16 @@ - + + + + Show all (printable) fields in + full. + + + + Show all fields in full, even if they include unprintable @@ -146,8 +156,8 @@ - + Show only the most recent journal entries, and continuously print @@ -156,8 +166,26 @@ - + + + + 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. + + + + Show the most recent journal events and limit the number of @@ -178,8 +206,16 @@ - + + + + Reverse output, so the newest + entries are displayed first. + + + + Controls the formatting of the journal entries that @@ -233,8 +269,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 +303,8 @@ - + Show entries interleaved from all available @@ -253,8 +313,8 @@ - + Show data only from current boot. This will add a match @@ -264,14 +324,43 @@ - + + + + Show kernel messages from + current boot. This implies + and adds the match _TRANSPORT=kernel. + + + + + - Show data only of the - specified unit. This will add a match - for _SYSTEMD_UNIT= - for the specified - unit. + 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. + @@ -310,8 +399,8 @@ - + Start showing entries from the location in the journal @@ -331,7 +420,7 @@ 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, @@ -350,8 +439,8 @@ - + Print all possible data values the specified field can @@ -360,15 +449,57 @@ - - + + + + Show messages from + system services and the kernel (with + ). Show + messages from service of current user + (with ). + If neither is specified, show all + messages that the user can see. + + - Takes an absolute - directory path as argument. If - specified journalctl will operate on the - specified journal directory instead of - the default runtime and system journal - paths. + + + + + Takes a directory path + as argument. If specified journalctl + will operate on the specified journal + directory + DIR instead + of the default runtime and system + journal paths. + + + + + + Takes a file glob as + argument. If specified journalctl will + operate on the specified journal files + matching GLOB + instead of the default runtime and + system journal paths. May be specified + multiple times, in which case files will + be suitably interleaved. + + + + + + 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). + @@ -404,6 +535,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. + + @@ -415,7 +593,10 @@ sealing key is stored in the journal data directory and shall remain on the host. The verification key should be - stored externally. + stored externally. Also see the + option in + journald.conf5 + for details. @@ -467,7 +648,7 @@ Environment - + $SYSTEMD_PAGER Pager to use when @@ -513,7 +694,7 @@ journalctl /usr/bin/dbus-daemon - Show all logs of the kernel device node /dev/sda: + Show all logs of the kernel device node /dev/sda: journalctl /dev/sda