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.