diff options
author | Gergely Nagy <algernon@balabit.hu> | 2012-08-10 14:07:29 +0200 |
---|---|---|
committer | Gergely Nagy <algernon@balabit.hu> | 2012-08-10 16:53:06 +0200 |
commit | 8af1d67bd3e8a1766cb9984b3771162cc4c19669 (patch) | |
tree | d77ebb9f38a81c98a40bf41cbdc2548f987fd645 /README.rst | |
parent | 7d21f9316f32168acefcfe40b5b4b91c8378369c (diff) | |
download | libumberlog-8af1d67bd3e8a1766cb9984b3771162cc4c19669.tar.gz libumberlog-8af1d67bd3e8a1766cb9984b3771162cc4c19669.tar.xz libumberlog-8af1d67bd3e8a1766cb9984b3771162cc4c19669.zip |
Split the library into a linkable and an LD_PRELOAD-able part
In order to satisfy the desire of using libumberlog, specifically
ul_format(), without having to worry about syslog() & friends being
overridden, split the library into two parts:
A linkable library, which provides the new API, but does not override
the legacy syslog() functions; and a new, LD_PRELOAD-able part, which
does override the old ones.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 19 |
1 files changed, 10 insertions, 9 deletions
@@ -81,15 +81,16 @@ The library follows the usual autotools way of installation: Usage ----- -The library can either be used as an LD_PRELOAD-able shared object, in -which case it overrides the system-supplied ``syslog()`` calls with -its own, or as a proper library. In the latter case, please see the -`API documentation`_ for more information. - -In the former case, using the library is as easy as setting -**LD_PRELOAD** prior to executing a program (if one wants to control -this on a per-program basis), or adding the path to the installed -library to ``/etc/ld.so.preload``. +The library comes in two variants: one to link against, and provides +an enhanced, ``syslog()``-like API. For this, please see the `API +documentation`_ for more information. + +The other variant is an LD_PRELOAD-able shared object, installed as +``libumberlog_preload.so`` into a subdirectory of one's libdir. This +one overrides the system-suploed ``syslog()`` calls with its own +version, and turns these into CEE-emitting functions. It can be used +either on a per-application basis, by setting **LD_PRELOAD**, or +adding the path to the library to ``/etc/ld.so.preload``. .. _API documentation: http://algernon.github.com/libumberlog/umberlog.html |