X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=cd17ca6ae7fb33d5e3b3723bdb8d087254e6db9d;hb=ab060556a9e1ebb2744719a29985e40919101a22;hp=4728d36e1c5ca197ce89528d5f7eb8bb55cf5450;hpb=6df831f25ebc9f55cd939f04392dad9237706e45;p=elogind.git
diff --git a/man/journalctl.xml b/man/journalctl.xml
index 4728d36e1..cd17ca6ae 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,28 +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. 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
@@ -108,9 +122,9 @@
- Do not pipe output into a
- pager.
-
+ Do not pipe output into a
+ pager.
+
@@ -127,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.
@@ -159,8 +173,8 @@
Controls the
- formatting of the journal entries that are
- shown. Takes one of
+ formatting of the journal entries that
+ are shown. Takes one of
short,
short-monotonic,
verbose,
@@ -175,13 +189,16 @@
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
- transfer. json
+ transfer (see Journal
+ Export Format for more
+ information). json
formats entries as JSON data
structures. cat
generates a very terse output only
@@ -195,7 +212,7 @@
Suppresses any warning
- message regarding inaccessable system
+ message regarding inaccessible system
journals when run as normal
user.
@@ -208,6 +225,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.
+
+
@@ -224,6 +261,47 @@
similar.
+
+
+
+ Instead of showing
+ journal contents show internal header
+ information of the journal fiels
+ accessed.
+
+
+
+
+
+
+ Filter output by
+ message priorities or priority
+ ranges. Takes either a single numeric
+ or textual log level (i.e. between
+ 0/emerg and
+ 7/debug), or a
+ range of numeric/text log levels in
+ the form FROM..TO. The log levels are
+ the usual syslog log levels as
+ documented in
+ syslog3,
+ i.e. emerg (0),
+ alert (1),
+ crit (2),
+ err (3),
+ warning (4),
+ notice (5),
+ info (6),
+ debug (7). If a
+ single log level is specified all
+ messages with this log levels 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.
+
+
@@ -250,10 +328,42 @@
+
+ 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