X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fjournalctl.xml;h=78fc6f616066be8aaf4e35a70c776e3f842314cf;hp=2ce81a0563adb22bd418b454ff1eec00527d4b33;hb=a12b0cc34d80a2d13c87d1f57059339cfc780912;hpb=2b8f6883a17b9386299b7690869ccd8e20fe0347 diff --git a/man/journalctl.xml b/man/journalctl.xml index 2ce81a056..78fc6f616 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + journalctl @@ -84,7 +85,7 @@ alternatives, i.e. the resulting output will show entries matching any of the specified matches for the same field. Finally, if the character - + appears as separate word on the + + appears as a separate word on the command line, all matches before and after are combined in a disjunction (i.e. logical OR). @@ -112,14 +113,14 @@ less by default, and long lines are "truncated" to screen width. The hidden part can be viewed by using the left-arrow and right-arrow - keys. Paging can be disabled, see - and section Environment - below. + keys. Paging can be disabled; see the + option and the "Environment" + section below. When outputing to a tty, lines are colored according to priority: lines of level ERROR and higher - are colored red, lines of level NOTICE and higher are - highlighted, and other lines are displayed normally. + are colored red; lines of level NOTICE and higher are + highlighted; other lines are displayed normally. @@ -129,42 +130,20 @@ The following options are understood: - - - - - Prints a short help - text and exits. - - - - - - Prints a short version - string and exits. - - - - - - Do not pipe output into a - pager. - - Ellipsize fields when - they don't fit in available columns. + they do not fit in available columns. The default is to show full fields, allowing them to wrap or be truncated - by the pager if one is used. + by the pager, if one is used. - Old options + The old options / - not useful anymore, except to undo + are not useful anymore, except to undo . @@ -232,7 +211,7 @@ - Reverse output, so the newest + Reverse output so that the newest entries are displayed first. @@ -352,7 +331,7 @@ but formats them in multiple lines in order to make them more - readable for humans. + readable by humans. @@ -376,10 +355,10 @@ generates a very - terse output only + terse output, only showing the actual message of each journal - entry with no meta data, + entry with no metadata, not even a timestamp. @@ -424,8 +403,8 @@ Suppresses any warning - message regarding inaccessible system - journals when run as normal + messages regarding inaccessible system + journals when run as a normal user. @@ -457,11 +436,11 @@ offset will look up boots starting from the end of the journal. Thus, 1 means the - first boot found in the journal in the + first boot found in the journal in chronological order, 2 the second and so on; while -0 is the last boot, -1 the - boot before that, and so on. An empty + boot before last, and so on. An empty offset is equivalent to specifying -0, except when the current boot is not the last boot @@ -469,7 +448,7 @@ specified to look at logs from a different machine). - If the 32 character + If the 32-character ID is specified, it may optionally be followed by offset which @@ -478,7 +457,7 @@ values mean earlier boots and a positive values mean later boots. If offset is not - specified, a value of zero is assumed and the + specified, a value of zero is assumed, and the logs for the boot given by ID are shown. @@ -486,6 +465,17 @@ + + + + Show a tabular list of + boot numbers (relative to the current + boot), their IDs, and the timestamps + of the first and last message + pertaining to the boot. + + + @@ -498,17 +488,27 @@ - + 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. - + specified systemd unit + UNIT, or + for any of the units matched by + PATTERN. + If a pattern is specified, a list of + unit names found in the journal is + compared with the specified pattern + and all that match are used. For each + unit name, a match is added for + messages from the unit + (_SYSTEMD_UNIT=UNIT), + along with additional matches for + messages from systemd and messages + about coredumps for the specified + unit. + + This parameter can be specified + multiple times. @@ -574,11 +574,23 @@ - Start showing entries from the - location in the journal - after the location - specified by the this cursor. - + Start showing entries + from the location in the journal + after the + location specified by the this cursor. + The cursor is shown when the + option + is used. + + + + + + The cursor is shown after the last + entry after two dashes: + -- cursor: s=0639... + The format of the cursor is private + and subject to change. @@ -628,7 +640,7 @@ Show messages from system services and the kernel (with - ). Show + ). Show messages from service of current user (with ). If neither is specified, show all @@ -636,6 +648,16 @@ + + + + + Show messages from a + running, local container. Specify a + container name to connect + to. + + @@ -652,7 +674,7 @@ - Takes a file glob as + Takes a file glob as an argument. If specified, journalctl will operate on the specified journal files matching GLOB @@ -666,7 +688,7 @@ Takes a directory path - as argument. If specified, journalctl + as an argument. If specified, journalctl will operate on catalog file hierarchy underneath the specified directory instead of the root directory @@ -680,8 +702,8 @@ Instead of showing - journal contents, generate a new 128 - bit ID suitable for identifying + journal contents, generate a new 128-bit + ID suitable for identifying messages. This is intended for usage by developers who need a new identifier for a new message they @@ -711,16 +733,16 @@ List the contents of - the message catalog, as table of - message IDs plus their short + the message catalog as a table of + message IDs, plus their short description strings. If any - ID128s are + 128-bit-IDs are specified, only those entries are shown. @@ -728,18 +750,18 @@ Show the contents of the message catalog, with entries separated by a line consisting of two - dashes and the id (the format is the + dashes and the ID (the format is the same as .catalog - files. + files). If any - ID128s are + 128-bit-IDs are specified, only those entries are shown. @@ -751,7 +773,7 @@ Update the message catalog index. This command needs to be executed each time new catalog - files are installed, removed or + files are installed, removed, or updated to rebuild the binary catalog index. @@ -767,18 +789,23 @@ sealing key is stored in the journal data directory and shall remain on the host. The verification key should be - stored externally. Also see the + stored externally. Refer to the option in journald.conf5 - for details. + for information on Forward Secure + Sealing and for a link to a refereed + scholarly paper detailing the + cryptographic theory it is based on. + - When --setup-keys is passed and - Forward Secure Sealing has already been set up, - recreate FSS keys. + When + is passed and + Forward Secure Sealing (FSS) has already been + configured, recreate FSS keys. @@ -817,31 +844,20 @@ operation. + + + Exit status - On success, 0 is returned, a non-zero failure - code otherwise. + On success, 0 is returned; otherwise, a non-zero + failure code is returned. - - Environment - - - - $SYSTEMD_PAGER - Pager to use when - is not given; - overrides $PAGER. Setting - this to an empty string or the value - cat is equivalent to passing - . - - - + Examples