From 4b6f5d684fc302b10fa2471597c0b276d8ef9885 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Fri, 22 Feb 2013 15:16:57 +0000 Subject: Imported Upstream version 1.7.0 --- README.valgrind | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 README.valgrind (limited to 'README.valgrind') diff --git a/README.valgrind b/README.valgrind new file mode 100644 index 00000000..c13f5304 --- /dev/null +++ b/README.valgrind @@ -0,0 +1,24 @@ +Running D-Bus clients with Valgrind +==== + +When running programs using libdbus in Valgrind, some special care needs to be +taken so as to avoid incorrect detection of leaks in libdbus. To avoid these +false positives, do the following: + +* Grab a copy of the D-Bus source code + +* Run configure with the --enable-developer and --with-valgrind options + +* Run make + +* Either make sure your code calls dbus_shutdown() (at least while running in + Valgrind) or set DBUS_MESSAGE_CACHE=0 in your environment + +* Run Valgrind on your program with the /path/to/dbus/source/dbus/.libs in your + LD_LIBRARY_PATH + +Your Valgrind log should now be free of any (spurious) libdbus-related leaks. + +For the curious, the DBUS_MESSAGE_CACHE=0 is required because by +default, libdbus uses a recyclable pool of message structs. These help +performance a bit. -- cgit v1.2.3