X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fjournalctl.xml;h=fa29c4103ca521007485611591c790eafd548e4b;hb=785a51eb682136b2c7ee33fabe64c72d20fa37db;hp=3db5e5dab6783716e0d740f47a50c93d6ee0704e;hpb=fe59e38bef69568c385d10761132458606cdd896;p=elogind.git diff --git a/man/journalctl.xml b/man/journalctl.xml index 3db5e5dab..fa29c4103 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -49,7 +49,9 @@ - journalctl OPTIONS MATCHES + journalctl + OPTIONS + MATCHES @@ -82,7 +84,7 @@ 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 + + appears as separate word on the command line all matches before and after are combined in a disjunction (i.e. logical OR). @@ -136,6 +138,7 @@ + Show all (printable) fields in @@ -171,7 +174,7 @@ implied pager tool. This implies to guarantee that the pager won't buffer logs of - unbounded size. This may be overriden + unbounded size. This may be overridden with an explicit with some other numeric value on the command line. Note that this option is @@ -320,26 +323,44 @@ kernel. + + + + + Show kernel messages from + current boot. This implies + and adds the match _TRANSPORT=kernel. + + + - Show data only of the - specified unit. This will add a match - for _SYSTEMD_UNIT= - for the specified - unit. + Show messages for the + specified systemd unit. This will add + a match for messages from the unit + (_SYSTEMD_UNIT=) + and additional matches for messages + from systemd and messages about + coredumps for the specified unit. + This parameter can be specified multiple times. + - Show data only of the + Show messages for the specified user session unit. This will - add a match for - _SYSTEMD_USER_UNIT= - for the specified - unit. + add a match for messages from the unit + (_SYSTEMD_USER_UNIT= + and _UID=) and + additional matches for messages from + session systemd and messages about + coredumps for the specified unit. + This parameter can be specified multiple times. + @@ -394,14 +415,15 @@ Start showing entries on or newer than the specified date, or on or older than the specified - date, respectively. Date specifications should be of - the format "2012-10-30 18:17:16". If - the time part is omitted, 00:00:00 is - assumed. If only the seconds component - is omitted, :00 is assumed. If the - date component is omitted, the - current day is assumed. Alternatively - the strings + date, respectively. Date specifications + should be of the format + 2012-10-30 18:17:16. + If the time part is omitted, + 00:00:00 is assumed. + If only the seconds component is omitted, + :00 is assumed. If the + date component is omitted, the current + day is assumed. Alternatively the strings yesterday, today, tomorrow are @@ -428,15 +450,57 @@ - - + + + + Show messages from + system services and the kernel (with + ). Show + messages from service of current user + (with ). + If neither is specified, show all + messages that the user can see. + + + + + + + + Takes a directory path + as argument. If specified journalctl + will operate on the specified journal + directory + DIR instead + of the default runtime and system + journal paths. + + + + + + Takes a file glob as + argument. If specified journalctl will + operate on the specified journal files + matching GLOB + instead of the default runtime and + system journal paths. May be specified + multiple times, in which case files will + be suitably interleaved. + + + + - Takes an absolute - directory path as argument. If - specified journalctl will operate on the - specified journal directory instead of - the default runtime and system journal - paths. + Takes a directory path + as argument. If specified journalctl + will operate on catalog file hierarchy + underneath the specified directory + instead of the root directory + (e.g. + will create + ROOT/var/lib/systemd/catalog/database). + @@ -473,12 +537,39 @@ - + List the contents of the message catalog, as table of message IDs plus their short - description strings. + description strings. + + If any + ID128s are + specified, only those entries are shown. + + + + + + + + Show the contents of + the message catalog, with entries + separated by a line consisting of two + dashes and the id (the format is the + same as .catalog + files. + + If any + ID128s are + specified, only those entries are shown. + + @@ -503,7 +594,10 @@ sealing key is stored in the journal data directory and shall remain on the host. The verification key should be - stored externally. + stored externally. Also see the + option in + journald.conf5 + for details. @@ -588,7 +682,7 @@ journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service - If the separator "+" is used + If the separator + is used two expressions 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 @@ -601,7 +695,7 @@ journalctl /usr/bin/dbus-daemon - Show all logs of the kernel device node /dev/sda: + Show all logs of the kernel device node /dev/sda: journalctl /dev/sda