diff options
| author | Shehjar Tikoo <shehjart@gluster.com> | 2009-09-15 01:03:56 +0000 |
|---|---|---|
| committer | Anand V. Avati <avati@dev.gluster.com> | 2009-09-15 00:01:50 -0700 |
| commit | a5f0b3d7d1b23053ce9327be91323e92ce554b32 (patch) | |
| tree | d9aee1e46b23b3b40c26c8da1501fe2d3ac9e5cf /extras/test/ld-preload-test/README | |
| parent | ad33df39dec4850c249c453822a99b3038b41389 (diff) | |
extras: Add LD_PRELOAD test tool
This tool allows us to check the sanity of the LD_PRELOAD
mechanism so that we can be sure that an application's syscalls
will be redirected into booster when that library is LD_PRELOADed.
In case of failed syscalls, this tool should be run first
to see if the calls are redirected as required.
Signed-off-by: Anand V. Avati <avati@dev.gluster.com>
BUG: 251 (Improve booster debugging through ld-preload testing tool)
URL: http://bugs.gluster.com/cgi-bin/bugzilla3/show_bug.cgi?id=251
Diffstat (limited to 'extras/test/ld-preload-test/README')
| -rw-r--r-- | extras/test/ld-preload-test/README | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/extras/test/ld-preload-test/README b/extras/test/ld-preload-test/README new file mode 100644 index 000000000..725b94023 --- /dev/null +++ b/extras/test/ld-preload-test/README @@ -0,0 +1,40 @@ +ld-preload-test +=============== +1. The idea of this test tool is to check the sanity of the LD_PRELOAD +mechanism in libc for the system on which booster needs to run. + +2. Basically, this test tool calls various system calls for which there is +support in the booster library. Combined with the logging output from this +tool and the preload-test-lib, one can determine whether the +pre-loading mechanism is working working in order for booster to initialize. + +3. This tool does not test GlusterFS functionality running under booster +although the path specified to the tool can be a GlusterFS mountpoint but +that is not very useful. + +4. This tool is incomplete without the preload-test-lib and the +accompanyung shell script that needs to be run for running the test. + +ld-preload-lib.so +================= +A very simple library that intercepts booster supported system calls +and prints a log message to stdout. +Combined with the ld-preload-test, we cam determine whether all system calls +are getting redirected into this library when LD_PRELOAD'ed. This helps us +conduct a basic test to ensure that the required syscalls actually will +be intercepted by the booster library. + + +Instructions +============ + +1. Build the binaries. + $ make + +(We've tested the tool on Debian and CentOS. If there are build errors or +warnings, please do report them to glusterfs-devel@nongnu.org.) + +2. Run the test. + $ ./test-preload.sh > preload.log + +3. Mail the log to glusterfs-devel@nongnu.org. |