X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=f314fb6d261e239a9e714641db0c74d1a7a483f5;hb=a81df0ad90f0dea0eb272c02efe18934fa66fdf2;hp=ffe988a6190b810360461b0977711eefd8fe2c5f;hpb=a963990ff4ebc7908d3cf82bbd8cf34a42d57b7f;p=elogind.git
diff --git a/man/journalctl.xml b/man/journalctl.xml
index ffe988a61..f314fb6d2 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -49,7 +49,7 @@
- journalctl OPTIONS MATCH
+ journalctl OPTIONS MATCHES
@@ -66,12 +66,25 @@
contents of the journal, starting with the oldest
entry collected.
- If a match argument is passed the output is
- filtered accordingly. A match is in the format
- FIELD=VALUE,
- e.g. _SYSTEMD_UNIT=httpd.service. See
+ If one or more match arguments are passed the
+ output is filtered accordingly. A match is in the
+ format FIELD=VALUE,
+ e.g. _SYSTEMD_UNIT=httpd.service,
+ referring to the components of a structured journal
+ entry. See
systemd.journal-fields7
- for a list of well-known fields.
+ for a list of well-known fields. If multiple matches
+ are specified matching different fields the log
+ entries are filtered by both, i.e. the resulting output
+ will show only entries matching all the specified
+ matches of this kind. If two matches apply to the same
+ field, then they are automatically matched as
+ 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
+ command line all matches before and after are combined
+ in a disjunction (i.e. logical OR).
Output is interleaved from all accessible
journal files, whether they are rotated or currently
@@ -223,7 +236,7 @@
Takes an absolute
directory path as argument. If
- specified will opearte on the
+ specified will operate on the
specified journal directory instead of
the default runtime and system journal
paths.
@@ -271,6 +284,37 @@
+
+ Examples
+
+ Without arguments all collected logs are shown
+ unfiltered:
+
+ journalctl
+
+ With one match specified all entries with a field matching the expression are shown:
+
+ journalctl _SYSTEMD_UNIT=avahi-daemon.service
+
+ If two different fields are matched only entries matching both expressions at the same time are shown:
+
+ journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097
+
+ If two matches refer to the same field all entries matching either expression are shown:
+
+ 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
+ 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
+ processes):
+
+ journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service
+
+
+
See Also