X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=f9abbfb2308ffe0267d47c13fe9cdba35b36af7a;hb=02b89260ce14bfae9167b7ca64bb196592b3573d;hp=f6e46cfbc737dbcd44c9be5f224666e6f638f645;hpb=18b754d345ecb0b15e369978aaffa72e9814b86a;p=elogind.git
diff --git a/man/journalctl.xml b/man/journalctl.xml
index f6e46cfbc..f9abbfb23 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -8,16 +8,16 @@
Copyright 2012 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
@@ -49,26 +49,42 @@
- journalctl OPTIONSMATCH
+ journalctl OPTIONSMATCHESDescription
- journalctl may be
- used to query the contents of the
+ journalctl may be used to
+ query the contents of the
systemd1
- journal.
+ journal as written by
+ systemd-journald.service8.If called without parameter will show the full
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.
+ 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. 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
@@ -106,9 +122,9 @@
- Do not pipe output into a
- pager.
-
+ Do not pipe output into a
+ pager.
+
@@ -125,7 +141,7 @@
Show only most recent
- journal entries, and continously print
+ journal entries, and continuously print
new entries as they are appended to
the journal.
@@ -173,9 +189,9 @@
is very similar but shows monotonic
timestamps instead of wallclock
timestamps. verbose
- shows the full structered entry items
+ shows the full structured entry items
with all
- fiels. export
+ fields. export
serializes the journal into a binary
(but mostly text-based) stream
suitable for backups and network
@@ -193,7 +209,7 @@
Suppresses any warning
- message regarding inaccessable system
+ message regarding inaccessible system
journals when run as normal
user.
@@ -206,6 +222,26 @@
generated messages.
+
+
+
+
+ Show data only from
+ current boot.
+
+
+
+
+
+
+ Takes an absolute
+ directory path as argument. If
+ specified will operate on the
+ specified journal directory instead of
+ the default runtime and system journal
+ paths.
+
+
@@ -222,6 +258,15 @@
similar.
+
+
+
+ Instead of showing
+ journal contents show internal header
+ information of the journal fiels
+ accessed.
+
+
@@ -248,11 +293,44 @@
+
+ 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 Alsosystemd1,
+ systemd-journald.service8,
systemctl1,
+ systemd.journal-fields7,
journald.conf5