87 lines
3.2 KiB
Text
87 lines
3.2 KiB
Text
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-Mac-OS-X.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++.
|