ruby-oci8 2.2.10-x64-mingw-ucrt

data/docs/install-instant-client.md

@@ -0,0 +1,194 @@
+# @title Install for Oracle Instant Client
+
+Install for Oracle Instant Client
+=================================
+
+Introduction
+------------
+
+This page explains the way to install ruby-oci8 for Oracle Instant Client.
+
+Look at {file:docs/install-full-client.md} for Oracle Full Client.
+
+Look at {file:docs/install-binary-package.md} for Windows unless you
+have a special need to compile ruby-oci8 by yourself.
+
+Look at {file:docs/install-on-osx.md} for OS X.
+
+Install Oracle Instant Client Packages
+--------------------------------------
+
+### Download Instant Client Packages
+
+Download the following packages from [Oracle Technology Network](http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html).
+
+* Instant Client Package - Basic or Basic Lite
+* Instant Client Package - SDK
+* Instant Client Package - SQL*Plus
+
+Note: use 32-bit packages for 32-bit ruby even though the OS is 64-bit.
+
+### UNIX zip packages
+
+Unzip the packages as follows:
+
+    mkdir /opt
+    mkdir /opt/oracle
+    cd /opt/oracle
+    unzip path/to/instantclient-basic-OS-VERSION.zip
+    unzip path/to/instantclient-sdk-OS-VERSION.zip
+    unzip path/to/instantclient-sqlplus-OS-VERSION.zip
+
+If /opt/oracle/instantclient12_1/libclntsh.so is not found, make
+a symbolic link to link the library.
+
+    cd /opt/oracle/instantclient12_1
+    ln -s libclntsh.so.12.1 libclntsh.so
+
+Note:
+
+* use libclntsh.sl instead of libclntsh.so on HP-UX PA-RISC.
+* skip this step for AIX.
+* run `yum install libaio` also on Redhat.
+* run `apt-get install libaio1` also on Ubuntu.
+
+Set the library search path, whose name depends on the OS, to point to
+the installed directory.
+
+<table style="border: 1px #E3E3E3 solid; border-collapse: collapse; border-spacing: 0;">
+<thead>
+  <tr><th> OS                        </th><th> library search path                   </th></tr>
+</thead>
+<tbody>
+  <tr><td> Linux                     </td><td> LD_LIBRARY_PATH                       </td></tr>
+  <tr><td> Solaris 32-bit ruby       </td><td> LD_LIBRARY_PATH_32 or LD_LIBRARY_PATH </td></tr>
+  <tr><td> Solaris 64-bit ruby       </td><td> LD_LIBRARY_PATH_64 or LD_LIBRARY_PATH </td></tr>
+  <tr><td> HP-UX PA-RISC 32-bit ruby </td><td> SHLIB_PATH                            </td></tr>
+  <tr><td> HP-UX PA-RISC 64-bit ruby </td><td> LD_LIBRARY_PATH                       </td></tr>
+  <tr><td> HP-UX IA64                </td><td> LD_LIBRARY_PATH                       </td></tr>
+  <tr><td> AIX                       </td><td> LIBPATH                               </td></tr>
+</tbody>
+</table>
+Note: Look at {file:docs/install-on-osx.md} for OS X.
+
+For example:
+
+    $ LD_LIBRARY_PATH=/opt/oracle/instantclient_12_1
+    $ export LD_LIBRARY_PATH
+
+Though many instant client pages indicate that the environment varialbe
+`ORACLE_HOME` should be set, it isn't necessary unless Oracle Net
+configuration files such as `tnsnames.ora` and `sqlnet.ora` are in
+`$ORACLE_HOME/network/admin/`.
+
+### Linux rpm packages
+
+Install the downloaded packages as follows:
+
+    rpm -i path/to/oracle-instantclient-basic-VERSION-ARCH.rpm
+    rpm -i path/to/oracle-instantclient-devel-VERSION-ARCH.rpm
+    rpm -i path/to/oracle-instantclient-sqlplus-VERSION-ARCH.rpm
+
+Set LD_LIBRARY_PATH to point to the directory where libclntsh.so is installed.
+
+For example:
+
+    $ LD_LIBRARY_PATH=/usr/lib/oracle/12.1/client/lib
+    $ export LD_LIBRARY_PATH
+
+### Windows
+
+Unzip the packages and set `PATH` to point to the directory where `OCI.DLL` is installed.
+
+If `require "ruby-oci8"` raises a load error such as "OCI.DLL: 126(The
+specified module could not be found. )", either `OCI.DLL` or a DLL depended
+by `OCI.DLL` could not be found in `PATH`.
+
+If `OCI.DLL` is surely in `PATH`, the missing module is a Visual C++ runtime
+library in most cases. You need to install "Microsoft Visual C++ Redistributable
+Package" or copy a runtime library to the directory where `ruby.exe` resides.
+
+| Oracle Version | Package | Runtime Library|
+|---|---|---|
+| 18.3     | [Microsoft Visual C++ 2013 Redistributable Package][2013] | MSVCR120.DLL |
+| 12.2.0.x | [Microsoft Visual C++ 2013 Redistributable Package][2013] | MSVCR120.DLL |
+| 12.1.0.x | [Microsoft Visual C++ 2010 Redistributable Package][2010] | MSVCR100.DLL |
+| 11.2.0.x | Microsoft Visual C++ 2005 SP1 Redistributable Package ([x86][2005SP1_x86], [x64][2005SP1_x64]) | MSVCR80.DLL(The file version must be 8.0.50727.762.) |
+| 11.1.0.x | [No separate redistributable package][2003] | MSVCR71.DLL |
+| 10.2.0.x | [No separate redistributable package][2003] | MSVCR71.DLL |
+
+[2013]: https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads
+[2010]: http://www.microsoft.com/en-us/download/details.aspx?id=26999
+[2005SP1_x86]: https://www.microsoft.com/en-us/download/details.aspx?id=5638
+[2005SP1_x64]: https://www.microsoft.com/en-us/download/details.aspx?id=18471
+[2003]: http://stackoverflow.com/questions/1596167/where-to-download-microsoft-visual-c-2003-redistributable#6132093
+
+Check the environment
+---------------------
+
+### Oracle installation
+
+Run the following command and confirm it works fine. If it doesn't
+work well, check `LD_LIBRARY_PATH` or PATH.
+
+    sqlplus USERNAME/PASSWORD
+
+### ruby installation
+
+Run the following command. If it ends with "can't find header files
+for ruby" or "ruby: no such file to load -- mkmf (LoadError)", you need
+to install ruby-devel(redhat) or ruby-dev(debian/ubuntu).
+
+    ruby -r mkmf -e ""
+
+### development tools
+
+You need a C compiler and development tools such as make or nmake.
+Note that they must be same with ones used to compile the ruby.
+For example, you need Oracle Solaris Studio, not gcc, for ruby
+compiled by Oracle Solaris Studio.
+
+Installation
+------------
+
+If you get a problem in the following steps, look at {file:docs/platform-specific-issues.md}
+and {file:docs/report-installation-issue.md}.
+
+### gem package
+
+Run the following command.
+
+    gem install ruby-oci8
+
+If you get a problem, look at {file:docs/platform-specific-issues.md}
+and {file:docs/report-installation-issue.md}.
+
+### tar.gz package
+
+#### Download the source code
+
+Download the latest tar.gz package from [download page][].
+
+Note: if you are using Windows and you have no special need to compile
+it by yourself, look at {file:docs/install-binary-packge.md}.
+
+#### Run make and install
+
+##### UNIX or Windows(mingw32, cygwin)
+
+    gzip -dc ruby-oci8-VERSION.tar.gz | tar xvf -
+    cd ruby-oci8-VERSION
+    make
+    make install
+
+note: If you use '`sudo`', use it only when running '`make install`'.
+'`sudo`' doesn't pass library search path to the executing command for security reasons.
+
+##### Windows(mswin32)
+
+    gzip -dc ruby-oci8-VERSION.tar.gz | tar xvf -
+    cd ruby-oci8-VERSION
+    nmake
+    nmake install
+
+[download page]: https://bintray.com/kubo/generic/ruby-oci8

