Made libz, libbz2 and libgdbm optional.
[doldaconnect.git] / doc / README.FreeBSD
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
46 $ ./configure other-args... "LDFLAGS=-L/usr/local/lib -liconv"
47
48 You may or may not also want  to pass `CFLAGS=-g' as well, to ease any
49 debugging.
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.