xref: /trunk/main/mysqlc/source/README (revision cdf0e10c)
1 *cdf0e10cSrcweir---------- Status -------------------------------------------------------------
2 *cdf0e10cSrcweir
3 *cdf0e10cSrcweirThe code is on a PREVIEW level. PREVIEW means pre-alpha.
4 *cdf0e10cSrcweir
5 *cdf0e10cSrcweir---------- Requirements -------------------------------------------------------
6 *cdf0e10cSrcweir
7 *cdf0e10cSrcweirThe MySQL driver for OpenOffice.org (MySQL Connector/OpenOffice.org - C/OOo)
8 *cdf0e10cSrcweirrequires two external libraries to be build:
9 *cdf0e10cSrcweir
10 *cdf0e10cSrcweir 1) The MySQL Client Library (libmysql)
11 *cdf0e10cSrcweir 2) The MySQL Connector/C++ Library (libmysqlcppcon)
12 *cdf0e10cSrcweir
13 *cdf0e10cSrcweirAt the time of writing neither of the two libraries are part of the CWS!
14 *cdf0e10cSrcweirBefore you can build the MySQL driver for OpenOffice.org you must install
15 *cdf0e10cSrcweirthe two required libraries on your system before you can compile the driver.
16 *cdf0e10cSrcweir
17 *cdf0e10cSrcweirYou need the two libraries because the MySQL driver for OpenOffice.org
18 *cdf0e10cSrcweirdoes not feature an implementation of the MySQL Client Server
19 *cdf0e10cSrcweircommunication protocol. The protocol implementation is part of the MySQL
20 *cdf0e10cSrcweirClient Library. And the SDBC(X) style OpenOffice.org driver is implemented as a
21 *cdf0e10cSrcweirwrapper of the MySQL Connector/C++ Library which implements a JDBC interface and
22 *cdf0e10cSrcweirin turn uses the C based MySQL Client Library.
23 *cdf0e10cSrcweir
24 *cdf0e10cSrcweir1) MySQL Client Library (libmysql)
25 *cdf0e10cSrcweir
26 *cdf0e10cSrcweirThe MySQL Client Library (libmysql) is part of the MySQL Server. You need to
27 *cdf0e10cSrcweirdownload and install the MySQL Server. Use a binary distribution of
28 *cdf0e10cSrcweirMySQL 5.0.x or MySQL 5.1.x. Check the MySQL manual for instructions, e.g.
29 *cdf0e10cSrcweirfor Unix:
30 *cdf0e10cSrcweir
31 *cdf0e10cSrcweir http://dev.mysql.com/doc/refman/5.1/en/installing-binary.html
32 *cdf0e10cSrcweir
33 *cdf0e10cSrcweirThe typical installation path of the libmysql.so on Unix is
34 *cdf0e10cSrcweir/usr/local/mysql/lib/mysql/ .
35 *cdf0e10cSrcweir
36 *cdf0e10cSrcweir2) MySQL Connector/C++ (libmysqlcppcon)
37 *cdf0e10cSrcweir
38 *cdf0e10cSrcweirDownload and install the latest version of the MySQL Connector/C++, see
39 *cdf0e10cSrcweirhttp://forge.mysql.com/wiki/Connector_C++ . Check out the source
40 *cdf0e10cSrcweirfrom the bzr repository.
41 *cdf0e10cSrcweir
42 *cdf0e10cSrcweir3) Tweaking library paths
43 *cdf0e10cSrcweir
44 *cdf0e10cSrcweirAt the time of writing you might have to *manually* tweak library paths and
45 *cdf0e10cSrcweirlibrary names by patching makefile.mk. This is a temporary hack. The makefile
46 *cdf0e10cSrcweirwill be improved later.
47 *cdf0e10cSrcweir
48 *cdf0e10cSrcweirHowever, for the moment check the makefile.mk if the compilation fails due to
49 *cdf0e10cSrcweir"missing" libraries (= libraries not found). For example, check the following
50 *cdf0e10cSrcweirsettings:
51 *cdf0e10cSrcweir
52 *cdf0e10cSrcweir  MYSQL_INCDIR=/usr/local/include
53 *cdf0e10cSrcweir  MYSQL_LIBDIR=/usr/local/lib
54 *cdf0e10cSrcweir  [...]
55 *cdf0e10cSrcweir  MYSQL_INCDIR=/usr/local/include
56 *cdf0e10cSrcweir  MYSQL_LIBDIR=/usr/local/lib
57 *cdf0e10cSrcweir  [...]
58 *cdf0e10cSrcweir  MYSQL_INC=-I$(MYSQL_INCDIR)
59 *cdf0e10cSrcweir  MYSQL_LIB=-L$(MYSQL_LIBDIR) -lmysqlclient -rdynamic -lz -lcrypt -lnsl -lm
60 *cdf0e10cSrcweir  MYSQL_LIBFILE=$(MYSQL_LIBDIR)$/libmysqlclient.so.16
61 *cdf0e10cSrcweir  MYSQL_CPPCONN_LIBFILE=$(MYSQL_LIBDIR)$/libmysqlcppconn.so
62 *cdf0e10cSrcweir  [...]
63 *cdf0e10cSrcweir
64 *cdf0e10cSrcweirA common issue is libmysqlclient.so.15 vs. libmysqlclient.so.16 .
65 *cdf0e10cSrcweir
66