Installing OCILIB

Compatibilities
Actual version of OCILIB has been validated on :

Please, contact the author if you have validated OCILIB on platforms or compilers not listed here.

Global build options
OCILIB supports the following global build options:

=> Oracle import:

=> Oracle charset

=> Calling convention (WINDOWS ONLY)

Note:
On Windows, OCI_API MUST be set to __stdcall in order to use prebuilt libraries
Installing OCIB on UNIX like systems
OCILIB uses GNU tools for deployment and installation on UNIX like platforms

Uncompress the archive (ocilib-x.y.z-gnu.tar.gz)

Check the shared library path environment variable (LD_LIBRARY_PATH, LD_PATH, ...):

In order to get theses values loaded at logon time, export theses values in your .profile configuration file :

GNU Installation options :

OCILIB supports some options that are not needed for most common configurations.

List of available options:

Note:
--with-oracle-headers-path and --with-oracle-lib-path are meant to be used with Instant client only but can used for regular client of libs and headers are not located in usual folders

If the Oracle OCI linkage mode is set to 'linkage' (default) and no Oracle lib path is provided, OCILIB configure script tries to located the Oracle library folder following this sequence :

To compile native 64 bits versions of OCILIB, you need pass your compiler specifics flags to the configure script.

To use OCILIB in a project :

where :

Some older version of Oracle 8 have direct path symbols located in the library libclient8. So with theses versions, you must include as well the linker flag -lclient8 to use Direct Path API.

Installing and using OCILIB on Microsoft Windows
32bits and 64bits DLLs are provided. Visual .NET (2005/2008) solutions are also provided to recompile the Dlls and the demo.

[x] is the compiled version of OCILIB ("a" -> ANSI, "w" -> Unicode, "m" -> Mixed)

To use OCILIB in a project :

Note for MinGW users :

Note:
The OCI import mode (OCI_IMPORT_LINKAGE or OCI_IMPORT_RUNTIME is onbly used when compliing OCILIB source code
Oracle Instant Client Support
OCILIB supports Oracle Instant Client.

On Microsoft Windows, there is no difference between using a regular Oracle client and an Instant Client with OCILIB

On Unix-like systems, the Instant Client is divided in different packages.

Public headers and shared libs are not part of the same package.

So, you must provide the following options to the configure command:

If your instant client package containing the shared libs does not have a symbolic link 'libclntsh.[shared lib extension]' to the fully qualified shared lib real name, you must create it:

Example on Linux:


Generated on Thu Jul 30 17:41:53 2009 for OCILIB (C Driver for Oracle) by  doxygen 1.5.4