X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=83ddf5c3d66ee64fd6f9d38a91daf4a483964c05;hb=0675cc4a02dfa3e7abc47d0c2117bf413b1d7698;hp=cd17ca6ae7fb33d5e3b3723bdb8d087254e6db9d;hpb=941e990db1f2682abaa2966b1c48602901d0c599;p=elogind.git diff --git a/man/journalctl.xml b/man/journalctl.xml index cd17ca6ae..83ddf5c3d 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. @@ -86,6 +86,15 @@ command line all matches before and after are combined in a disjunction (i.e. logical OR). + As shortcuts for a few types of field/value + matches file paths may be specified. If a file path + refers to an executable file, this is equivalent to an + _EXE= match for the canonicalized + binary path. Similar, if a path refers to a device + node, this is equivalent to a + _KERNEL_DEVICE= match for the + device. + Output is interleaved from all accessible journal files, whether they are rotated or currently being written, and regardless whether they belong to the @@ -140,7 +149,7 @@ - Show only most recent + Show only the most recent journal entries, and continuously print new entries as they are appended to the journal. @@ -180,6 +189,7 @@ verbose, export, json, + json-pretty, cat. short is the default and generates an output that is mostly identical to the @@ -200,7 +210,13 @@ Export Format for more information). json formats entries as JSON data - structures. cat + structures, one per + line. 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 generates a very terse output only showing the actual message of each journal entry with no meta data, not @@ -218,11 +234,13 @@ - - + + - Show only locally - generated messages. + Show entries + interleaved from all available + journals, including remote + ones. @@ -239,37 +257,12 @@ Takes an absolute directory path as argument. If - specified will operate on the + specified journalctl will operate on the specified journal directory instead of the default runtime and system journal paths. - - - - Instead of showing - 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 - introduce and want to make - recognizable. Will print the new ID in - three different formats which can be - copied into source code or - similar. - - - - - - Instead of showing - journal contents show internal header - information of the journal fiels - accessed. - - @@ -294,7 +287,7 @@ 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, @@ -302,6 +295,89 @@ value of the range. + + + + Instead of showing + 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 + introduce and want to make + recognizable. Will print the new ID in + three different formats which can be + copied into source code or + similar. + + + + + + Instead of showing + journal contents show internal header + information of the journal fields + accessed. + + + + + + Shows the current disk + usage of all + journal files. + + + + + + Instead of showing + journal contents generate a new key + pair for Forward Secure Sealing + (FSS). This will generate a sealing + key and a verification key. The + sealing key is stored in the journal + data directory and shall remain on the + host. The verification key should be + stored externally. + + + + + + Specifies the change + interval for the sealing key, when + generating an FSS key pair with + . Shorter + intervals increase CPU consumption but + shorten the time range of + undetectable journal + alterations. Defaults to + 15min. + + + + + + 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 + + authenticity of the journal file is + verified. + + + + + + Specifies the FSS + verification key to use for the + + operation. + + @@ -349,7 +425,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 @@ -357,6 +433,14 @@ journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service + Show all logs generated by the D-Bus executable: + + journalctl /usr/bin/dbus-daemon + + Show all logs of the kernel device node /dev/sda: + + journalctl /dev/sda +