[doc] Initial docs for kdbus transport
[platform/upstream/dbus.git] / doc-kdbus / HOWTO.txt
1 IMPORTANT!!!
2 ------------
3 Modified version of kdbus (from tizen.org) is required to run kdbus transport in dbus.
4
5
6
7
8 kdbus-root : directory where kdbus project is
9 dbus-root  : directory where dbus project is
10
11
12 ----------KDBUS----------
13
14 [Build kdbus project]
15 #cd /kdbus-root/
16 #make
17
18 [Load kdbus kernel module]
19 #sudo insmod kdbus.ko
20
21
22 ----------LIBDBUS--------
23
24 [Build libdbus project]
25 #./autogen.sh
26 (resolve missing dependencies)
27 #make
28
29 [Run custom dbus-daemon]
30 #dbus-root/bus/dbus-daemon --config-file=/etc/dbus-1/session.conf --nofork --address=kdbus
31
32 [Check if kdbus bus is created and has permissions to read-write]
33 #ls -la /dev/kdbus/`id -u`-kdbus/bus
34
35 [Copy built libdbus shared library to test directory]
36 #cp /dbus-root/dbus/.libs/libdbus-1.so.3.8.2 /test/directory/
37
38 [Make symbolic link to shared library]
39 #ln -s /test/directory/libdbus-1.so.3.8.2 /test/directory/libdbus-1.so.3
40
41 [Set variable to use custom library instead of system one]
42 #export LD_LIBRARY_PATH=/test/directory/libdbus-1.so.3
43
44 [Set variable to use kdbus as session bus]
45 #export DBUS_SESSION_BUS_ADDRESS=kdbus:path=/dev/kdbus/`id -u`-kdbus/bus
46
47 ----------TEST -----------
48
49 [Build test binaries]
50 #cd /dbus-root/samsung_tools
51 #make
52
53 [Check if test binary correctly links custom libdbus]
54 #ldd ping-server
55
56 [Run test binary server in terminal 1]
57 #./ping-server
58
59 [Run test binary client in terminal 2]
60 #./ping-client
61
62 -------OPTIONAL--------
63
64 [set variable to see debug info]
65 #export DBUS_VERBOSE=1