Merge "Optional autogen.sh flag --enable-kdbus-transport added allowing to compile...
[platform/upstream/dbus.git] / README.wince
1 DBus Daemon for Windows CE/Windows Mobile 6.5
2 =============================================
3
4 Bugs in upstream for any window version:
5 * MoveFileExA < 0 result check bug
6 * double dbus_free somewhere I forgot where (check in -ugly)
7 * alignment issue
8 * CreateProcess process information handle leak
9 * _dbus_getsid NULL vs INVALID_HANDLE_VALUE
10 * win_account_to_sid
11
12 Customisation
13 =============
14
15 1) At installation, the following registry value should be set to the
16 installation directory of the dbus installation (the directory
17 containing the bin, etc, share folders):
18
19 HKLM\Software\freedesktop\DBus\Install Directory
20
21 2) Instead of environment variable DBUS_VERBOSE, use
22 HKLM\Software\freedesktop\DBus\Verbose
23
24 2) The keyring directory is MYDOCUMENTS\dbus-keyrings, not
25 HOMEPATH\.dbus-keyrings.
26
27
28 Compilation
29 ===========
30
31 ./configure --host=arm-mingw32ce CPPFLAGS=-I/path/to/expat/include LDFLAGS=-L/path/to/expat/lib
32
33 A recent version of libtool is required, with this change:
34
35 2010-02-28  Pierre Ossman  <ossman@ossman.lkpg.cendio.se>  (tiny change)
36             Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
37
38        Fix deplibs check fallback for 64-bit Windows and Windows CE.
39        * libltdl/m4/libtool.m4 (_LT_CHECK_MAGIC_METHOD): Accept file formats
40        'pe-arm-wince' and 'pe-x86-64'.  Add note about consistency with ...
41        * libltdl/config/ltmain.m4sh (func_win32_libid): ... the respective
42        pattern here; sync pattern from the former.
43        * tests/deplibs-mingw.at (deplibs without file command): New
44        file, new test.
45        * Makefile.am (TESTSUITE_AT): Update.
46        * NEWS: Update.
47
48
49 MB vs WCHAR
50 ===========
51
52 Windows CE only supports the Unicode interface, while DBus Daemon uses
53 the Multi-Byte interface on Windows by default.  The glue code does
54 not support multibyte in all cases.  In particular, the _mbsrchr
55 function is not correctly implemented.  It could be correctly
56 implemented, or dbus daemon could use the wchar interface more
57 consistently on all Windows targets.  For now, the Windows CE port
58 will only work for filesystems without some weird characters in file
59 names.  Is this a serious limitation?
60
61
62 Known Issues
63 ============
64
65 Autolaunch is broken so far.
66
67 Environment variables are faked.  Some are punted to the registry, but
68 in any case they can not be used reliably for IPC.
69
70 The test suite is not ported yet.
71
72 dbus-pipe.c:
73  * Uses libc file descriptors.  Needed for --print-address and
74    --print-pid which probably don't work yet.
75
76 dbus-sysdeps-win.c:
77  * Backtraces have been disabled.
78  * _dbus_fd_set_close_on_exec Not supported, maybe we should disable
79    the warning.
80  * SearchPathA: Uses HKLM\\Software\\freedesktop\\DBus\\Install Directory
81    to locate binaries.