Add timeouts to the dc loop in util.scm.
[doldaconnect.git] / doc / README.FreeBSD
CommitLineData
c7326db0 1 FreeBSD notes
2
3The build tree for Dolda Connect is not very portable at the moment,
4but work is under way to fix that. For now, at least the daemon should
5be possible to build on FreeBSD (though the ability to run it is not
6guaranteed ;), but even that requires some special care. Eventually,
7all this should be fixed.
8
9 For SVN/GIT users
10
11First of all, if you have gotten this copy of Dolda Connect through
12Subversion or git, you would normally need to run the `bootstrap'
13script to create the `configure' script. However, it does not work in
14FreeBSD, since the FreeBSD configuration of aclocal is a bit broken.
15Instead, you will need to run the following commands manually:
16
17$ autopoint
18$ aclocal -I m4 -I /usr/local/share/aclocal
19$ autoheader
20$ libtoolize --copy --force
21$ automake --add-missing --copy
22$ autoconf
23
24Note, also, that FreeBSD does not install version-number free aliases
25of these commands, so the appropriate versions must be added, which is
26easily done with the help of tab completion.
27
28Of course, none of the above is required for the tarball copies of
29Dolda Connect, which already have these steps completed for you.
30
31 For everyone
32
33When compiling Dolda Connect, there are also some caveats. FreeBSD's
34libc does not have an implementation of the iconv(3) functions, and
35Dolda Connect's `configure' script cannot detect that automatically,
36yet.
37
38Also, Dolda Connect uses a lot of libraries that are located in
39/usr/local/lib, but by default, the FreeBSD linker does not look for
40libraries there.
41
42Therefore, the linker must be passed the arguments `-L/usr/local/lib
43-liconv' to compile Dolda Connect. The easiest way to do that is to
44pass it via the `configure' script, like this:
45
0205696a 46$ ./configure other-args... "LDFLAGS=-L/usr/local/lib -liconv"
c7326db0 47
48You may or may not also want to pass `CFLAGS=-g' as well, to ease any
49debugging.
0205696a 50
51 Currently known bugs
52
53This is a list of currently known bugs that are specific to the
54FreeBSD build of Dolda Connect.
55
56 * Many components are not able to build with FreeBSD's `make'
57 command. Until that is fixed, please use gmake instead.
58 * doldacond only listens to IPv6, since the ::ffff:0:0/96 stack
59 escape prefix is enabled on Linux by default. On FreeBSD it is
60 not enabled by default, however, so doldacond only accepts IPv6
61 connections unless either compiled without IPv6 support, or the
62 sysctl net.inet6.ip6.v6only is set to 0.
63 * Some other components do not build at all, since they use
64 Linux-specific things of various kinds.
65 * PAM authentication in doldacond does not work, for as of yet
66 unknown reasons.