PROJECT MOVED -> https://lab.nexedi.com/nexedi/usersyslog
[usersyslog.git] / README
1 usersyslog - redirect syslog accesses to a specific unix socket.
2
3 Rationale
4 ---------
5
6 The need is to customise the socket used to send log lines to syslog, so as
7 to direct logging of processes to a user-specified (typically, user-controlled)
8 syslog daemon. Useful for software packages only able to log via syslog
9 (ex: postfix).
10 User syslog daemon must be able to bind to non-default socket path.
11
12 Limitations
13 -----------
14
15 This library relies on LD_PRELOAD mechanism, so it inherits its limitations
16 (it will not work on suid binaries, ...).
17
18 Requirements
19 ------------
20
21 - make
22 - gcc (source uses __attribute__)
23 - glibc (source uses RTLD_NEXT)
24
25 Building
26 --------
27
28 Just run "make".
29
30 Usage
31 -----
32
33 $ LOG_SOCKET=/path/to/custom/log/socket LD_PRELOAD=/path/to/usersyslog <command>
34
35 `usersyslog` is also an executable wrapper that appends itself to LD_PRELOAD:
36
37 $ LOG_SOCKET=/path/to/custom/log/socket usersyslog <command>