Added Cyg-Win
This commit is contained in:
parent
82cbc206eb
commit
413c315806
10586 changed files with 3806249 additions and 0 deletions
45
Agent-Windows/OGP64/usr/share/doc/libiodbc/AUTHORS
Normal file
45
Agent-Windows/OGP64/usr/share/doc/libiodbc/AUTHORS
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
#
|
||||
# $Id$
|
||||
#
|
||||
# List of Authors/Contributers
|
||||
#
|
||||
# The iODBC driver manager
|
||||
#
|
||||
|
||||
Original Author:
|
||||
----------------
|
||||
Ke Jin <kejin@inprise.com> (kj)
|
||||
|
||||
|
||||
Current Maintainer:
|
||||
-------------------
|
||||
Patrick van Kleef <iodbc@openlinksw.com> (pvk)
|
||||
|
||||
|
||||
Contributors:
|
||||
-------------
|
||||
Per Schroder <per@mimer.se> (ps)
|
||||
- Added VMS port
|
||||
|
||||
George Kodinov <kgeorge@plovdiv.techno-link.com> (gk)
|
||||
- Added ODBC 3.x support
|
||||
|
||||
Emmanuel Poitier <epoitier@openlinksw.co.uk> (ep)
|
||||
- Added iodbcinst support
|
||||
- Added iodbcadm-gtk
|
||||
|
||||
Christian Hammers <ch@debian.org> (ch)
|
||||
- Maintainer of iODBC packaging for the Debian project
|
||||
|
||||
Sergei Malinin <smalinin@openlinksw.com> (sm)
|
||||
- Added Unicode support
|
||||
|
||||
Tim Haynes <webmaster{at}iodbc.org> (th)
|
||||
- Maintainer iODBC.org web site
|
||||
|
||||
Max Khon <fjoe{at}samodelkin.net> (mk)
|
||||
- iODBC fixes and extentions
|
||||
|
||||
|
||||
This list is not complete. If you have contributed to this project and
|
||||
want to appear on this list, please email the current maintainer.
|
||||
16
Agent-Windows/OGP64/usr/share/doc/libiodbc/COPYING
Normal file
16
Agent-Windows/OGP64/usr/share/doc/libiodbc/COPYING
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
iODBC Driver Manager
|
||||
Copyright (C) 1995 by Ke Jin <kejin@empress.com>
|
||||
Copyright (C) 1996-2012 by OpenLink Software <iodbc@openlinksw.com>
|
||||
All Rights Reserved.
|
||||
|
||||
This software is released under either the GNU Library General Public
|
||||
License (see LICENSE.LGPL) or the BSD License (see LICENSE.BSD).
|
||||
|
||||
Note that the only valid version of the LGPL license as far as this
|
||||
project is concerned is the original GNU Library General Public License
|
||||
Version 2, dated June 1991.
|
||||
|
||||
While not mandated by the BSD license, any patches you make to
|
||||
the iODBC may be contributed back into the iODBC project at your
|
||||
discretion. Contributions will benefit the Open Source and Data Access
|
||||
community as a whole. Submissions may be made at http://www.iodbc.org.
|
||||
3348
Agent-Windows/OGP64/usr/share/doc/libiodbc/ChangeLog
Normal file
3348
Agent-Windows/OGP64/usr/share/doc/libiodbc/ChangeLog
Normal file
File diff suppressed because it is too large
Load diff
16
Agent-Windows/OGP64/usr/share/doc/libiodbc/LICENSE
Normal file
16
Agent-Windows/OGP64/usr/share/doc/libiodbc/LICENSE
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
iODBC Driver Manager
|
||||
Copyright (C) 1995 by Ke Jin <kejin@empress.com>
|
||||
Copyright (C) 1996-2012 by OpenLink Software <iodbc@openlinksw.com>
|
||||
All Rights Reserved.
|
||||
|
||||
This software is released under either the GNU Library General Public
|
||||
License (see LICENSE.LGPL) or the BSD License (see LICENSE.BSD).
|
||||
|
||||
Note that the only valid version of the LGPL license as far as this
|
||||
project is concerned is the original GNU Library General Public License
|
||||
Version 2, dated June 1991.
|
||||
|
||||
While not mandated by the BSD license, any patches you make to
|
||||
the iODBC may be contributed back into the iODBC project at your
|
||||
discretion. Contributions will benefit the Open Source and Data Access
|
||||
community as a whole. Submissions may be made at http://www.iodbc.org.
|
||||
305
Agent-Windows/OGP64/usr/share/doc/libiodbc/NEWS
Normal file
305
Agent-Windows/OGP64/usr/share/doc/libiodbc/NEWS
Normal file
|
|
@ -0,0 +1,305 @@
|
|||
Mar 27 2012, V3.52.8:
|
||||
* Converted from CVS to GIT
|
||||
* Added build support for Mac OS X 10.5, 10.6 and 10.7
|
||||
* Converted old Mac OS X .nib format to newer .xib format
|
||||
* Fixed issue with using buffer after free
|
||||
* Fixed use ssize_t where appropriate
|
||||
* Fixed issue with strlen if param can be NULL
|
||||
* Fixed use ssize_t for length of string
|
||||
* Fixed tracing SQLGetData using multiple chunks
|
||||
* Fixed problem tracing on big-endian machines
|
||||
* Fixed wrong type label
|
||||
* Fixed compiler warnings
|
||||
|
||||
Sep 10 2009, V3.52.7:
|
||||
* Added iODBC Graphical Administrator for Mac OS X
|
||||
* Added iODBC CFM Bridge
|
||||
* Added resizable windows and dialogs for GTK+
|
||||
* Added option in tracefile for sequence number ($S)
|
||||
* Added additional translations between ANSI and Unicode
|
||||
* Fixed if tracefile gets too big, continue in new tracefile
|
||||
* Fixed unload bug due to wrong pointer deref
|
||||
* Fixed Connection Pooling UI
|
||||
* Fixed checking odbc_ver on connect handle
|
||||
* Fixed packaging of runtime only libraries
|
||||
* Fixed porting issues
|
||||
* Fixed documentation
|
||||
|
||||
Oct 08 2007, V3.52.6:
|
||||
* Added support for GTK+ 2.x
|
||||
* Fixed long mutex lock on connect
|
||||
* Fixed problems with SQLBrowseConnect
|
||||
* Fixed missing functions in export list
|
||||
* Fixed core dump when checking for driver odbc version
|
||||
* Fixed allocation error in SQLDescribeCol
|
||||
* Fixed rpm specification for RedHat
|
||||
* Fixed porting problems on FreeBSD, OpenBSD and OSF
|
||||
* Use SQLFetchScroll in iodbctest
|
||||
|
||||
Jan 05 2007, V3.52.5:
|
||||
* Added support for FileDSN
|
||||
* Added support for Connection Pooling
|
||||
* Added check for tracefile size
|
||||
* Call ODBC 2.x functions in driver if application uses ODBC 2.x only calls
|
||||
* Fixed problem parsing driver result in SQLSetStmtAttr
|
||||
* Fixed source code readability
|
||||
* Fixed bug in overwriting driver name
|
||||
* Fixed check for /Library/ODBC for Mac OS X
|
||||
* Fixed prototypes
|
||||
* Rewrote bootstrap script and configure summary
|
||||
* Use localtime_r in tracing when available
|
||||
* Fixed build issues with Mac OS X
|
||||
* Small code cleanups and fixes
|
||||
|
||||
Jan 26 2006, V3.52.4:
|
||||
* Added support for Mac OS X 10.4 Universal kit (ppc, ppc64 and i386)
|
||||
* Removed dependency between iodbc and iodbcinst shared libraries
|
||||
* Cleanup Mac OS X build process
|
||||
* Clarify LGPL license conditions
|
||||
* Fixed problem with error on subsequent SQLExecute statements
|
||||
* Fixed problem building 64bit GUI components
|
||||
* Fixed compiler warnings
|
||||
* Fixed problem determining which compiler to use on AIX
|
||||
* Enabled SHLIB_PATH on HP/UX
|
||||
* Fixed problem using # as comment in odbc.ini file
|
||||
* Disabled --disable-odbc3 flag
|
||||
* Small code cleanups and fixes
|
||||
|
||||
Nov 04 2005, V3.52.3:
|
||||
* Added support for DSN-less connections
|
||||
* Added timestamp to ENTER/EXIT lines in trace file
|
||||
* Added build support for AIX 5.x, HP/UX 11.23 Itanium
|
||||
* Added build support for Mac OS X 10.3 (32bit) and 10.4 (32bit+64bit)
|
||||
* Fixed problem with certain compilers hating lvalue casting
|
||||
* Fixed problem with truncated messages in iodbctest
|
||||
* Fixed problem calling setup dialog multiple times
|
||||
* Fixed problem with ODBC_BOTH_DSN
|
||||
* Fixed problem with tracing SQLGetInfo
|
||||
* Fixed problem with NUL termination on setup dialog
|
||||
* Fixed problem building on Mac OS X 10.4 64bit
|
||||
* Fixed problem calculating buffer length after calling setup dialog
|
||||
* Fixed problem with SQLDriverConnect (SQL_DRIVER_PROMPT) if no
|
||||
setup dialog had been registered
|
||||
* Fixed symbol clash between Oracle Instant client and iODBC on Mac OS X
|
||||
* Fixed problem building iODBCadm and drvproxy on Mac OS X
|
||||
* Fixed problem building on machines with older iODBC installation
|
||||
|
||||
Feb 04 2005, V3.52.2:
|
||||
* Added tracing option for root without overwriting existing files
|
||||
* Added PORT.OpenLink script
|
||||
* Added special iodbc-config script for Mac OS X framework build
|
||||
* Fixed problem starting/stopping tracing
|
||||
* Fixed SQLSetConnectAttr to return SQL_SUCCESS_WITH_INFO
|
||||
if driver cannot handle option set before connect time
|
||||
* Fixed SQLInfo to use pcbInfoValue if present
|
||||
* Fixed NULL pointer problem in GTK choose driver dialog
|
||||
* Fixed problem with C++ prototypes with older 32bit code
|
||||
* Fixed locking problem with SQLAllocEnv/SQLAllocHandle
|
||||
* Fixed tracefile name expansion
|
||||
* Fixed problem running bootstrap.sh on machines without GTK
|
||||
* Fixed problem installing code in temp directory for packaging
|
||||
* Fixed problem calling SQLGetDiagRec on uninitialized handles
|
||||
in iodbctest program
|
||||
* Link iodbctest program with static iodbc libraries
|
||||
|
||||
Sep 29 2004, V3.52.1:
|
||||
* Added support for new ODBC 3.52 specification for 64bit environments
|
||||
* Added support for SQLGetEnvAttr(SQL_ATTR_WCHAR_SIZE extension
|
||||
* Added missing Mac OS X build files
|
||||
* Added script to symlink Mac OS X framework into /usr/local/iODBC
|
||||
to allow traditional GNU configurable packages to use the same
|
||||
version of iODBC
|
||||
* Added new layer to driver loading to prevent memory leaks when
|
||||
drivers cannot be physically unloaded
|
||||
* Added man pages for iodbc-config, iodbctest and iodbcadm-gtk
|
||||
* Added header file iodbcunix.h for portability
|
||||
* Enhanced tracing for SQLGetFunctions, SQLColAttribute
|
||||
* Fixed NULL pointer problem when connection failed
|
||||
* Fixed initialization problem with SQLGetPrivateProfileString
|
||||
* Fixed export Unicode and ANSI names of ODBC functions in libiodbc
|
||||
* Fixed SQLSetScrollOption emulation
|
||||
* Fixed tracing for SQLSetDescRec
|
||||
* Fixed rpm build issue with RedHat 9
|
||||
* Fixed MAC OS X install problem
|
||||
* Fixed Mac OS X build dependency on Carbon libraries
|
||||
* Fixed HP/UX shared library name handling
|
||||
* Fixed handling of UTF-8 sequences
|
||||
* Fixed compiler warnings
|
||||
* Small code cleanups and fixes
|
||||
|
||||
|
||||
Feb 24 2004, V3.51.2:
|
||||
* Added support for installation layouts for different distributions
|
||||
e.g. --with-layout=RedHat
|
||||
* Added support for Mac OS X 10.3 (panther)
|
||||
* Added support for creating libodbc.so symlink
|
||||
* Added more ODBC 3.x calls to iodbctest.c program
|
||||
* Added SQLRowCount for SQL UPDATE/DELETE statements in iodbctest.c
|
||||
* Fixed build problem with older make programs
|
||||
* Fixed bug in state handling SQLCloseCursor
|
||||
* Fixed driver statement allocation problem
|
||||
* Fixed double free in statement handle
|
||||
* Fixed problem tracing variable length strings and binary data
|
||||
* Use snprintf when available to guard against buffer overruns
|
||||
* Small documentation fixes
|
||||
|
||||
Sept 08 2003, V3.51.1:
|
||||
* Fixed library dependency for PHP and other open source packages
|
||||
* Fixed build problems on Mac OS X
|
||||
* Fixed default compiler and flags for threaded builds
|
||||
* Small bugfixes
|
||||
|
||||
Aug 22 2003, V3.51.0:
|
||||
* Added Unicode support
|
||||
* Added tracing functionality
|
||||
* Minor cleanups and bugfixes
|
||||
|
||||
Apr 29 2002, V3.0.6:
|
||||
* Added instructions for building MyODBC on Mac OS X
|
||||
* Added support for building iODBC on Mac OS X as a framework
|
||||
* Fixed creating new window handle
|
||||
* Fixed portability issues
|
||||
* Use the latest versions of autoconf, automake and libtool
|
||||
* Updated all comments to reflect the new dual licensing policy
|
||||
* Fixed bug in SQLError/SQLGetDiagRec
|
||||
* Added support for driver specific connect options
|
||||
* Fixed wrong argument to SQLEndTran
|
||||
* Fixed handling statement descriptor
|
||||
* Fixed DSN string handling
|
||||
* Fixed mapping in SQLColumnAttributes
|
||||
* Minor cleanups and bugfixes
|
||||
|
||||
Jun 7 2001, V3.0.5:
|
||||
* Added new iodbcinst code
|
||||
* Added new drvproxy and iodbcadm GTK frontend
|
||||
* iODBC released under LGPL or BSD license
|
||||
* SQLMoreResults always returned SQL_NO_DATA_FOUND
|
||||
|
||||
Jun 4 2001, V3.0.4:
|
||||
* Reorganized source tree to use multiple subdirectories in
|
||||
preparation of adding the new iodbcinst code
|
||||
* Use config.h instead of massive CFLAGS
|
||||
* Generate libiodbc.spec with correct version number
|
||||
|
||||
Jun 1 2001, V3.0.3:
|
||||
* Added support for automake 1.4-p2, autoconf 2.50 and libtool 1.4
|
||||
* Fixed problems with shl_unload on HP/UX
|
||||
* Added support for MacOS X 1.2 (Darwin)
|
||||
* Disallow root to start a debug session (security risk)
|
||||
* SQLDatasources returns Driver Type instead of DSN Description
|
||||
* Added checks for ODBC 3.x date, time and timestamp defines
|
||||
* Fixed initialization of cip flag
|
||||
|
||||
Feb 1 2000, V3.0.2:
|
||||
* Fixed deadlock problem in SQLNumResultCols
|
||||
* Small code fix in SQLDatasources
|
||||
|
||||
Jan 28 2000, V3.0.1:
|
||||
* Added thread support into Driver Manager
|
||||
* Added code to allow Threaded application to call non-threaded driver
|
||||
* Small code fixes and cleanups
|
||||
|
||||
Dec 16 1999, V3.0.0:
|
||||
* Added initial support for ODBC 3.x API and the ODBC 3.x to 2.x
|
||||
translation layer
|
||||
* Added --disable-odbc3 flag to configure.in for building ODBC 2.x
|
||||
compatible driver manager
|
||||
* Added --enable-maintainer-mode flag to configure.in
|
||||
* Rewrote dlopen and underscore checks in configure.in
|
||||
* Default iodbc-inidir is set to /etc
|
||||
* Clear error stack at the start of each ODBC function
|
||||
* Imported libtool 1.3.4
|
||||
* Small code cleanups
|
||||
* Created iodbc-config script for other projects to find out how
|
||||
to link with the iodbc libraries.
|
||||
* Fixed bug in SQLDataSources
|
||||
* Added initial support for MacOS X (Rhapsody)
|
||||
* Add some ODBC 3.x API calls to the odbctest program
|
||||
|
||||
June 25, 1999, V2.50.3:
|
||||
* Renamed public header files to conform to ODBC standard
|
||||
* System wide iodbc.ini can now be set with --with-odbc-inidir=,
|
||||
default is set to $sysconfdir/odbc.ini to comply with GNU
|
||||
standards
|
||||
* Some small bug fixes
|
||||
* Added AutoReqProv flag to RPM .spec file
|
||||
* Changed types for SQLHENV, SQLHDBC, SQLHSTMT
|
||||
|
||||
April 26, 1999, V2.50.2:
|
||||
* Small code cleanups (pvk)
|
||||
* Wrote new handle validation checks to make the driver manager more
|
||||
resistant to handle misuse (pvk)
|
||||
* Rewrote all function prototypes to conform to ODBC 2.51 standard (pvk)
|
||||
* Use the internal form of the handle instead of the external
|
||||
representation (pvk)
|
||||
* Removed 2 copyright sccs stamps and comments as requested by Ke Jin (pvk)
|
||||
* Added rudementary SQLGetPrivateProfileString call (pvk)
|
||||
* Added support for VMS (ps)
|
||||
|
||||
January 18, 1999, V2.50:
|
||||
* Added autoconf/automake/libtool support
|
||||
* Licensing moved to LGPL
|
||||
* Added OpenLink code enhancements and bug fixes
|
||||
|
||||
------------------------------------------------------------------------
|
||||
Original Changelog from Ke Jin
|
||||
------------------------------------------------------------------------
|
||||
July 30, 1995, v2.00.beta:
|
||||
0. the first release and beta version.
|
||||
|
||||
Sep. 11, 1995, v2.10:
|
||||
1. Porting to AIX 3.x and 4.x, by writing dlopen(),
|
||||
dlsym(), dlclose() interface.
|
||||
2. Tested on SCO OpenServer 5.x
|
||||
3. Awared of that, unlike s700/s800, exported function
|
||||
symbols on HP9000 s300/s400 will be prepended with
|
||||
a '_' prefix by compiler(and this '_' prefix is not
|
||||
automatically handled by shl_findsym()). Now, it works
|
||||
fine on s300/s400.
|
||||
4. Support driver ODBC call tracing.
|
||||
|
||||
Oct. 12, 1995, v2.11:
|
||||
5. Driver's SQLNumResultCols() will automatically be
|
||||
invoked in driver manager's SQLExecute(),
|
||||
SQLExecDirect() and SQLParamData() after successfully
|
||||
(i.e. return SQL_SUCCESS or SQL_SUCCESS_WITH_INFO )
|
||||
calling of their correspondent driver functions. This
|
||||
simplifies the state tracing/checking of the driver
|
||||
manager a lot and allows store procedures to return
|
||||
result set and also make iODBC driver manager work
|
||||
properly with SELECT INTO statements which actually
|
||||
don't return result sets.
|
||||
6. Memory leaks are cleared.
|
||||
7. Two bugs in dld.c for AIX are fixed
|
||||
8. A bug of setting tracing option is fixed.
|
||||
9. The driver will not be unloaded by SQLDisconnect()
|
||||
but by SQLFreeConnect() or next SQLConnect()/
|
||||
SQLDriverConnect()/SQLBrowsConnect() on a different
|
||||
driver. This will save driver's loading time if it
|
||||
has been used by a previous connection(even there
|
||||
is no active connection on this driver).
|
||||
10.Another three platforms are supported:
|
||||
FreeBSD 2.x
|
||||
Concurrent Max/OS SVR4 1.x
|
||||
DG/UX 5.x
|
||||
11.autoconfig and build -- shell scripts to help modifying
|
||||
Config.mk and building iodbc driver manager
|
||||
|
||||
Nov. 12, 1995, v2.12
|
||||
12.I realized that a driver manager doesn't aware of
|
||||
difference between a C5 (i.e. hstmt) and a C6
|
||||
(i.e. transaction) states.
|
||||
13.The link flags "-lc" has been droped from Linux ELF
|
||||
section of Config.mk to fix a segment fault problem.
|
||||
Now, it works fine on Slackware 2.3 and Red Hat 2.0
|
||||
(kernel version are 1.2.xx and 1.3.xx respectively).
|
||||
14.On FreeBSD 2.x, dlsym() doesn't handle the '_' prefix
|
||||
prepended to an exportting function symbol by compiler.
|
||||
So, CLI_NAME_PREFIX needs to be defined as "_SQL" for
|
||||
FreeBSD 2.x.
|
||||
15.Some files are renamed
|
||||
dld.c -> dlf.c
|
||||
dld.h -> dlf.h
|
||||
confg.h -> config.h
|
||||
16. Fix a bug on setting tracing options.
|
||||
|
||||
364
Agent-Windows/OGP64/usr/share/doc/libiodbc/README
Normal file
364
Agent-Windows/OGP64/usr/share/doc/libiodbc/README
Normal file
|
|
@ -0,0 +1,364 @@
|
|||
iODBC Driver Manager
|
||||
Copyright (C) 1995 by Ke Jin <kejin@empress.com>
|
||||
Copyright (C) 1996-2012 by OpenLink Software <iodbc@openlinksw.com>
|
||||
All Rights Reserved.
|
||||
|
||||
|
||||
1. Introduction
|
||||
|
||||
Welcome to the iODBC driver manager maintained by OpenLink Software
|
||||
(<http://www.openlinksw.com/>). This kit will provide you with
|
||||
everything you need in order to develop ODBC-compliant applications
|
||||
under Unix without having to pay royalties to other parties.
|
||||
|
||||
This kit consists of a number of parts:
|
||||
|
||||
o The iODBC driver manager. This is a complete implementation of
|
||||
an ODBC driver manager, released under either the GNU Library
|
||||
General Public License or the BSD License. We fully comply with
|
||||
these licenses by giving you this product in source form (as well
|
||||
as the binary form). You can download the latest version of the
|
||||
driver manager from <http://www.iodbc.org/>
|
||||
|
||||
o A simple example, iodbctest.c, which gives you a command-line
|
||||
interface to SQL. You can fit this to your purposes, but at the very
|
||||
least this is useful for verification of your ODBC installation.
|
||||
|
||||
You can use either part stand-alone, if you wish.
|
||||
|
||||
An ODBC driver is still needed to affect your connection
|
||||
architecture. You may build a driver with the iODBC components or
|
||||
obtain an ODBC driver from a commercial vendor. OpenLink Software
|
||||
produces cross-platform commercial drivers as well as maintaining
|
||||
the iODBC distribution: evaluation copies may be obtained via
|
||||
download from <http://www.openlinksw.com/>. Any ODBC-compliant
|
||||
driver will work with the iODBC Driver Manager.
|
||||
|
||||
See also the iODBC website, <http://www.iodbc.org/>, for more pointers
|
||||
to various ODBC drivers.
|
||||
|
||||
|
||||
|
||||
2. Installation of run-time distribution
|
||||
|
||||
You probably already unpacked this distribution. The next step is
|
||||
to make sure that your applications can find all the dynamic link
|
||||
libraries. Depending on your system's implementation of dynamic link
|
||||
libraries, you have a number of options:
|
||||
|
||||
o Install the libraries in a directory that is searched by your
|
||||
linker by default. Typical locations are /usr/lib and
|
||||
/usr/local/lib.
|
||||
|
||||
o Install the libraries in some other place, and make sure that the
|
||||
environment variable your dynamic linker uses to find extra
|
||||
locations for dynamic link libraries. Most systems use the
|
||||
environment variable LD_LIBRARY_PATH to this end. Exceptions are
|
||||
AIX which uses LIBPATH and HP/UX which uses SHLIB_PATH.
|
||||
|
||||
If your system has a C compiler, you can verify the installation
|
||||
by compiling the iodbctest program. Otherwise, you may have ODBC
|
||||
applications installed on your system which you can use.
|
||||
|
||||
|
||||
|
||||
3. Configuration of run-time distribution
|
||||
|
||||
The iODBC driver manager looks for a file ~/.odbc.ini, where the
|
||||
tilde stands for the user's home directory. This file only contains a
|
||||
default section where you can select which driver library to use. Copy
|
||||
the odbc.ini file from the examples directory to ~/.odbc.ini and make
|
||||
sure the right path and filename is used for your installation.
|
||||
|
||||
A data source is a section (enclosed in square parenthesis), and
|
||||
the attributes for a data source are given within this section.
|
||||
The most important attribute to iODBC for each datasource is the Driver
|
||||
attribute. This must point to the shared library for the ODBC driver
|
||||
associated with the data source.
|
||||
|
||||
As example, the OpenLink ODBC drivers have a number of attributes
|
||||
which can be set for a data source. Here is a description (with ODBC
|
||||
connect string tags between parenthesis):
|
||||
|
||||
Host
|
||||
The hostname where the database resides (HOST).
|
||||
|
||||
ServerType
|
||||
The type of server (see oplrqb.ini on the server, SVT).
|
||||
|
||||
ServerOptions
|
||||
Server-specific extra options. See OpenLink server documentation
|
||||
for agents which can use this.
|
||||
|
||||
Database
|
||||
The database to use (DATABASE).
|
||||
|
||||
Options
|
||||
Connect options for the database (OPTIONS).
|
||||
|
||||
UserName
|
||||
The name of the user (a password cannot be specified in the
|
||||
UDBCINI file, UID/PWD).
|
||||
|
||||
ReadOnly
|
||||
A Yes/No value in order to make the connection read-only
|
||||
(READONLY=Y/N).
|
||||
|
||||
FetchBufferSize
|
||||
The number of records that are transferred in a single call to
|
||||
the server. Default is 5; maximum is 99, minimum is 1
|
||||
(FBS=value).
|
||||
|
||||
Protocol
|
||||
The protocol to use. Leave set to ``TCP'' for this release.
|
||||
|
||||
|
||||
Apart from these data source-specific settings, you may add a section
|
||||
called [Communications], which you may use to tune our driver further:
|
||||
|
||||
ReceiveTimeout
|
||||
The time the client application will wait for the database agent
|
||||
to finish the request (default is 60 seconds).
|
||||
|
||||
BrokerTimeout
|
||||
The time the client application will wait for the request broker
|
||||
to accept of reject a database connection (default is 30
|
||||
seconds).
|
||||
|
||||
SendSize
|
||||
RPC send buffer size. A value of 0 (the default) will cause the
|
||||
application to use system-dependent defaults.
|
||||
|
||||
ReceiveSize
|
||||
RPC receive buffer size. A value of 0 (the default) will cause
|
||||
the application to use system-dependent defaults.
|
||||
|
||||
DebugFile
|
||||
If set, the name of a file to which debugging output from the
|
||||
driver should be directed.
|
||||
|
||||
|
||||
|
||||
4. Contribution of changes, patches and updates.
|
||||
|
||||
While not mandated by the BSD license, any patches you make to
|
||||
the iODBC may be contributed back into the iODBC project at
|
||||
your discretion. Contributions will benefit the Open Source and
|
||||
Data Access community as a whole. Submissions may be made at
|
||||
<http://www.iodbc.org/>.
|
||||
|
||||
|
||||
|
||||
5. iODBC driver manager platform availability
|
||||
|
||||
The iODBC driver manager has been ported to following Unix platforms:
|
||||
|
||||
BSDi BSD/OS 2.x ?
|
||||
DEC Unix(OSF/1) 3.x - 5.x DEC Alpha
|
||||
DG/UX 5.x Aviion
|
||||
FreeBSD 2.x - 5.x x86
|
||||
HP/UX 9.x - 11.x HP9000 s700/s800
|
||||
HP/UX 9.x HP9000 s300/s400
|
||||
IBM AIX 3.x - 5.x IBM RS6000, PowerPC
|
||||
Linux ELF 1.x, 2.x x86, Itanium, PowerPC
|
||||
Mac OS X 10.x PowerPC
|
||||
Max/OS SVR4 1.x Concurrent Maxion 9200 MP
|
||||
NCR SVR4 3.x NCR 3435
|
||||
OpenVMS 6.x DEC Alpha
|
||||
SCO OpenServer 5.x x86
|
||||
SGI Irix SVR4 5.x, 6.x IP12 MIPS, IP22 MIPS
|
||||
SunOS 4.1.x Sun Sparc
|
||||
Sun Solaris 2.x Sun Sparc, PCx86
|
||||
UnixWare SVR4.2 1.x, 2.x x86
|
||||
Windows NT 4.x x86
|
||||
|
||||
As the iODBC driver manager uses autoconf/automake/libtool it should
|
||||
be portable to most modern UNIX platforms out of the box. However if
|
||||
you do need to make changes to the code or the configuration files,
|
||||
we would appreciate you share your changes with the rest of the
|
||||
internet community by mailing your patches to <iodbc@openlinksw.com>
|
||||
so we can include them for the next build.
|
||||
|
||||
Porting of iODBC driver manager to some non-UNIX operating systems
|
||||
such as Windows family(3.x, 95, NT), OS/2 and Mac Classic is
|
||||
supported but has not been compiled and tested recently. Of cause,
|
||||
you need to supply a make/build file and a short LibMain for creating
|
||||
the iodbc.dll.
|
||||
|
||||
|
||||
|
||||
6. How to build iODBC driver manager:
|
||||
|
||||
Mac OS X users should read the separate README.MACOSX document for
|
||||
more detail of porting on this platform. Otherwise:
|
||||
|
||||
step 1. Run configure to adjust to target platform
|
||||
step 2. Run make
|
||||
step 3. Run make install
|
||||
|
||||
The configure program will examine your system for various compiler
|
||||
flags, system options etc. In some cases extra flags need to be
|
||||
added for the C compiler to work properly.
|
||||
|
||||
E.g. on HP systems you may need:
|
||||
|
||||
$ CFLAGS="-Ae -O" ./configure --prefix=/usr/local ..........
|
||||
|
||||
|
||||
File Hierarchy
|
||||
--------------
|
||||
|
||||
Note that the path of the system wide odbc.ini file is calculated as
|
||||
follows (based on flags to ./configure):
|
||||
|
||||
no --prefix default is /etc/odbc.ini
|
||||
--prefix=/usr /etc/odbc.ini
|
||||
--prefix=/xxx/yyy /xxx/yyy/etc/odbc.ini
|
||||
--sysconfdir=/xxx/yyy /xxx/yyy/odbc.ini
|
||||
--with-iodbc-inidir=/xxx/yyy /xxx/yyy/odbc.ini
|
||||
|
||||
If the `--with-layout=' option is set, then the prefix and
|
||||
sysconfdir parameters will be changed accordingly. Currently, this
|
||||
parameter understands values of `gentoo', `redhat', `gnu',
|
||||
`debian' or `opt' (with everything going into /opt/iodbc/). If
|
||||
both are specified, a --prefix argument will overrule a --with-layout.
|
||||
|
||||
|
||||
Example
|
||||
-------
|
||||
|
||||
$ ./configure --prefix=/usr/local --with-iodbc-inidir=/etc
|
||||
...
|
||||
...
|
||||
...
|
||||
$ make
|
||||
...
|
||||
...
|
||||
...
|
||||
$ su
|
||||
# make install
|
||||
...
|
||||
...
|
||||
...
|
||||
|
||||
|
||||
7. odbc.ini
|
||||
|
||||
Driver manager and drivers use odbc.ini file or connection string
|
||||
when establishing a data source connection. On Windows, odbc.ini is
|
||||
located in Windows directory.
|
||||
|
||||
On UNIX, the iODBC driver manager looks for the odbc.ini file in the
|
||||
following sequence:
|
||||
|
||||
1. check environment variable ODBCINI
|
||||
|
||||
2. check $HOME/.odbc.ini
|
||||
|
||||
3. check home in /etc/passwd and try .odbc.ini in there
|
||||
|
||||
4. system-wide odbc.ini (settable at configuration time)
|
||||
|
||||
|
||||
Item 1 is the easiest as most drivers will also look at this variable.
|
||||
|
||||
|
||||
|
||||
The format of odbc.ini( or ~/.odbc.ini ) is defined as:
|
||||
|
||||
odbc.ini ::= data_source_list
|
||||
|
||||
data_source_list ::= /* empty */
|
||||
| data_source '\n' data_source_list
|
||||
|
||||
data_source ::= '[' data_source_name ']' '\n' data_source_desc
|
||||
|
||||
data_source_name ::= 'default' | [A-Za-z]*[A-Za-z0-9_]*
|
||||
|
||||
data_source_desc ::= /* empty */
|
||||
| attrib_desc '\n' data_source_desc
|
||||
|
||||
addrib_desc ::= Attrib '=' attrib_value
|
||||
|
||||
Attrib ::= 'Driver' | 'PID' | 'UID' | driver_def_attrib
|
||||
|
||||
driver_def_attrib ::= [A-Za-z]*[A-Za-z0-9_]*
|
||||
|
||||
|
||||
|
||||
An example of an odbc.ini file:
|
||||
|
||||
;
|
||||
; odbc.ini
|
||||
;
|
||||
[ODBC Data Sources]
|
||||
Myodbc = Myodbc
|
||||
Sample = OpenLink Generic ODBC Driver
|
||||
Virtuoso = Virtuoso
|
||||
|
||||
[ODBC]
|
||||
TraceFile = /tmp/odbc.trace
|
||||
Trace = 0 ; set to 1 to enable tracing
|
||||
|
||||
[Sample]
|
||||
Driver = /usr/local/openlink/lib/oplodbc.so.1
|
||||
Description = Sample OpenLink DSN
|
||||
Host = localhost
|
||||
UserName = openlink
|
||||
Password = xxxx
|
||||
ServerType = Oracle 8.1.x
|
||||
Database =
|
||||
FetchBufferSize = 99
|
||||
ReadOnly = no
|
||||
|
||||
[Virtuoso]
|
||||
Driver = /usr/local/virtuoso/lib/virtodbc.so.1
|
||||
Address = localhost:1112
|
||||
Database = Demo
|
||||
|
||||
[Myodbc]
|
||||
Driver = /usr/lib/libmyodbc.so
|
||||
HOST = localhost
|
||||
|
||||
[Default]
|
||||
Driver = /usr/local/openlink/lib/oplodbc.so.1
|
||||
|
||||
|
||||
|
||||
8. Tracing
|
||||
|
||||
iODBC driver manager traces driver's ODBC call invoked by the driver
|
||||
manager. Default tracing file is ./odbc.log. Tracing option (i.e.
|
||||
on/off or optional tracing file name) can be set in odbc.ini file
|
||||
under the [ODBC] heading as:
|
||||
|
||||
[ODBC]
|
||||
TraceFile = <optional_trace_file>
|
||||
Trace = ON | On | on | 1 | OFF | Off | off | 0
|
||||
|
||||
If <optional_trace_file> is stderr or stdout, i.e.
|
||||
|
||||
TraceFile = stderr
|
||||
|
||||
or
|
||||
|
||||
TraceFile = stdout
|
||||
|
||||
the tracing message will go to the terminal screen (if it is available).
|
||||
|
||||
|
||||
9. Further Information Sources:
|
||||
|
||||
<http://www.iodbc.org/>
|
||||
iODBC project home page.
|
||||
Binaries, source, documentation
|
||||
|
||||
<http://sourceforge.net/projects/iodbc>
|
||||
Source, CVS tree, mailing lists, forums, bug reports
|
||||
|
||||
<http://www.openlinksw.com/>
|
||||
OpenLink Software.
|
||||
Free trials and support for OpenLink's ODBC drivers.
|
||||
|
||||
<http://www.microsoft.com/data/odbc/>
|
||||
Microsoft's ODBC pages.
|
||||
Loading…
Add table
Add a link
Reference in a new issue