data/docs/install-on-osx.md

@@ -0,0 +1,46 @@
+# @title Install ruby-oci8 on macOS
+
+Install ruby-oci8 on macOS
+=========================
+
+**Note: Ruby-oci8 doesn't run on Apple Silicon because Oracle instant client
+for Apple Silicon has not been released yet.**
+
+Prerequisite
+------------
+
+* Command line tools for Xcode or Xcode (by executing `xcode-select --install`) or [Xcode]
+
+Install Oracle Instant Client Packages
+--------------------------------------
+
+If you have installed [Homebrew], use the following command:
+
+```shell
+$ brew tap InstantClientTap/instantclient
+$ brew install instantclient-basic   # or instantclient-basiclite
+$ brew install instantclient-sdk
+$ brew install instantclient-sqlplus # (optionally)
+```
+
+Otherwise, look at this [page][OTN] and set the environment variable
+`OCI_DIR` to point the the directory where instant client is installed.
+Ruby-oci8 installation script checks the directory.
+
+```shell
+export OCI_DIR=$HOME/Downloads/instantclient_19_8  # for example
+```
+
+Install ruby-oci8
+-----------------
+
+Note that `/usr/bin/ruby` isn't available. You need to use [`rbenv`] or so.
+
+```shell
+$ gem install ruby-oci8
+```
+
+[Homebrew]: http://brew.sh/
+[OTN]: https://www.oracle.com/database/technologies/instant-client/macos-intel-x86-downloads.html#ic_osx_inst
+[Xcode]: https://apps.apple.com/us/app/xcode/id497799835
+[`rbenv`]: https://github.com/rbenv/rbenv

