X-Git-Url: https://ruderich.org/simon/gitweb/?a=blobdiff_plain;f=README;h=b4101b8dd324d4d71866d448fdbaed4270b12497;hb=bcac94e353755b4e48016b25543ab038e1bfd279;hp=7320731f362add7830cec7c920f135d54f2cb6e4;hpb=ba93304c54307da16900993f94b4743978a3257d;p=coloredstderr%2Fcoloredstderr.git diff --git a/README b/README index 7320731..b4101b8 100644 --- a/README +++ b/README @@ -3,7 +3,7 @@ README coloredstderr is a small library which uses 'LD_PRELOAD' to color stderr. It ``follows'' dups, has minimal performance overhead and can ignore certain -binaries (requires /proc). +binaries. Like all solutions using 'LD_PRELOAD' it only works with dynamically linked binaries. Statically linked binaries, for example valgrind, are not supported. @@ -40,6 +40,9 @@ DEPENDENCIES INSTALLATION ------------ +If you're using the Git version, run `autoreconf -fsi` first to generate +`configure`. + ./configure && make && make check Then either install the library with `make install` or just copy it from @@ -101,6 +104,7 @@ The following additional environment variables are available: Comma separated list of binary names/paths which should not be tracked (including their children). Useful for `reset` which writes to the terminal, but fails to work if the output is colored. See below for an example. + Requires `/proc/self/exe`. All environment variables starting with 'COLORED_STDERR_PRIVATE_*' are internal variables used by the implementation and should not be set manually. @@ -158,8 +162,8 @@ KNOWN ISSUES inlines the code into the program without calling any function. - Test `test_stdio.sh` fails on FreeBSD, because FreeBSD does handle the above correctly (no inlining), but the test is designed for GNU/Linux. -- 'COLORED_STDERR_IGNORED_BINARIES' requires the `/proc` file system. - Suggestions welcome. +- 'COLORED_STDERR_IGNORED_BINARIES' requires `/proc/self/exe`. Suggestions + welcome. - Output of `strace` is not always colored correctly as the output from `coloredstderr` is traced and displayed as well. Suggestions welcome. @@ -182,7 +186,7 @@ LICENSE coloredstderr is licensed under GPL version 3 or later. -Copyright (C) 2013 Simon Ruderich +Copyright (C) 2013-2014 Simon Ruderich This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by