Date: Wednesday, April 11, 2007 @ 17:22:18
Author: marc
Path: /cvsroot/carob/libmysequoia
Modified: README (1.10 -> 1.11)
Updated and detailed LD_PRELOAD instructions. Added HOWTO build
libmysequoia from source, mentioning the source kit.
--------+
README | 56 +++++++++++++++++++++++++++++++++++++++++++-------------
1 files changed, 43 insertions(+), 13 deletions(-)
Index: libmysequoia/README
diff -u libmysequoia/README:1.10 libmysequoia/README:1.11
--- libmysequoia/README:1.10 Tue Nov 21 10:54:05 2006
+++ libmysequoia/README Wed Apr 11 17:22:18 2007
@@ -10,14 +10,26 @@
Install the debian or rpm package and you are ready with the first step. Now
you can try one of the following steps:
- * If libmysqlclient is linked dinamically:
- LD_PRELOAD=/path/to/libmysequoia.so ./your_program
- * If this will not work then you must recompile the sources of the
application.
- It's easy just replace every ocurence of "mysql_config" with
"mysequoia_config"
- after that:
- ./configure && make && make install
-
- In the CVS there are patch files for recompiling PHP, Python and Perl for
Redhat.
+
+ * If your_program is dynamically linked to libmysqlclient, just run
+ this:
+
+ LD_PRELOAD=/path/to/libmysequoia.so your_program
+
+ Use "ldd your_program" to check the linking configuration of
+ your_program. In the case of plugins (like for instance the mysql.so
+ and mysqli.so PHP extensions), you have to run "ldd" checks on the
+ plugins, NOT on the main executable. However you must still
+ LD_PRELOAD the main executable (PHP or apache for instance)
+
+ * If your application is linked statically or in a weird way to
+ libmysqlclient then you may need to recompile it. It's easy just
+ replace every occurence of "mysql_config" with "mysequoia_config".
+ In the CVS there are patch files for recompiling PHP, Python and
+ Perl for Redhat.
+
+ Please report any LD_PRELOAD and linking issues to the carob
+ mailing-list.
SEQUOIA CONFIGURATION
@@ -44,17 +56,35 @@
The packages are compiled with the MySQL 5.0 header files. If you want to use
with MySQL 4.1 then you need to recompile the packages.
-
+
+HOW TO BUILD libmysequoia
+
+ libmysequoia build is using GNU autotools, so you can use the
+ standard sequence: "./configure && make && sudo make install".
+ If you have a currently supported system, replace "./configure"
+ above by:
+
+ ./configure CONFIG_SITE=main.config.site CAROBDIR=`pwd`/../carob-X.Y.Z
+
+ and this may save you a lot of configure time. Even better, download
+ and use a pre-configured libmysequoia source kit which includes
+ appropriate carob source and build scripts.
+
DEPENDENCIES
* carob - http://carob.continuent.org/
* log4cxx (0.9.7) - http://logging.apache.org/log4cxx/
- * iconv - http://www.gnu.org/software/libiconv/
+ * POSIX iconv - http://www.gnu.org/software/libiconv/
+ * libmysqlclient - http://dev.mysql.com/
+
+ An implementation of iconv is included in glibc, so all Linux
+ systems have it by default. Many other systems also ship an
+ implementation.
- iconv is included in glibc. So all Linux systems for instance
- already have it.
+ Libmysqlclient is pre-packaged by most systems. Be careful to use
+ the SAME versions of libmysqlclient and libmysequoia!
- For developers 4 more dependencies (the last 3 are optional):
+ For developers 3 more optional dependencies:
* mysqlclient development - http://dev.mysql.com/doc/refman/5.0/en/c.html
* cppunit - http://cppunit.sourceforge.net/cppunit-wiki
_______________________________________________
Carob-commits mailing list
[email protected]
https://forge.continuent.org/mailman/listinfo/carob-commits
