Like all solutions using 'LD_PRELOAD' it only works with dynamically linked
binaries. Statically linked binaries, for example valgrind, are not supported.
+setuid binaries are also not supported ('LD_PRELOAD' disabled for security
+reasons).
It was inspired by stderred [2]. Similar solutions (using 'LD_PRELOAD')
the library. Just remove the file first and then copy it. `make install`
handles the install in this way and is therefore not affected.
+As a simple safeguard, `make` builds and installs the `libcoloredstderr.so`
+file non-writable to prevent accidental overwrites. Even if the overwrite is
+forced with `cp -f`, the file is unlinked and recreated by `cp` because the
+file is non-writable, preventing the problem.
+
USAGE
-----
The following additional environment variables are available:
- 'COLORED_STDERR_PRE'
- String to write before each write to stderr, defaults to "\033[91m" (bright
- red).
+ String to write before each write to stderr, defaults to "\033[31m" (red).
- 'COLORED_STDERR_POST'
String to write after each write to stderr, defaults to "\033[0m" (reset
color).
terminal, e.g. when writing to a file. By default, only writes to a terminal
are colored.
+All environment variables starting with 'COLORED_STDERR_PRIVATE_*' are
+internal variables used by the implementation and should not be set manually.
+See the source for details.
+
+
+To set custom colors as pre/post strings you can use the `$''` feature of Bash
+and Zsh:
+
+ export COLORED_STDERR_PRE=$'\033[91m' # bright red
+ export COLORED_STDERR_POST=$'\033[0m' # default
+
+Or to be more compatible you can use the following which should work in any
+Bourne shell:
+
+ esc=`printf '\033'`
+ COLORED_STDERR_PRE="${esc}[91m" # red
+ COLORED_STDERR_POST="${esc}[0m" # default
+ export COLORED_STDERR_PRE COLORED_STDERR_POST
+
DEBUG
-----
warnings are appended at the end.
+KNOWN ISSUES
+------------
+
+- `{fputc,putc,putchar}_unlocked()` are not hooked when writing to stdout
+ (which might be redirected to stderr). Can't be fixed as the compiler
+ inlines the code into the program without calling any function.
+
+
BUGS
----