doc/www/dependencies.php

   1 <? include ("barry.inc"); ?>
   2
   3 <? createHeader("barry - Software dependencies"); ?>
   4
   5 <? createSubHeader("System Specific"); ?>
   6
   7 <p>Fedora systems:
   8 <ul>
   9         <li><b>ConsoleKit</b> - required for accessing the
  10                 Blackberry without root privileges.</li>
  11 </ul>
  12 </p>
  13
  14 <p>Debian systems:
  15 <ul>
  16         <li><b>fakeroot</b> - optional program to assist building your own
  17                 Debian binary packages without root privileges</li>
  18 </ul>
  19 </p>
  20
  21 <p>OpenBSD systems:
  22 <ul>
  23         <li><b>Uberry</b> - the uberry kernel module conflicts with the ugen
  24                 interface that libusb uses to talk to the device.  To work
  25                 around this, you will need to boot your kernel with "boot -c"
  26                 and disable the uberry module.  Suggestions for better ways
  27                 to work around this conflict are welcome.</li>
  28 </ul>
  29 </p>
  30
  31 <p>Mac OSX systems:
  32 <ul>
  33         <li><b>gettext</b> - the default gettext autoconf scripts do not
  34                 always do a very good job of detecting gettext and libintl
  35                 libraries on the Mac.  If it cannot find libintl, it will
  36                 automatically disable NLS support.  If this is important
  37                 to you, add --with-libintl-prefix=/opt/local/ to the
  38                 configure command line when building from source.</li>
  39 </ul>
  40 </p>
  41
  42 <? createSubHeader("Master List of Dependencies"); ?>
  43
  44 <p>The following list contains all software that Barry depends on, and
  45 the reason for it.  Some are only needed for building the source, and
  46 some are only needed for building CVS.
  47
  48 <ul>
  49         <li><b>C and C++ compilers</b> - 4.1.x or higher, for the tr1 includes (source build)</li>
  50         <li><b>ccache</b> - completely optional, but useful if you plan on compiling repeatedly</li>
  51         <li><b>pkg-config</b> (source build: so configure can autodetect library locations) </li>
  52         <li><b>libusb, stable (0.1.x)</b> - found at <a href="http://www.libusb.org/">http://www.libusb.org/</a> </li>
  53         <li><b>pthread</b>
  54         <li><b>boost</b> version 1.33 or higher (optional, Boost serialization support.) <a href="http://www.boost.org/">http://www.boost.org</a></li>
  55         <li><b>automake</b> version 1.9 (CVS builds only) </li>
  56         <li><b>autoconf</b> version 2.61 (CVS builds only) </li>
  57         <li><b>libtool</b> version 1.5.22 (CVS builds only) </li>
  58         <li><b>autopoint</b> on some systems, this is a separate package, yet
  59                 on others, it is part of gettext (CVS builds only) </li>
  60         <li><b>doxygen</b> suggested version 1.5.6, only for building API documentation</li>
  61         <li><b>gtkmm, glademm, glibmm</b> C++ versions of the GTK libraries (needed for the barrybackup GUI)</li>
  62         <li><b>libtar</b> (barrybackup GUI) </li>
  63         <li><b>zlib</b>, needed for CRC32 checksums in library COD file support,
  64                 and used by the barrybackup GUI</li>
  65         <li><b>libopensync</b> version 0.22 or, optionally, if building from source, latest opensync SVN tree </li>
  66         <li><b>sqlite, glib2, libxml2</b> (needed for syncing, required by OpenSync) </li>
  67         <li><b>libfuse</b> version 2.5 or higher (optional)</li>
  68         <li><b>libiconv</b>, needed for international charset conversions... most
  69                 Linux distros have this as part of libc.  If you are using another
  70                 OS such as FreeBSD, you'll have to install this separately.</li>
  71         <li><b>libxml++</b> version 2.6 for the desktop</li>
  72         <li><b>gettext</b>, needed for the iconv.m4 file, on some systems,
  73                 when building from CVS to generate configure.</li>
  74         <li><b>php5</b>, needed for generating static HTML documentation (CVS builds only) </li>
  75         <li><b>rpmdevtools and rpm-build</b>, if building RPMs yourself</li>
  76         <li><b>fakeroot</b>, if building DEB packages yourself</li>
  77         <li><b>wxWidgets</b>, if building the Barry Desktop</li>
  78         <li><b>libgcal</b>, version 0.9.6 or higher, if building the
  79                 Barry Desktop</li>
  80 </ul>
  81 </p>
  82
  83 <? createSubHeader("The Case of the Broken libtar"); ?>
  84
  85 <p>Well meaning people, in efforts to port the libtar examples to 64-bit
  86 systems have introduced a bug that causes libtar to mismatch standard
  87 read() and write() function call prototypes.</p>
  88
  89 <p>This bug has been seen in the Mandriva, ArchLinux, and Gentoo distros.
  90 Depending on your system, and how up to date it is, it may already have been
  91 fixed.</p>
  92
  93 <p>The curious can read more about this bug
  94 <a href="http://www.mail-archive.com/barry-devel@lists.sourceforge.net/msg00746.html">here</a> and
  95 <a href="http://www.mail-archive.com/barry-devel@lists.sourceforge.net/msg00754.html">here</a>.</p>
  96
  97 <p>Of course, you probably don't want to read the intricate details of
  98 distro bugs.  You just want it to work!  For such systems, I usually
  99 grab the libtar source RPM package from
 100 <a href="ftp://ftp.nrc.ca/pub/systems/linux/redhat/fedora/linux/releases/10/Everything/source/SRPMS/libtar-1.2.11-11.fc10.src.rpm">here</a> and then run:
 101 <pre>
 102 rpmdev-setuptree (if this is your first time)
 103 rpm -i libtar-1.2.11-11.fc10.src.rpm
 104 cd ~/rpmbuild/SPECS
 105 rpmbuild -ba libtar.spec
 106 rpm -i ../RPMS/*/libtar*rpm
 107 </pre>
 108 </p>
 109
 110
 111 <? createSubHeader("Dependency Packages for Common Distros"); ?>
 112
 113 <p>The following is a list of packages you'll need to install to build Barry
 114 from source, if you are using one of the below common distributions.  Other
 115 distributions should have similar package names.
 116
 117 <p>You can also find scripts to automate this in the source tree under
 118 maintainer/depscripts.</p>
 119
 120 <ul>
 121
 122 <p><b>Fedora 11:</b></p>
 123 <p>Use the yum package manager to install the following:
 124 <ul>
 125         <li> pkgconfig </li>
 126         <li> libtool </li>
 127         <li> libusb-devel </li>
 128         <li> boost-devel (optional) </li>
 129         <li> libtar-devel </li>
 130         <li> gtkmm24-devel </li>
 131         <li> glibmm24-devel </li>
 132         <li> libglademm24-devel </li>
 133         <li> fuse-devel </li>
 134         <li> zlib-devel </li>
 135         <li> libxml++-devel </li>
 136         <li> gettext-devel </li>
 137         <li> libopensync-devel (0.22) </li>
 138         <li> ccache (optional) </li>
 139         <li> doxygen (optional) </li>
 140         <li> php-cli (optional, for generating docs) </li>
 141         <li> wxGTK-devel (optional, for Barry Desktop) </li>
 142 </ul>
 143
 144 <p><b>Debian:</b></p>
 145 <p>Use the apt-get package manager to install the following:
 146 <ul>
 147         <li> pkg-config </li>
 148         <li> fakeroot </li>
 149         <li> cdbs </li>
 150         <li> autoconf </li>
 151         <li> automake </li>
 152         <li> autopoint (only on some newer Debian/Ubuntu systems) </li>
 153         <li> libtool </li>
 154         <li> libusb-dev </li>
 155         <li> libboost-serialization-dev </li>
 156         <li> libtar-dev </li>
 157         <li> libgtkmm-2.4-dev </li>
 158         <li> libglibmm-2.4-dev </li>
 159         <li> libglademm-2.4-dev </li>
 160         <li> libfuse-dev </li>
 161         <li> libxml++2.6-dev </li>
 162         <li> zlib1g-dev </li>
 163         <li> gettext </li>
 164         <li> libopensync0-dev </li>
 165         <li> ccache (optional) </li>
 166         <li> doxygen (optional) </li>
 167         <li> php5-cli (optional, for generating docs) </li>
 168         <li> libwxgtk2.8-dev and wx-common (optional, for Barry Desktop) </li>
 169 </ul>
 170
 171 </ul>
 172