From cac40fbe240565c9431f3f535b0523bd3a7fe225 Mon Sep 17 00:00:00 2001 From: Steven Hiscocks Date: Tue, 19 Feb 2013 20:39:45 +0000 Subject: [PATCH] systemd-python: Added doc string for Journal --- src/python-systemd/journal.py | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/src/python-systemd/journal.py b/src/python-systemd/journal.py index 5c5f5ca05..d63722b91 100644 --- a/src/python-systemd/journal.py +++ b/src/python-systemd/journal.py @@ -79,6 +79,24 @@ else: _convert_unicode = _functools.partial(unicode, encoding='utf-8') class Journal(_Journal): + """Journal allows the access and filtering of systemd journal + entries. Note that in order to access the system journal, a + non-root user must be in the `adm` group. + + Example usage to print out all error or higher level messages + for systemd-udevd for the boot: + + >>> myjournal = journal.Journal() + >>> myjournal.add_boot_match(journal.CURRENT_BOOT) + >>> myjournal.add_loglevel_matches(journal.LOG_ERR) + >>> myjournal.add_match(_SYSTEMD_UNIT="systemd-udevd.service") + >>> from __future__ import print_function + >>> for entry in myjournal: + ... print(entry['MESSAGE']) + + See man page "systemd.journal-fields" for more info on + typical fields found in the journal. + """ def __init__(self, converters=None, flags=LOCAL_ONLY, path=None): """Creates instance of Journal, which allows filtering and return of journal entries. -- 2.30.2