diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/journalctl.1')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/journalctl.1 | 205 |
1 files changed, 179 insertions, 26 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/journalctl.1 b/upstream/opensuse-tumbleweed/man1/journalctl.1 index 52589f14..a77a82c3 100644 --- a/upstream/opensuse-tumbleweed/man1/journalctl.1 +++ b/upstream/opensuse-tumbleweed/man1/journalctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "JOURNALCTL" "1" "" "systemd 254" "journalctl" +.TH "JOURNALCTL" "1" "" "systemd 255" "journalctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -112,16 +112,22 @@ only works if persistent logging is enabled, via the \fIStorage=\fR setting in \fBjournald.conf\fR(5)\&. +.sp +Added in version 205\&. .RE .PP \fB\-M\fR, \fB\-\-machine=\fR .RS 4 Show messages from a running, local container\&. Specify a container name to connect to\&. +.sp +Added in version 209\&. .RE .PP \fB\-m\fR, \fB\-\-merge\fR .RS 4 Show entries interleaved from all available journals, including remote ones\&. +.sp +Added in version 190\&. .RE .PP \fB\-D \fR\fB\fIDIR\fR\fR, \fB\-\-directory=\fR\fB\fIDIR\fR\fR @@ -129,6 +135,8 @@ Show entries interleaved from all available journals, including remote ones\&. Takes a directory path as argument\&. If specified, journalctl will operate on the specified journal directory \fIDIR\fR instead of the default runtime and system journal paths\&. +.sp +Added in version 187\&. .RE .PP \fB\-\-file=\fR\fB\fIGLOB\fR\fR @@ -136,6 +144,8 @@ instead of the default runtime and system journal paths\&. Takes a file glob as an argument\&. If specified, journalctl will operate on the specified journal files matching \fIGLOB\fR instead of the default runtime and system journal paths\&. May be specified multiple times, in which case files will be suitably interleaved\&. +.sp +Added in version 205\&. .RE .PP \fB\-\-root=\fR\fB\fIROOT\fR\fR @@ -150,6 +160,8 @@ will create or \fIROOT\fR/var/log/journal/ will be displayed)\&. +.sp +Added in version 201\&. .RE .PP \fB\-\-image=\fR\fB\fIIMAGE\fR\fR @@ -160,6 +172,8 @@ will operate on the file system in the indicated disk image\&. This option is si \fB\-\-root=\fR, but operates on file systems stored in disk images or block devices, thus providing an easy way to extract log data from disk images\&. The disk image should either contain just a file system or a set of file systems within a GPT partition table, following the \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. For further information on supported disk images, see \fBsystemd-nspawn\fR(1)\*(Aqs switch of the same name\&. +.sp +Added in version 247\&. .RE .PP \fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR @@ -179,6 +193,8 @@ data from all namespaces is shown, interleaved\&. If the namespace identifier is "+" data from the specified namespace and the default namespace is shown, interleaved, but no other\&. For details about journal namespaces see \fBsystemd-journald.service\fR(8)\&. +.sp +Added in version 245\&. .RE .SH "FILTERING OPTIONS" .PP @@ -204,11 +220,15 @@ or \fBsystemd.time\fR(7)\&. Note that \fB\-\-output=short\-full\fR prints timestamps that follow precisely this format\&. +.sp +Added in version 195\&. .RE .PP \fB\-c\fR, \fB\-\-cursor=\fR .RS 4 Start showing entries from the location in the journal specified by the passed cursor\&. +.sp +Added in version 193\&. .RE .PP \fB\-\-after\-cursor=\fR @@ -218,6 +238,8 @@ Start showing entries from the location in the journal the location specified by the passed cursor\&. The cursor is shown when the \fB\-\-show\-cursor\fR option is used\&. +.sp +Added in version 206\&. .RE .PP \fB\-\-cursor\-file=\fR\fB\fIFILE\fR\fR @@ -229,6 +251,8 @@ exists and contains a cursor, start showing entries this location\&. Otherwise show entries according to the other given options\&. At the end, write the cursor of the last entry to \fIFILE\fR\&. Use this option to continually read the journal by sequentially calling \fBjournalctl\fR\&. +.sp +Added in version 242\&. .RE .PP \fB\-b \fR\fB[[\fIID\fR][\fI\(+-offset\fR]|\fBall\fR]\fR, \fB\-\-boot\fR\fB[=[\fIID\fR][\fI\(+-offset\fR]|\fBall\fR]\fR @@ -272,6 +296,8 @@ The special argument \fBall\fR can be used to negate the effect of an earlier use of \fB\-b\fR\&. +.sp +Added in version 186\&. .RE .PP \fB\-u\fR, \fB\-\-unit=\fR\fB\fIUNIT\fR\fR\fB|\fR\fB\fIPATTERN\fR\fR @@ -293,6 +319,8 @@ arguments will be converted to match user messages as if specified with \fB\-\-user\-unit=\fR\&. .sp This parameter can be specified multiple times\&. +.sp +Added in version 195\&. .RE .PP \fB\-\-user\-unit=\fR @@ -307,6 +335,8 @@ is a unit, all logs of children of the unit will be shown\&. .sp This parameter can be specified multiple times\&. +.sp +Added in version 198\&. .RE .PP \fB\-t\fR, \fB\-\-identifier=\fR\fB\fISYSLOG_IDENTIFIER\fR\fR @@ -315,6 +345,8 @@ Show messages for the specified syslog identifier \fISYSLOG_IDENTIFIER\fR\&. .sp This parameter can be specified multiple times\&. +.sp +Added in version 217\&. .RE .PP \fB\-p\fR, \fB\-\-priority=\fR @@ -332,6 +364,8 @@ and 7/"debug"), or a range of numeric/text log levels in the form FROM\&.\&.TO\& "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\&. +.sp +Added in version 188\&. .RE .PP \fB\-\-facility=\fR @@ -340,6 +374,8 @@ Filter output by syslog facility\&. Takes a comma\-separated list of numbers or \fBsyslog\fR(3)\&. \fB\-\-facility=help\fR may be used to display a list of known facility names and exit\&. +.sp +Added in version 245\&. .RE .PP \fB\-g\fR, \fB\-\-grep=\fR @@ -355,14 +391,20 @@ If the pattern is all lowercase, matching is case insensitive\&. Otherwise, matc option, see below\&. .sp When used with -\fB\-\-lines=\fR, +\fB\-\-lines=\fR +(not prefixed with +"+"), \fB\-\-reverse\fR is implied\&. +.sp +Added in version 237\&. .RE .PP \fB\-\-case\-sensitive\fR\fB[=BOOLEAN]\fR .RS 4 Make pattern matching case sensitive or case insensitive\&. +.sp +Added in version 237\&. .RE .PP \fB\-k\fR, \fB\-\-dmesg\fR @@ -371,6 +413,8 @@ Show only kernel messages\&. This implies \fB\-b\fR and adds the match "_TRANSPORT=kernel"\&. +.sp +Added in version 205\&. .RE .SH "OUTPUT OPTIONS" .PP @@ -383,6 +427,8 @@ Controls the formatting of the journal entries that are shown\&. Takes one of th \fBshort\fR .RS 4 is the default and generates an output that is mostly identical to the formatting of classic syslog files, showing one line per journal entry\&. +.sp +Added in version 206\&. .RE .PP \fBshort\-full\fR @@ -394,11 +440,17 @@ and options accept\&. Unlike the timestamp information shown in \fBshort\fR output mode this mode includes weekday, year and timezone information in the output, and is locale\-independent\&. +.sp +Added in version 232\&. .RE .PP \fBshort\-iso\fR .RS 4 -is very similar, but shows ISO 8601 wallclock timestamps\&. +is very similar, but shows timestamps in the +\m[blue]\fBRFC 3339\fR\m[]\&\s-2\u[2]\d\s+2 +profile of ISO 8601\&. +.sp +Added in version 206\&. .RE .PP \fBshort\-iso\-precise\fR @@ -406,21 +458,22 @@ is very similar, but shows ISO 8601 wallclock timestamps\&. as for \fBshort\-iso\fR but includes full microsecond precision\&. -.RE -.PP -\fB\-\-truncate\-newline\fR -.RS 4 -Truncate each log message at the first newline character on output, so that only the first line of each message is displayed\&. +.sp +Added in version 234\&. .RE .PP \fBshort\-precise\fR .RS 4 is very similar, but shows classic syslog timestamps with full microsecond precision\&. +.sp +Added in version 207\&. .RE .PP \fBshort\-monotonic\fR .RS 4 is very similar, but shows monotonic timestamps instead of wallclock timestamps\&. +.sp +Added in version 206\&. .RE .PP \fBshort\-delta\fR @@ -429,30 +482,38 @@ as for \fBshort\-monotonic\fR but includes the time difference to the previous entry\&. Maybe unreliable time differences are marked by a "*"\&. +.sp +Added in version 252\&. .RE .PP \fBshort\-unix\fR .RS 4 is very similar, but shows seconds passed since January 1st 1970 UTC instead of wallclock timestamps ("UNIX time")\&. The time is shown with microsecond accuracy\&. +.sp +Added in version 230\&. .RE .PP \fBverbose\fR .RS 4 shows the full\-structured entry items with all fields\&. +.sp +Added in version 206\&. .RE .PP \fBexport\fR .RS 4 serializes the journal into a binary (but mostly text\-based) stream suitable for backups and network transfer (see -\m[blue]\fBJournal Export Format\fR\m[]\&\s-2\u[2]\d\s+2 +\m[blue]\fBJournal Export Format\fR\m[]\&\s-2\u[3]\d\s+2 for more information)\&. To import the binary stream back into native journald format use \fBsystemd-journal-remote\fR(8)\&. +.sp +Added in version 206\&. .RE .PP \fBjson\fR .RS 4 formats entries as JSON objects, separated by newline characters (see -\m[blue]\fBJournal JSON Format\fR\m[]\&\s-2\u[3]\d\s+2 +\m[blue]\fBJournal JSON Format\fR\m[]\&\s-2\u[4]\d\s+2 for more information)\&. Field values are generally encoded as JSON strings, with three exceptions: .sp .RS 4 @@ -492,24 +553,32 @@ Fields containing non\-printable or non\-UTF8 bytes are encoded as arrays contai .RE .sp Note that this encoding is reversible (with the exception of the size limit)\&. +.sp +Added in version 206\&. .RE .PP \fBjson\-pretty\fR .RS 4 formats entries as JSON data structures, but formats them in multiple lines in order to make them more readable by humans\&. +.sp +Added in version 206\&. .RE .PP \fBjson\-sse\fR .RS 4 formats entries as JSON data structures, but wraps them in a format suitable for -\m[blue]\fBServer\-Sent Events\fR\m[]\&\s-2\u[4]\d\s+2\&. +\m[blue]\fBServer\-Sent Events\fR\m[]\&\s-2\u[5]\d\s+2\&. +.sp +Added in version 206\&. .RE .PP \fBjson\-seq\fR .RS 4 formats entries as JSON data structures, but prefixes them with an ASCII Record Separator character (0x1E) and suffixes them with an ASCII Line Feed character (0x0A), in accordance with -\m[blue]\fBJavaScript Object Notation (JSON) Text Sequences\fR\m[]\&\s-2\u[5]\d\s+2 +\m[blue]\fBJavaScript Object Notation (JSON) Text Sequences\fR\m[]\&\s-2\u[6]\d\s+2 ("application/json\-seq")\&. +.sp +Added in version 240\&. .RE .PP \fBcat\fR @@ -517,15 +586,26 @@ formats entries as JSON data structures, but prefixes them with an ASCII Record generates a very terse output, only showing the actual message of each journal entry with no metadata, not even a timestamp\&. If combined with the \fB\-\-output\-fields=\fR option will output the listed fields for each log record, instead of the message\&. +.sp +Added in version 206\&. .RE .PP \fBwith\-unit\fR .RS 4 similar to \fBshort\-full\fR, but prefixes the unit and user unit names instead of the traditional syslog identifier\&. Useful when using templated instances, as it will include the arguments in the unit names\&. +.sp +Added in version 239\&. .RE .RE .PP +\fB\-\-truncate\-newline\fR +.RS 4 +Truncate each log message at the first newline character on output, so that only the first line of each message is displayed\&. +.sp +Added in version 254\&. +.RE +.PP \fB\-\-output\-fields=\fR .RS 4 A comma separated list of the fields which should be included in the output\&. This has an effect only for the output modes which would normally show all fields (\fBverbose\fR, @@ -541,17 +621,22 @@ and "__MONOTONIC_TIMESTAMP", and "_BOOT_ID" fields are always printed\&. +.sp +Added in version 236\&. .RE .PP \fB\-n\fR, \fB\-\-lines=\fR .RS 4 -Show the most recent journal events and limit the number of events shown\&. If -\fB\-\-follow\fR -is used, this option is implied\&. The argument is a positive integer or +Show the most recent journal events and limit the number of events shown\&. The argument is a positive integer or "all" -to disable line limiting\&. The default value is 10 if no argument is given\&. +to disable the limit\&. Additionally, if the number is prefixed with +"+", the oldest journal events are used instead\&. The default value is 10 if no argument is given\&. .sp -When used with +If +\fB\-\-follow\fR +is used, this option is implied\&. When not prefixed with +"+" +and used with \fB\-\-grep=\fR, \fB\-\-reverse\fR is implied\&. @@ -560,6 +645,8 @@ is implied\&. \fB\-r\fR, \fB\-\-reverse\fR .RS 4 Reverse output so that the newest entries are displayed first\&. +.sp +Added in version 198\&. .RE .PP \fB\-\-show\-cursor\fR @@ -577,17 +664,21 @@ The cursor is shown after the last entry after two dashes: .\} .sp The format of the cursor is private and subject to change\&. +.sp +Added in version 209\&. .RE .PP \fB\-\-utc\fR .RS 4 Express time in Coordinated Universal Time (UTC)\&. +.sp +Added in version 217\&. .RE .PP \fB\-x\fR, \fB\-\-catalog\fR .RS 4 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 -\m[blue]\fBMessage Catalog Developer Documentation\fR\m[]\&\s-2\u[6]\d\s+2\&. +\m[blue]\fBMessage Catalog Developer Documentation\fR\m[]\&\s-2\u[7]\d\s+2\&. .sp Note: when attaching \fBjournalctl\fR @@ -595,6 +686,8 @@ output to bug reports, please do \fInot\fR use \fB\-x\fR\&. +.sp +Added in version 196\&. .RE .PP \fB\-\-no\-hostname\fR @@ -604,6 +697,8 @@ Don\*(Aqt show the hostname field of log messages originating from the local hos family of output modes (see above)\&. .sp Note: this option does not remove occurrences of the hostname from log entries themselves, so it does not prevent the hostname from being visible in the logs\&. +.sp +Added in version 230\&. .RE .PP \fB\-\-no\-full\fR, \fB\-\-full\fR, \fB\-l\fR @@ -614,6 +709,8 @@ The old options \fB\-l\fR/\fB\-\-full\fR are not useful anymore, except to undo \fB\-\-no\-full\fR\&. +.sp +Added in version 196\&. .RE .PP \fB\-a\fR, \fB\-\-all\fR @@ -656,6 +753,8 @@ with some other numeric value, while will disable this cap\&. Note that this option is only supported for the \fBless\fR(1) pager\&. +.sp +Added in version 198\&. .RE .SH "FORWARD SECURE SEALING (FSS) OPTIONS" .PP @@ -667,6 +766,8 @@ command described below: .RS 4 Specifies the change interval for the sealing key when generating an FSS key pair with \fB\-\-setup\-keys\fR\&. Shorter intervals increase CPU consumption but shorten the time range of undetectable journal alterations\&. Defaults to 15min\&. +.sp +Added in version 189\&. .RE .PP \fB\-\-verify\-key=\fR @@ -674,6 +775,8 @@ Specifies the change interval for the sealing key when generating an FSS key pai Specifies the FSS verification key to use for the \fB\-\-verify\fR operation\&. +.sp +Added in version 189\&. .RE .PP \fB\-\-force\fR @@ -681,29 +784,39 @@ operation\&. When \fB\-\-setup\-keys\fR is passed and Forward Secure Sealing (FSS) has already been configured, recreate FSS keys\&. +.sp +Added in version 206\&. .RE .SH "COMMANDS" .PP -The following commands are understood\&. If none is specified the default is to display journal records\&. +The following commands are understood\&. If none is specified the default is to display journal records: .PP \fB\-N\fR, \fB\-\-fields\fR .RS 4 Print all field names currently used in all entries of the journal\&. +.sp +Added in version 229\&. .RE .PP \fB\-F\fR, \fB\-\-field=\fR .RS 4 Print all possible data values the specified field can take in all entries of the journal\&. +.sp +Added in version 195\&. .RE .PP \fB\-\-list\-boots\fR .RS 4 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\&. +.sp +Added in version 209\&. .RE .PP \fB\-\-disk\-usage\fR .RS 4 Shows the current disk usage of all journal files\&. This shows the sum of the disk usage of all archived and active journal files\&. +.sp +Added in version 190\&. .RE .PP \fB\-\-vacuum\-size=\fR, \fB\-\-vacuum\-time=\fR, \fB\-\-vacuum\-files=\fR @@ -724,9 +837,8 @@ removes archived journal files older than the specified timespan\&. Accepts the "m", "h", "days", -"months", -"weeks" -and +"weeks", +"months", and "years" suffixes, see \fBsystemd.time\fR(7) @@ -751,17 +863,23 @@ may be combined in a single invocation to enforce any combination of a size, a t These three switches may also be combined with \fB\-\-rotate\fR into one command\&. If so, all active files are rotated first, and the requested vacuuming operation is executed right after\&. The rotation has the effect that all currently active files are archived (and potentially new, empty journal files opened as replacement), and hence the vacuuming operation has the greatest effect as it can take all log data written so far into account\&. +.sp +Added in version 218\&. .RE .PP \fB\-\-verify\fR .RS 4 Check the journal file for internal consistency\&. If the file has been generated with FSS enabled and the FSS verification key has been specified with \fB\-\-verify\-key=\fR, authenticity of the journal file is verified\&. +.sp +Added in version 189\&. .RE .PP \fB\-\-sync\fR .RS 4 Asks the journal daemon to write all yet unwritten journal data to the backing file system and synchronize all journals\&. This call does not return until the synchronization operation is complete\&. This command guarantees that any log messages written before its invocation are safely stored on disk at the time it returns\&. +.sp +Added in version 228\&. .RE .PP \fB\-\-relinquish\-var\fR @@ -774,6 +892,8 @@ and stops writing to \fB\-\-flush\fR causes the log output to switch back to /var/log/journal/, see above\&. +.sp +Added in version 243\&. .RE .PP \fB\-\-smart\-relinquish\-var\fR @@ -784,6 +904,8 @@ Similar to reside on the same mount point\&. This operation is used during system shutdown in order to make the journal daemon stop writing data to /var/log/journal/ in case that directory is located on a mount point that needs to be unmounted\&. +.sp +Added in version 243\&. .RE .PP \fB\-\-flush\fR @@ -800,6 +922,8 @@ once during system runtime (but see below), and this command exits cleanly without executing any operation if this has already happened\&. This command effectively guarantees that all data is flushed to /var/log/journal/ at the time it returns\&. +.sp +Added in version 217\&. .RE .PP \fB\-\-rotate\fR @@ -810,6 +934,8 @@ Asks the journal daemon to rotate journal files\&. This call does not return unt and \fB\-\-vacuum\-file=\fR into a single command, see above\&. +.sp +Added in version 227\&. .RE .PP \fB\-\-header\fR @@ -817,6 +943,8 @@ into a single command, see above\&. Instead of showing journal contents, show internal header information of the journal fields accessed\&. .sp This option is particularly useful when trying to identify out\-of\-order journal entries, as happens for example when the machine is booted with the wrong system time\&. +.sp +Added in version 187\&. .RE .PP \fB\-\-list\-catalog \fR\fB[\fI128\-bit\-ID\&...\fR]\fR @@ -825,6 +953,8 @@ List the contents of the message catalog as a table of message IDs, plus their s .sp If any \fI128\-bit\-ID\fRs are specified, only those entries are shown\&. +.sp +Added in version 196\&. .RE .PP \fB\-\-dump\-catalog \fR\fB[\fI128\-bit\-ID\&...\fR]\fR @@ -835,11 +965,15 @@ files)\&. .sp If any \fI128\-bit\-ID\fRs are specified, only those entries are shown\&. +.sp +Added in version 199\&. .RE .PP \fB\-\-update\-catalog\fR .RS 4 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\&. +.sp +Added in version 196\&. .RE .PP \fB\-\-setup\-keys\fR @@ -849,6 +983,8 @@ Instead of showing journal contents, generate a new key pair for Forward Secure option in \fBjournald.conf\fR(5) for information on Forward Secure Sealing and for a link to a refereed scholarly paper detailing the cryptographic theory it is based on\&. +.sp +Added in version 189\&. .RE .PP \fB\-h\fR, \fB\-\-help\fR @@ -996,6 +1132,12 @@ will be ignored by the executable, and needs to be handled by the pager\&. This option instructs the pager to not send termcap initialization and deinitialization strings to the terminal\&. It is set by default to allow command output to remain visible in the terminal even after the pager exits\&. Nevertheless, this prevents some pager functionality from working, in particular paged output cannot be scrolled with the mouse\&. .RE .sp +Note that setting the regular +\fI$LESS\fR +environment variable has no effect for +\fBless\fR +invocations by systemd tools\&. +.sp See \fBless\fR(1) for more discussion\&. @@ -1007,6 +1149,12 @@ Override the charset passed to \fBless\fR (by default "utf\-8", if the invoking terminal is determined to be UTF\-8 compatible)\&. +.sp +Note that setting the regular +\fI$LESSCHARSET\fR +environment variable has no effect for +\fBless\fR +invocations by systemd tools\&. .RE .PP \fI$SYSTEMD_PAGERSECURE\fR @@ -1207,26 +1355,31 @@ Discoverable Partitions Specification \%https://uapi-group.org/specifications/specs/discoverable_partitions_specification .RE .IP " 2." 4 +RFC 3339 +.RS 4 +\%https://tools.ietf.org/html/rfc3339 +.RE +.IP " 3." 4 Journal Export Format .RS 4 \%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format .RE -.IP " 3." 4 +.IP " 4." 4 Journal JSON Format .RS 4 \%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-json-format .RE -.IP " 4." 4 +.IP " 5." 4 Server-Sent Events .RS 4 \%https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events .RE -.IP " 5." 4 +.IP " 6." 4 JavaScript Object Notation (JSON) Text Sequences .RS 4 \%https://tools.ietf.org/html/rfc7464 .RE -.IP " 6." 4 +.IP " 7." 4 Message Catalog Developer Documentation .RS 4 \%https://www.freedesktop.org/wiki/Software/systemd/catalog |