ruby-oci8 2.1.5.1-x64-mingw32

data/README.md

@@ -0,0 +1,43 @@
+What is ruby-oci8
+=================
+
+Ruby-oci8 is a ruby interface for Oracle Database. The latest version
+is available for all Oracle versions after Oracle 9i including Oracle
+Instant Client.
+
+If you need to use Oracle 8, use ruby-oci8 2.0.6.
+
+What's new
+==========
+
+See {file:NEWS}.
+
+Sample one-liner
+================
+
+Connect to scott/tiger, select `emp` and print as CSV format.
+
+    ruby -r oci8 -e "OCI8.new('scott', 'tiger').exec('select * from emp') do |r| puts r.join(','); end"
+
+If you install a ruby-oci8 gem package, you may need to add `-rubygems` before `-r oci8`.
+
+Documantation
+=============
+
+* [Reference Manual](http://ruby-oci8.rubyforge.org/en/)
+* {file:docs/install-full-client.md}
+* {file:docs/install-instant-client.md}
+* {file:docs/install-binary-package.md}
+
+Report issues
+=============
+
+* {file:docs/report-installation-issue.md}
+* [The issues page on github](https://github.com/kubo/ruby-oci8/issues)
+* [The ruby-oci8 help forum on rubyforge](http://rubyforge.org/forum/forum.php?forum_id=1078)
+
+License
+=======
+
+* {file:COPYING 2-clause BSD-style license} from ruby-oci8 2.1.3
+* {file:COPYING_old old Ruby license} until 2.1.2

data/VERSION

@@ -0,0 +1 @@
+2.1.5.1

data/dist-files

@@ -0,0 +1,91 @@
+.yardopts
+COPYING
+COPYING_old
+ChangeLog
+Makefile
+NEWS
+README.md
+VERSION
+dist-files
+metaconfig
+pre-distclean.rb
+ruby-oci8.gemspec
+setup.rb
+docs/install-binary-package.md
+docs/install-full-client.md
+docs/install-instant-client.md
+docs/platform-specific-issues.md
+docs/report-installation-issue.md
+ext/oci8/.document
+ext/oci8/MANIFEST
+ext/oci8/apiwrap.c.tmpl
+ext/oci8/apiwrap.h.tmpl
+ext/oci8/apiwrap.rb
+ext/oci8/apiwrap.yml
+ext/oci8/attr.c
+ext/oci8/bind.c
+ext/oci8/connection_pool.c
+ext/oci8/encoding.c
+ext/oci8/env.c
+ext/oci8/error.c
+ext/oci8/extconf.rb
+ext/oci8/lob.c
+ext/oci8/metadata.c
+ext/oci8/object.c
+ext/oci8/oci8.c
+ext/oci8/oci8.h
+ext/oci8/oci8lib.c
+ext/oci8/ocidatetime.c
+ext/oci8/ocihandle.c
+ext/oci8/ocinumber.c
+ext/oci8/oraconf.rb
+ext/oci8/oradate.c
+ext/oci8/oranumber_util.c
+ext/oci8/oranumber_util.h
+ext/oci8/post-config.rb
+ext/oci8/stmt.c
+ext/oci8/thread_util.c
+ext/oci8/thread_util.h
+ext/oci8/win32.c
+lib/.document
+lib/oci8.rb.in
+lib/dbd/OCI8.rb
+lib/oci8/.document
+lib/oci8/bindtype.rb
+lib/oci8/compat.rb
+lib/oci8/connection_pool.rb
+lib/oci8/cursor.rb
+lib/oci8/datetime.rb
+lib/oci8/encoding-init.rb
+lib/oci8/encoding.yml
+lib/oci8/metadata.rb
+lib/oci8/object.rb
+lib/oci8/oci8.rb
+lib/oci8/ocihandle.rb
+lib/oci8/oracle_version.rb
+lib/oci8/properties.rb
+test/README
+test/config.rb
+test/setup_test_object.sql
+test/test_all.rb
+test/test_appinfo.rb
+test/test_array_dml.rb
+test/test_bind_raw.rb
+test/test_bind_string.rb
+test/test_bind_time.rb
+test/test_break.rb
+test/test_clob.rb
+test/test_connection_pool.rb
+test/test_connstr.rb
+test/test_encoding.rb
+test/test_datetime.rb
+test/test_dbi.rb
+test/test_dbi_clob.rb
+test/test_error.rb
+test/test_metadata.rb
+test/test_object.rb
+test/test_oci8.rb
+test/test_oracle_version.rb
+test/test_oradate.rb
+test/test_oranumber.rb
+test/test_rowid.rb

data/docs/install-binary-package.md

@@ -0,0 +1,40 @@
+# @title Install Binary Package
+
+Windows 32-bit (mingw32 ruby)
+=============================
+
+Run the following command:
+
+    gem install ruby-oci8
+
+Windows 32-bit (mswin32 ruby)
+=============================
+
+Run the following command:
+
+    gem install --platform x86-mingw32 ruby-oci8
+
+Ruby-oci8 gem for x86-mingw32 works on mswin32 ruby.
+If it doesn't work, see {file:docs/install-instant-client.md} or {file:docs/install-full-client.md}.
+
+Other platforms
+===============
+
+We doesn't make binary gems for other platforms.
+If you need to distribute a binary gem, compile ruby-oci8 and run the following command.
+
+    gem build ruby-oci8.gemspec -- current
+
+Note that you need to compile it on the oldest versions of the platform you support
+and for the oldest versions of the Oracle databases.
+
+If you could not fix the Oracle versions, compile ruby-oci8 and make a gem as follows:
+
+    gzip -dc ruby-oci8-VERSION.tar.gz | tar xvf -
+    cd ruby-oci8-VERSION
+    ruby setup.rb config -- --with-runtime-check
+    make
+    gem build ruby-oci8.gemspec -- current
+
+When the option `--with-runtime-check` is set, ruby-oci8 checks the Oracle version
+and available OCI functions at runtime.

data/docs/install-full-client.md

@@ -0,0 +1,116 @@
+# @title Install for Oracle Full Client
+
+Introduction
+============
+
+This page explains the way to install ruby-oci8 for Oracle Full Client
+installations.
+
+For Oracle Instant Client, look at {file:docs/install-instant-client.md}.
+For Windows, look at {file:docs/install-binary-package.md} unless you
+have a special need to compile ruby-oci8 by yourself.
+
+Check the environment
+=====================
+
+Oracle installation
+-------------------
+
+Run the following command and confirm it works fine. If it doesn't
+work well, you need to ask to your database administrator.
+
+    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}.
+
+Set the library search path
+---------------------------
+
+### UNIX
+
+Set the library search path, whose name depends on the OS, to point to
+$ORACLE\_HOME/lib. If the database is 64-bit and the ruby is 32-bit,
+use $ORACLE\_HOME/lib32 instead.
+
+<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> Mac OS X                  </td><td> DYLD_LIBRARY_PATH                     </td></tr>
+  <tr><td> AIX                       </td><td> LIBPATH                               </td></tr>
+</tbody>
+</table>
+
+Do not forget to export the variable as follows:
+
+    $ LD_LIBRARY_PATH=$ORACLE_HOME/lib
+    $ export LD_LIBRARY_PATH
+
+### Windows(mswin32, mingw32, cygwin)
+
+If sqlplus runs correctly, library search path has no problem.
+
+gem package
+-----------
+
+Run the following command.
+
+    gem install ruby-oci8
+
+tar.gz package
+--------------
+
+### Download the source code
+
+Download the latest tar.gz package such as ruby-oci8 2.1.0.tar.gz,
+which is the latest version at the time of writing, from [rubyforge][].
+
+### 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
+
+[rubyforge]: http://rubyforge.org/frs/?group_id=256

data/docs/install-instant-client.md

@@ -0,0 +1,167 @@
+# @title Install for Oracle Instant Client
+
+Introduction
+============
+
+This page explains the way to install ruby-oci8 for Oracle Instant Client.
+
+For Oracle Full Client, look at {file:docs/install-full-client.md}.
+For Windows, look at {file:docs/install-binary-package.md} unless you
+have a special need to compile ruby-oci8 by yourself.
+
+Install Oracle Instant Client Packages
+======================================
+
+Donwload 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/instantclient10_1/libclntsh.so is not found, make
+a symbolic link to link the library.
+
+    cd /opt/oracle/instantclient10_1
+    ln -s libclntsh.so.10.1 libclntsh.so
+
+Note:
+
+* use libclntsh.sl instead of libclntsh.so on HP-UX PA-RISC.
+* use libclntsh.dylib instead of libclntsh.so on Mac OS X.
+* skip this step for AIX.
+
+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> Mac OS X                  </td><td> DYLD_LIBRARY_PATH                     </td></tr>
+  <tr><td> AIX                       </td><td> LIBPATH                               </td></tr>
+</tbody>
+</table>
+
+For example:
+    $ LD_LIBRARY_PATH=/opt/oracle/instantclient_10_2
+    $ export LD_LIBRARY_PATH
+
+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/10.2.0.3/client/lib
+    $ export LD_LIBRARY_PATH
+
+Windows
+-------
+
+Unzip the packages and set PATH to point to the directory where OCI.DLL is installed.
+
+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 such as ruby-oci8 2.1.0.tar.gz,
+which is the latest version at the time of writing, from [rubyforge][].
+
+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
+
+[rubyforge]: http://rubyforge.org/frs/?group_id=256