X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fjournalctl.xml;h=f9abbfb2308ffe0267d47c13fe9cdba35b36af7a;hp=efceefa43ffb3b68ae357baa7d37b47df22d4faa;hb=dca6219e04505e9fa10b32e71059ce2abfae1dad;hpb=2bd3c38a44c5c3acbf5afdb9c0bcbaf4a72dac3f diff --git a/man/journalctl.xml b/man/journalctl.xml index efceefa43..f9abbfb23 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 . --> @@ -44,32 +44,47 @@ journalctl - systemd-journalctl Query the systemd journal - journalctl OPTIONS MATCH + journalctl OPTIONS MATCHES Description - 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. + 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. 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 @@ -107,9 +122,9 @@ - Do not pipe output into a - pager. - + Do not pipe output into a + pager. + @@ -126,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. @@ -174,9 +189,9 @@ 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 @@ -194,7 +209,7 @@ Suppresses any warning - message regarding inaccessable system + message regarding inaccessible system journals when run as normal user. @@ -207,6 +222,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. + + @@ -223,6 +258,15 @@ similar. + + + + Instead of showing + journal contents show internal header + information of the journal fiels + accessed. + + @@ -249,12 +293,45 @@ + + 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 Also systemd1, + systemd-journald.service8, systemctl1, - systemd-journald.conf5 + systemd.journal-fields7, + journald.conf5