mysqlc/README

   1 The MySQL driver for LibreOffice.
   2
   3 It ships as an extension (.oxt file).
   4
   5 == Requirements ==
   6
   7 The MySQL driver for LibreOffice (MySQL Connector/LibreOffice - C/LibO)
   8 requires two external libraries to be build:
   9
  10  1) The MySQL Client Library (libmysql)
  11  2) The MySQL Connector/C++ Library (libmysqlcppconn)
  12
  13 libmysql is not included as an external and needs to be provided by
  14 the build environment, but libmysqlcppconn is provided as an external
  15 and will be automatically compiled if you pass
  16 "--without-system-mysql-cppconn" to autogen.sh.
  17
  18 The MySQL driver for LibreOffice does not reimplement the MySQL
  19 Client/Server communication protocol. The protocol implementation is
  20 part of the MySQL Client Library. The SDBC(X) driver is implemented as
  21 a wrapper of the MySQL Connector/C++ Library which implements a
  22 JDBC-like interface (which suits SDBC(X) well) and which in turn uses
  23 the C based MySQL Client Library.
  24
  25 == Variants ==
  26
  27 If configured with --with-system-mysql, the driver will *not* ship a
  28 copy of the MySQL client C library and will expect it to be installed
  29 in a standard location on each system that it runs on. That is usually
  30 the right choice to create a native package/port for GNU/Linux, BSD,
  31 etc, where the packaging system handles dependencies and will ensure
  32 the availability of the MySQL client C library in the standard
  33 location.
  34
  35 If configured with --with-libmysql-path, the driver will ship a copy
  36 of the MySQL client C library so that it works "out of the box" on any
  37 system. That is usually the right choice to create a stand-alone .oxt
  38 file that users can just install through the LibreOffice extensions
  39 manager, as is typical for Microsoft Windows and Apple MacOS X native
  40 (as opposed to MacPorts/fink/pkgsrc/...).
  41
  42 == Installing the Requirements ==
  43
  44 On modern/free-as-in-free-speech Unices, libmysql and libmysqlcppconn
  45 are probably available as a package/port. Install them using your
  46 distribution's tools. Make sure to install the development packages
  47 (whose name usually ends with -dev or -devel), and not only the
  48 libraries themselves. You can use --with-system-mysql or
  49 --with-libmysql-path=/usr/ (but not both).
  50
  51 Else you can install the MySQL Client Library from official MySQL
  52 packages at http://dev.mysql.com/downloads/connector/c/ .
  53 They have source and binary distributions for several platforms.
  54
  55 You can also install the MySQL Client Library (libmysql) as part of
  56 the MySQL Server, version 5.0 or later. Check the MySQL manual for
  57 instructions: http://dev.mysql.com/doc/refman/5.5/en/installing.html
  58 The typical installation path of the libmysql.so on Unix is
  59 /usr/local/mysql/lib/mysql/ .
  60