Platform Variations
~~~~~~~~~~~~~~~~~~~
This file only covers details common to all Unix variants
supported by MySQL++. For platform-specific details, see the
file appropriate to your OS:
README-Cygwin.txt
README-Linux.txt
README-macOS.txt
README-Solaris.txt
There are no special instructions for any other Unix flavors.
Building the Library and Example Programs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
MySQL++ uses GNU autoconf, so you can build it with the standard
commands:
$ ./configure
$ make
$ su
# make install
Configure Options
~~~~~~~~~~~~~~~~~
The configure script takes several interesting options. Say:
$ ./configure --help
to get a list. Some of the more interesting flags are:
--prefix:
If you wish to install mysql++ in a root directory other than
/usr/local, run configure with --prefix=/some/dir/name
--with-mysql*:
If you installed MySQL in an atypical location, the configure
script will not be able to find the library and header
files without help. The simplest way to clue configure into
where MySQL is installed is with the --with-mysql option.
Try something like "--with-mysql=/usr/local/mysql", for
instance. The configure script will then try to guess which
subdirectories under the given directory contain the library
and include files.
If that doesn't work, it's because the library and header
files aren't in typical locations under the directory you gave
for configure to find them. So, you need to specify them
separately with --with-mysql-include and --with-mysql-lib
instead. As with --with-mysql, configure can often guess
which subdirectory under the given directory contains the
needed files, so you don't necessarily have to give the full
path to these files.
--with-field-limit:
This lets you increase the maximum field limit for template
queries and SSQLSes. By default, both are limited to 25
fields. See chapter 8.2 in the user manual for details:
http://tangentsoft.net/mysql++/doc/html/userman/configuration.html
--enable-thread-check:
Builds MySQL++ with threading support, if possible.
This option simply turns on two tests: first, that your
system uses a compatible threading library; and second,
that the thread-safe version of the MySQL C API library
(libmysqlclient_r) is installed and working. If both of
these are true, you get a thread-aware version of MySQL++.
"Thread-aware" means that the library does make an effort to
prevent problems, but we don't guarantee that all possible
uses of MySQL++ are thread-safe.
Note that this is a suggestion, not a command. If we can't
figure out the system's threading model or can't find the
thread-aware build of the C API library, configure won't fail.
It just reverts to the standard single-thread build.
See the chapter on threading in the user manual for more
details and advice on creating thread-safe programs with
MySQL++.
Building a Static Library
~~~~~~~~~~~~~~~~~~~~~~~~~
As shipped, MySQL++ only builds a shared library. It's possible to
change things so you get a static library instead.
Before we get to "how," beware that liking statically to MySQL++ has
legal consequences that may matter to you, due to the library's
license, the GNU LGPL. Familiarize yourself with the license, and
consider getting legal counsel before proceeding. Also, see the
MySQL++ FAQ: http://tangentsoft.net/mysql++/#faq There is more on
this topic there.
The necessary changes are all in mysql++.bkl:
- Change the <dll> tag to <lib>. (Remember the closing tag!)
- Remove the <dllname> tag
- Remove the <so_version> tag
Then, re-bootstrap the library. See HACKERS.txt if you need further
instruction on doing that.