c7326db0 |
1 | FreeBSD notes |
2 | |
3 | The build tree for Dolda Connect is not very portable at the moment, |
4 | but work is under way to fix that. For now, at least the daemon should |
5 | be possible to build on FreeBSD (though the ability to run it is not |
6 | guaranteed ;), but even that requires some special care. Eventually, |
7 | all this should be fixed. |
8 | |
9 | For SVN/GIT users |
10 | |
11 | First of all, if you have gotten this copy of Dolda Connect through |
12 | Subversion or git, you would normally need to run the `bootstrap' |
13 | script to create the `configure' script. However, it does not work in |
14 | FreeBSD, since the FreeBSD configuration of aclocal is a bit broken. |
15 | Instead, 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 | |
24 | Note, also, that FreeBSD does not install version-number free aliases |
25 | of these commands, so the appropriate versions must be added, which is |
26 | easily done with the help of tab completion. |
27 | |
28 | Of course, none of the above is required for the tarball copies of |
29 | Dolda Connect, which already have these steps completed for you. |
30 | |
31 | For everyone |
32 | |
33 | When compiling Dolda Connect, there are also some caveats. FreeBSD's |
34 | libc does not have an implementation of the iconv(3) functions, and |
35 | Dolda Connect's `configure' script cannot detect that automatically, |
36 | yet. |
37 | |
38 | Also, 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 |
40 | libraries there. |
41 | |
42 | Therefore, 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 |
44 | pass it via the `configure' script, like this: |
45 | |
0205696a |
46 | $ ./configure other-args... "LDFLAGS=-L/usr/local/lib -liconv" |
c7326db0 |
47 | |
48 | You may or may not also want to pass `CFLAGS=-g' as well, to ease any |
49 | debugging. |
0205696a |
50 | |
51 | Currently known bugs |
52 | |
53 | This is a list of currently known bugs that are specific to the |
54 | FreeBSD 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. |