X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fjournalctl.xml;h=65a59ea4e73b8b62bb7bb453e0dde5374165f3af;hp=3e03c45f1372fb1f566fa00118973a765ec27f0d;hb=d121b396ccb19dc33aacfc75a7f7a719914267c8;hpb=affba8e90243526be673ad9f9b306a740b8824a6 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. + + +