X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=a5778bf3696b9242b4702f46fabdc185253c00be;hb=44ded3abc28620279633f51a05f2416e5aa3e8e2;hp=3e03c45f1372fb1f566fa00118973a765ec27f0d;hpb=248fc619b5e3e24d78f171f95b85916eee7987bd;p=elogind.git
diff --git a/man/journalctl.xml b/man/journalctl.xml
index 3e03c45f1..a5778bf36 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -251,12 +251,37 @@
+
+
+
+
+
+ is very similar,
+ but shows ISO 8601
+ wallclock timestamps.
+
+
+
+
+
+
+
+
+
+ is very similar,
+ but shows timestamps
+ with full microsecond
+ precision.
+
+
+
+
- is very similar
+ is very similar,
but shows monotonic
timestamps instead of
wallclock timestamps.
@@ -367,7 +392,7 @@
context of an error or log event,
possible solutions, as well as
pointers to support forums, developer
- documentation and any other relevant
+ documentation, and any other relevant
manuals. Note that help texts are not
available for all messages, but only
for selected ones. For more
@@ -375,7 +400,14 @@
please refer to the Message
Catalog Developer
- Documentation.
+ Documentation.
+
+ Note: when attaching
+ journalctl output
+ to bug reports, please do
+ not use
+ .
+
@@ -399,42 +431,50 @@
-
-
+
+
- Show messages from the specified
- boot ID or from
- current boot if no ID
- is given. This will add a match for
+ Show messages from a specific
+ boot. This will add a match for
_BOOT_ID=.
- The argument is a 128 bit ID given in
- short or UUID form and optionally followed by
- :n which identifies the nth
- boot relative to the boot ID given to the left
- of :. Supplying a negative
- value for n will look for a past boot and a
- positive value for a future boot. The boot IDs
- are searched for in chronological order. If no
- number is provided after :,
- -1 is assumed. A value of 0
- is valid and equivalent to omitting
- :0.
-
- Alternatively, the argument may constist
- only of :n. In this case, a
- positive value will look up the nth boot
- starting from the beginning of the jouranl, a
- negative value will look up a previous boot
- relative to the current boot. :0
- will look for the current boot ID. Thus,
- :1 is the first boot found in
- the journal, :2 the second
- and so on; while :-1 is the
- previous boot, :-2 the boot
- before that and so on. Omitting a value after
- : will look for the previous
- boot.
+ The argument may be empty, in which case
+ logs for the current boot will be shown.
+
+ If the boot ID is omitted, a positive
+ offset will look up
+ the boots starting from the beginning of the
+ journal, and a equal-or-less-than zero
+ offset will look up
+ boots starting from the end of the
+ journal. Thus, 1 means the
+ first boot found in the journal in the
+ chronological order, 2 the
+ second and so on; while -0
+ is the last boot, -1 the
+ boot before that, and so on. An empty
+ offset is equivalent
+ to specifying -0, except
+ when the current boot is not the last boot
+ (e.g. because was
+ specified to look at logs from a different
+ machine).
+
+ If the 32 character
+ ID is specified, it
+ may optionally be followed by
+ offset which
+ identifies the boot relative to the one given by
+ boot ID. Negative
+ values mean earlier boots and a positive values
+ mean later boots. If
+ offset is not
+ specified, a value of zero is assumed and the
+ logs for the boot given by
+ ID are shown.
+
+
+
@@ -831,9 +871,9 @@
journalctl /dev/sda
- Show all kernel logs from last boot:
+ Show all kernel logs from previous boot:
- journalctl -k -b :
+ journalctl -k -b -1