summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDavid Strauss <david@davidstrauss.net>2012-09-06 18:22:08 -0700
committerDavid Strauss <david@davidstrauss.net>2012-09-06 18:22:08 -0700
commit5f531b971e8c75cd9c93044dcdd46880c65d0502 (patch)
treed5286b0886193393f5e9dad5d9640825ae0c505e /README.md
parent7f96f34f10c89ad0f62c58997f9ec542d9bbd255 (diff)
downloadpython-systemd-5f531b971e8c75cd9c93044dcdd46880c65d0502.tar.gz
Add Python 3 instructions.
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 12 insertions, 7 deletions
diff --git a/README.md b/README.md
index 2cf53c1..88aac93 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,25 @@
-journald-python
+python-systemd
===============
-Python module for native access to the journald facilities in recent
-versions of systemd. In particular, this capability includes passing
-key/value pairs as fields that journald can use for filtering.
+Python module for native access to the systemd facilities in recent versions
+of Fedora and other distributions. In particular, this capability includes
+passing key/value pairs as fields that the journal can display and use for
+filtering. There are also utilities to forward journal entries to aggregators
+like Graylog2 via GELF.
Installation
============
-On Fedora 17+:
+On Fedora 17+ with Python 2:
sudo yum install git python-pip gcc python-devel systemd-devel
pip-python install git+http://github.com/systemd/python-systemd.git#egg=systemd
+On Fedora 17+ with Python 3:
+
+ sudo yum install git python3-pip gcc python3-devel systemd-devel
+ pip-python3 install git+http://github.com/systemd/python-systemd.git#egg=systemd
+
Usage
=====
@@ -43,8 +50,6 @@ Notes:
printf-style substitution is not supported. Perform any
substitution using Python's % operator or .format() capabilities
first.
- * The base message is usually sent in the form MESSAGE=hello. The
- MESSAGE field is, however, not required.
* A ValueError is thrown is thrown if sd_journald_sendv() results in
an error. This might happen if there are no arguments or one of them
is invalid.