summaryrefslogtreecommitdiff
path: root/README
blob: 4ac8cb244d9d9189af2a37d72a0657732da1f51f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
D-BUS is a simple IPC library based on messages.

Configuration flags
===

These are the configuration flags that can be given to the ./configure program.

--enable-qt      	enable Qt-friendly client library
--enable-glib    	enable GLib-friendly client library
--enable-tests  	enable unit test code
--enable-ansi    	enable -ansi -pedantic gcc flags
--enable-verbose-mode 	support verbose debug mode
--enable-asserts 	include assertion checks
--enable-gcov 		compile with coverage profiling instrumentation (gcc only)


Environment variables
===

These are the environment variables that are used by the D-BUS client library

DBUS_VERBOSE=1
Turns on printing verbose messages. This only works if D-BUS has been
compiled with --enable-verbose-mode

DBUS_MALLOC_FAIL_NTH=n
Can be set to a number, causing every nth call to dbus_alloc or
dbus_realloc to fail. This only works if D-BUS has been compiled with
--enable-tests.

DBUS_MALLOC_FAIL_GREATER_THAN=n
Can be set to a number, causing every call to dbus_alloc or
dbus_realloc to fail if the number of bytes to be allocated is greater
than the specified number. This only works if D-BUS has been compiled with
--enable-tests.


Tests
===

These are the test programs that are built if dbus is compiled using
--enable-tests.

dbus/dbus-test
This is the main unit test program that tests all aspects of the D-BUS
client library.

test/break-loader
A test that tries to break the message loader by passing it invalid messages.

test/bus-test
A test that simulates a bus daemon and tests it.