data/docs/ldap-auth-and-function-interposition.md

@@ -0,0 +1,123 @@
+# @title LDAP Authentication and Function Interposition
+
+LDAP Authentication and Function Interposition
+==============================================
+
+Problems
+--------
+
+The following code may trigger segmentation faults or unexpected behaviours.
+
+    require 'pg' # or any modules using LDAP such as ActiveLdap
+    require 'oci8'
+    
+    conn = OCI8.new('username/password@dbname.example.com')
+    ...
+
+It happens when all the following conditions are satisfied.
+
+* The platform is Unix
+* The PostgreSQL client library, which `pg` depends, was compiled with LDAP support.
+* LDAP authentication is used to connect to an Oracle server.
+
+It is caused by function interposition as follows:
+
+* The ruby process loads `pq` and its depending libraries such as
+  `libpq.so`(PostgreSQL client library) and `libldap_r.so`(LDAP library).
+* Then it loads `oci8` and its depending libraries such as
+  `libclntsh.so`(Oracle client library).
+* When LDAP authentication is used, `libclntsh.so` tries to use
+  LDAP functions in the library.
+* However it uses LDAP functions in `libldap_r.so` because the function
+  in the firstly loaded library is used when more than one library exports
+  functions whose names are same.
+* It triggers segmentation faults or unexpected behaviours because
+  implementations of LDAP functions are different even though their names
+  are same.
+
+The reverse may cause same results by the following code.
+
+    require 'oci8'
+    require 'pg'
+    
+    ... connect to PostgreSQL using LDAP ...
+
+### Note for macOS
+
+Libraries in two-level namespaces are free from function interposition on macOS.
+See the second paragraph of [this document][mach-o]. If `TWOLEVEL` is
+found in the output of `otool -hV /path/to/library`, it is in a
+two-level namespace. Otherwise it is in a single-level (flat) namespace.
+
+Oracle client library (`libclntsh.dylib.12.1`) is in a flat namespace.
+It suffers from function interposition.
+
+    $ otool -hV libclntsh.dylib.12.1
+    Mach header
+          magic cputype cpusubtype  caps    filetype ncmds sizeofcmds      flags
+    MH_MAGIC_64  X86_64        ALL  0x00       DYLIB    19       2360 DYLDLINK NO_REEXPORTED_DYLIBS MH_HAS_TLV_DESCRIPTORS
+
+PostgreSQL client library (`libpq.5.dylib`) installed by [brew][] depends on an OS-supplied LDAP library.
+
+    $ otool -L libpq.5.dylib 
+    libpq.5.dylib:
+        /usr/local/opt/postgresql/lib/libpq.5.dylib (compatibility version 5.0.0, current version 5.9.0)
+        /usr/local/opt/openssl/lib/libssl.1.0.0.dylib (compatibility version 1.0.0, current version 1.0.0)
+        /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib (compatibility version 1.0.0, current version 1.0.0)
+        /System/Library/Frameworks/Kerberos.framework/Versions/A/Kerberos (compatibility version 5.0.0, current version 6.0.0)
+        /System/Library/Frameworks/LDAP.framework/Versions/A/LDAP (compatibility version 1.0.0, current version 2.4.0)
+        /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1238.0.0)
+
+The OS-supplied LDAP library is in a two-level namespace.
+
+    $ otool -hV /System/Library/Frameworks/LDAP.framework/Versions/A/LDAP
+    Mach header
+          magic cputype cpusubtype  caps    filetype ncmds sizeofcmds      flags
+    MH_MAGIC_64  X86_64        ALL  0x00       DYLIB    22       2528   NOUNDEFS DYLDLINK TWOLEVEL NO_REEXPORTED_DYLIBS APP_EXTENSION_SAFE
+
+As a result, the PostgreSQL client library is free from function interposition.
+
+Solution 1
+----------
+
+If you don't connect to PostgreSQL using LDAP, use the following code.
+
+    require 'oci8'  # This must be before "require 'pg'".
+    require 'pg'
+    
+    conn = OCI8.new('username/password@dbname.example.com')
+    ...
+    ... connect to a PostgreSQL server ...
+
+Oracle client library uses LDAP functions in `libclntsh.so` because `libclntsh.so`
+is loaded before `libldap_r.so`.
+
+Don't connect to PostgreSQL using LDAP because `libpq.so` tries to use
+LDAP functions in `libldap_r.so` but faultily uses functions in `libclntsh.so`.
+
+Note for macOS: This fixes all function interposition issues if the LDAP library
+in a two-level namespace.
+
+Solution 2
+----------
+
+If LDAP is used to connect to both Oracle and PostgreSQL and the platform
+is Linux or macOS, use ruby-oci8 2.2.4 or later and use the following code.
+
+    require 'pg'
+    require 'oci8' # This must be after "require 'pg'".
+    
+    conn = OCI8.new('username/password@dbname.example.com')
+    ...
+    ... connect to a PostgreSQL server using LDAP ...
+
+PostgreSQL client library uses LDAP functions in `libldap_r.so` because `libldap_r.so`
+is loaded before `libclntsh.so`.
+
+Oracle client library uses LDAP functions in `libclntsh.so` because ruby-oci8
+forcedly modifies PLT (Procedure Linkage Table) entries to point to
+functions in `libclntsh.so` if they point to functions in other libraries.
+(PLT is equivalent to IAT (Import Address Table) on Windows.)
+
+[mach-o]: https://developer.apple.com/library/content/documentation/DeveloperTools/Conceptual/MachOTopics/1-Articles/executing_files.html
+[brew]: http://brew.sh/

