MySQL Connector/ODBC 3.51

This is a release of MySQL Connector/ODBC (formerly MyODBC),
Oracle's dual-license ODBC Driver for MySQL. For the avoidance
of doubt, this particular copy of the software is released
under the version 2 of the GNU General Public License. 
MySQL Connector/ODBC is brought to you by Oracle.

Copyright (c) 1995, 2011, Oracle and/or its affiliates. All rights reserved.

License information can be found in the COPYING file.

MySQL FOSS License Exception
We want free and open source software applications under 
certain licenses to be able to use the GPL-licensed MySQL 
Connector/ODBC (specified GPL-licensed MySQL client libraries)
despite the fact that not all such FOSS licenses are 
compatible with version 2 of the GNU General Public License.
Therefore there are special exceptions to the terms and
conditions of the GPLv2 as applied to these client libraries, 
which are identified and described in more detail in the 
FOSS License Exception at
<http://www.mysql.com/about/legal/licensing/foss-exception.html>

This distribution may include materials developed by third
parties. For license and attribution notices for these
materials, please refer to the documentation that accompanies
this distribution (see the "Licenses for Third-Party Components"
appendix) or view the online documentation at 
<http://dev.mysql.com/doc/>

GPLv2 Disclaimer
For the avoidance of doubt, except that if any license choice
other than GPL or LGPL is available it will apply instead, 
Oracle elects to use only the General Public License version 2 
(GPLv2) at this time for any software where a choice of GPL 
license versions is made available with the language indicating 
that GPLv2 or any later version may be used, or where a choice 
of which version of the GPL is applied is otherwise unspecified.

CONTENTS

* Introduction
* Building Source
* Installing
* Binary Files
* Connector/ODBC SDK
* Resources

INTRODUCTION
------------------------------------------------------------

This is the source or binary distribution of ODBC for 
MySQL. This software is distributed with restrictions - please
see the license information for details.

Open Database Connectivity (ODBC) is a widely accepted standard
for reading/writing data. ODBC is designed in a similar manner
to the MS Windows printing system in that it has a Driver Manager
and Drivers. MySQL Connector/ODBC is a driver for the ODBC system 
which allows applications to communicate with the MySQL Server 
using the ODBC standard. ODBC implementations exist on all popular
platforms and MySQL Connector/ODBC is also available on those 
platforms. 

Oracle provides MySQL support for ODBC by means of the MySQL
Connector/ODBC driver and programs. MySQL Connector/ODBC is the
ODBC driver for MySQL which is ODBC 3.5x compliant; MyODBC is
ODBC 2.5x compliant.

To get all functionality from the ODBC 3.51 driver, you should 
use it against MySQL 3.23.36 or above.

BUILDING SOURCE
---------------------------------------------------------------

Please see the BUILD file for details on building the source
code. This is included with the source distribution.

INSTALLING
---------------------------------------------------------------

Please see the INSTALL file for details on installing.

BINARY FILES
---------------------------------------------------------------

The following, key, files are provided by MySQL Connector/ODBC
(the MS Windows names are included for reference but the file 
names for other platforms would be similar).

Driver (myodbc3.dll)

     The most important part of Connector/ODBC is the driver.
     Application developers can link directly to the driver but 
     more often use the driver indirectly, via a Driver Manager
     such as the one provided by Microsoft or unixODBC.

     Many options can be provided to the driver to adjust its
     behavior. 

Setup Library (myodbc3S.dll)

     The setup library provides a graphical user interface needed
     during certain activities provided by the driver. For example;
     it provides the GUI when you use the ODBC Administrator to
     create/edit a Data Source Name (DSN).

Installer (myodbc3i.exe)

     This command-line utility program can be used to manage ODBC
     system information. For example it can be used to register
     or deregister a driver. It can also manage data source names.
     This was created to test the ODBC system information
     abstraction and portability layer within Connector/ODBC but 
     is also useful for installing and uninstalling Connector/ODBC.

     Invoke myodbc3i, in a command shell and without options, to 
     get help on its use.

Monitor (myodbc3m.exe)

     This command-line utility can be used to send statements to 
     the MySQL server and to view the results. It can provide 
     output in several different formats - making it useful as 
     a batch processing tool but it was developed to test a 
     connection and for problem solving.
                
     Invoke myodbc3m, in a command shell and without options, 
     to get help on its use.

Library Loading Tester (dltest.exe)

     This command-line utility is useful for debugging problems
     related to loading a library and resolving symbols in it.

Data Source Name Editor (myodbc3c.exe)

     This is a GUI application designed to be invoked from the
     command-line. It allows a GUI to be invoked to add/edit a 
     DSN. It is not useful on all platforms but on most platforms 
     it can be a great aid during an install process.

Connector/ODBC SDK
---------------------------------------------------------------

MySQL Connector/ODBC provides an SDK for developers in the form 
of several reusable libraries. These libraries can be used to 
save development time/effort and to increase stability of resulting
software.

myodbc3u

     This library provides the ODBC system information abstraction
     and portability used by Connector/ODBC.

RESOURCES
---------------------------------------------------------------

For more information about MySQL, see
http://www.mysql.com

For more information about MySQL Connector/ODBC, including
installation instructions, please visit;
http://www.mysql.com/products/myodbc/index.html
