From d121b396ccb19dc33aacfc75a7f7a719914267c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Tue, 16 Jul 2013 15:56:22 -0400 Subject: journalctl: remove ":" from the --boot syntax Instead of :-0, :1, :5, etc., use -0, 1 or +1, 5, etc. For BOOT_ID+OFFSET, use BOOT_ID+offset or BOOT_ID-offset (either + or - is required). Also make error handling a bit more robust and verbose. Modify the man page to describe the most common case (-b) first, and the second most common case (-b -1) second. --- man/journalctl.xml | 74 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 41 insertions(+), 33 deletions(-) (limited to 'man/journalctl.xml') diff --git a/man/journalctl.xml b/man/journalctl.xml index 3e03c45f1..65a59ea4e 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -399,42 +399,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. + + + -- cgit v1.2.3