data/docs/number-type-mapping.md

@@ -0,0 +1,79 @@
+# @title Number Type Mapping between Oracle and Ruby
+
+Number Type Mapping between Oracle and Ruby
+===========================================
+
+Default mapping
+---------------
+
+Oracle numbers in select statements are fetched as followings by default:
+
+| Oracle Data Type | Ruby Class |
+|---|---|
+| NUMBER(prec) or NUMBER(prec, 0) | Integer |
+| NUMBER(prec, scale) where prec < 15 and scale != 0 | Float |
+| NUMBER(prec, scale) where prec >= 15 and scale != 0 | BigDecimal |
+| FLOAT or FLOAT(prec) | Float |
+| NUMBER without precision and scale | BigDecimal |
+| number type returned by functions or calculated number | BigDecimal |
+| BINARY_FLOAT | Float |
+| BINARY_DOUBLE | Float |
+
+When the data type is within Integer or Float class, it is fetched
+as Integer or Float. Otherwise, BigDecimal.
+
+Note that the mapping is determined by the column definition in
+select statements, not by the actual value fetched.
+For example the column in `select count(*) from table_name` is
+fetched as BigDecimal because it is returned from `count` function.
+
+The mapping is customizable by `OCI8::BindType::Mapping`.
+The default values of Oracle number data type mapping are:
+
+    # NUMBER or FLOAT data type, used for the first six rows in the above table
+    OCI8::BindType::Mapping[:number] = OCI8::BindType::Number
+    # BINARY_FLOAT data type, used for the seventh row in the above table
+    OCI8::BindType::Mapping[:binary_float] = OCI8::BindType::BinaryDouble
+    # BINARY_DOUBLE data type, used for the eighth row in the above table
+    OCI8::BindType::Mapping[:binary_double] = OCI8::BindType::BinaryDouble
+
+`OCI8::BindType::Number` checks precision and scale to determine
+ruby class. The first four rows in the above table are hard-coded.
+The fifth and sixth rows are, however, customizable by
+`OCI8::BindType::Mapping[:number_no_prec_setting]` and
+`OCI8::BindType::Mapping[:number_unknown_prec]` respectively.
+
+The default values are:
+
+    OCI8::BindType::Mapping[:number_no_prec_setting] = OCI8::BindType::BigDecimal
+    OCI8::BindType::Mapping[:number_unknown_prec] = OCI8::BindType::BigDecimal
+
+The mapping may be changed as follows in future.
+
+| Oracle Data Type | Ruby Class |
+|---|---|
+| NUMBER(prec) or NUMBER(prec, 0) | Integer |
+| other NUMBER  | OraNumber |
+| BINARY_FLOAT | Float |
+| BINARY_DOUBLE | Float |
+
+Customize mapping
+-----------------
+
+Add the following code to fetch all number or float columns as {OraNumber}.
+
+    OCI8::BindType::Mapping[:number] = OCI8::BindType::OraNumber
+
+Otherwise, add the following code to customize the fifth and sixth rows only
+in the above table.
+
+    OCI8::BindType::Mapping[:number_no_prec_setting] = OCI8::BindType::OraNumber
+    OCI8::BindType::Mapping[:number_unknown_prec] = OCI8::BindType::OraNumber
+
+If you want to fetch numbers as Integer or Float by its actual value, use
+the following code:
+
+    # Fetch numbers as Integer when their fractional part is zero.
+    # Otherwise, Float. For example when a column contains 10 and
+    # 10.1, they are fetched as Integer and Float respectively.
+    OCI8::BindType::Mapping[:number] = OCI8::BindType::BasicNumberType

data/docs/platform-specific-issues.md

@@ -0,0 +1,164 @@
+# @title Platform Specific Issues
+
+Platform Specific Issues
+========================
+
+Linux
+-----
+
+### Ubuntu 11.10 (Oneiric Ocelot)
+
+If the following error occurs even though libc6-dev is installed,
+
+    Do you install glibc-devel(redhat) or libc6-dev(debian)?
+    You need /usr/include/sys/types.h to compile ruby-oci8.
+
+You need to use ruby-oci8 2.1.0 or upper. Otherwise, run the following command and re-install ruby-oci8.
+
+    $ sudo ln -s /usr/include/linux/ /usr/include/sys
+
+### General Linux
+
+Use the same bit-width of libraries with ruby. For example, x86\_64
+instant client for x86\_64 ruby and 32-bit instant client for 32-bit
+ruby. It depends on the ruby but not on the OS. As for full client,
+x86\_64 ruby cannot use with 32-bit full client, but 32-bit ruby can
+use with 64-bit full client because 32-bit libraries are in
+$ORACLE\_HOME/lib32.
+
+To check which type of ruby do you use:
+
+    file `which ruby`
+
+Note: "`" is a back quote.
+
+Mac OS X
+--------
+
+### OS X 10.7+
+
+Use the latest 64-bit instant client. The older 64-bit (10.2.0.4) instant client [doesn't work](https://forums.oracle.com/forums/thread.jspa?threadID=2187558). The older 32-bit instant client will work but only with 32-bit ruby or jruby (using JDBC).
+
+### Intel Mac (64-bit)
+
+See [How to setup Ruby and Oracle Instant Client on Snow Leopard](http://blog.rayapps.com/2009/09/06/how-to-setup-ruby-and-oracle-instant-client-on-snow-leopard/).
+Note that setting the environment variable RC\_ARCHS=x86\_64 instead of ARCHFLAGS="-arch x86\_64" will work fine also.
+
+### Intel Mac (32-bit)
+
+See [How to setup Ruby and Oracle Instant Client on Snow Leopard](http://blog.rayapps.com/2009/09/06/how-to-setup-ruby-and-oracle-instant-client-on-snow-leopard/). Note that you need to replace x86\_64 with i386 in the blog.
+
+The Intel Instant client is for Mac OS X 10.5 Leopard. If you are using 10.4 Tiger,
+use one of the following workarounds.
+
+* compile ruby as ppc. (look at [How to setup Ruby and Oracle client on Intel Mac](http://blog.rayapps.com/2007/08/27/how-to-setup-ruby-and-oracle-client-on-intel-mac/))
+* use [ruby-odbc](http://www.ch-werner.de/rubyodbc/) and a third party ODBC driver ([Actual Technologies](http://www.actualtechnologies.com) or [OpenLink Software](http://uda.openlinksw.com/)).
+* use JRuby and Oracle JDBC driver.
+
+### PowerPC Mac
+
+See [How to setup Ruby and Oracle Instant Client on Snow Leopard](http://blog.rayapps.com/2009/09/06/how-to-setup-ruby-and-oracle-instant-client-on-snow-leopard/). Note that you need to replace x86\_64 with ppc in the blog.
+
+Solaris
+-------
+
+You need a same compiler which is used to make ruby itself.
+For example, if the ruby is compiled by gcc, you need gcc. If it is compiled by Oracle Solaris Studio
+(formerly called as Sun Studio), you need Oracle Solaris Studio.
+
+If you use Blastwave.org's ruby and want not to install Sun Studio,
+you can edit rbconfig.rb by your self. [(look at here)](http://forum.textdrive.com/viewtopic.php?id=12630)
+
+If you use Sunfreeware.com's ruby and 
+
+    $ ruby -r rbconfig -e "p Config::CONFIG['GNU_LD']"
+
+prints "yes", you may need to edit rbconfig.rb distributed with the ruby
+as follows:
+
+    from: CONFIG["LDFLAGS"] = "-L.  -Wl,-E"
+    to:   CONFIG["LDFLAGS"] = "-L. "
+
+FreeBSD
+-------
+
+Oracle8-client port isn't available because it is too old.
+You need to use linux emulator.
+
+I have not run ruby-oci8 on linux emulator, but I guess it will
+run as follows. If it works, please tell me.
+
+If FreeBSD has a cross-compiler which can generate linux binaries,
+use it to compile ruby and ruby-oci8.
+
+If FreeBSD doesn't have such a compiler, install a linux distribution
+which FreeBSD can emulate to a PC machine, make ruby and ruby-oci8 in
+the linux box and copy them to the FreeBSD box as follows.
+
+On linux:
+
+    # make ruby
+    tar xvfz ruby-1.8.x.tar.gz
+    cd ruby-1.8.x
+    ./configure --prefix=/usr/local/ruby-1.8.x --enable-pthread
+    make
+    make install
+    # setup instant client
+      ....
+    # make ruby-oci8
+    PATH=/usr/local/ruby-1.8.x/bin:$PATH
+    tar xvfz ruby-oci8-1.0.x.tar.gz
+    cd ruby-oci8-1.0.x
+    make
+    make install
+    cd /usr/local/
+    tar cvfz ruby-1.8.x-linux.tar.gz ruby-1.8.x
+ 
+Copy ruby-1.8.x-linux.tar.gz to the FreeBSD box.
+ 
+On freebsd:
+
+    cd /compat/linux/usr/local
+    tar xvfz ruby-1.8.x-linux.tar.gz
+
+HP-UX
+-----
+
+You need a ruby which is linked with ''libpthread'' and ''libcl''.
+
+Run `configure`.
+
+    tar xvfz ruby-1.9.x.tar.gz
+    cd ruby-1.9.x
+    ./configure
+
+Then open `Makefile` to add '-lpthread -lcl' to `LIBS` and run `make`
+and `make install`.
+
+    make
+    make install
+
+The rest steps are described at {file:docs/install-full-client.md}.
+
+Windows
+-------
+
+On some machines using a slow disk, you may get the following error.
+
+    Permission denied - conftest.exe
+
+Edit mkmf.rb for a workaround.
+
+    def try_run(src, opt="")
+      if try_link0(src, opt)
+        xsystem("./conftest")
+      else
+        nil
+      end
+    ensure
+      # add the following one line.
+      sleep 1 if /mswin32|cygwin|mingw32|bccwin32/ =~ RUBY_PLATFORM
+      rm_f "conftest*"
+    end
+
+See also: {http://abstractplain.net/blog/?p=788}.

data/docs/report-installation-issue.md

@@ -0,0 +1,50 @@
+# @title Report Installation Issues
+
+Report Installation Issues
+==========================
+
+Look at {file:docs/platform-specific-issues.md} and [the issues page on github][github] to check whether your issue is fixed or not.
+
+If it is a new one, post the following information to [github][].
+
+[github]: https://github.com/kubo/ruby-oci8/issues
+
+*    Messages printed out to the console
+
+*    `gem_make.out` if you install a gem
+
+*    Last 100 lines of 'ext/oci8/mkmf.log'
+
+     Get them as follows.
+
+         tail -100 ext/oci8/mkmf.log
+
+*    The results of the following commands:
+
+         file `which ruby`
+         ruby --version
+         ruby -r rbconfig -e "p RbConfig::CONFIG['host']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['CC']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['CFLAGS']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['LDSHARED']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['LDFLAGS']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['DLDLAGS']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['LIBS']"
+         ruby -r rbconfig -e "p RbConfig::CONFIG['GNU_LD']"
+         
+         # if you use gcc,
+         gcc --print-prog-name=ld
+         gcc --print-prog-name=as
+         
+         # Oracle full client
+         file $ORACLE_HOME/bin/oracle
+         
+         # Oracle Instant client. You need to change INSTANT_CLIENT_DIRECTORY.
+         file INSTANT_CLIENT_DIRECTORY/libclntsh.*
+         
+         echo $LD_LIBRARY_PATH
+         echo $LIBPATH              # AIX
+         echo $SHLIB_PATH           # HP-UX PA-RISC 32-bit ruby
+         echo $DYLD_LIBRARY_PATH    # Mac OS X
+         echo $LD_LIBRARY_PATH_32   # Solaris 32-bit ruby
+         echo $LD_LIBRARY_PATH_64   # Solaris 64-bit ruby