ruby-oci8 2.1.7-x86-mingw32 → 2.1.8-x86-mingw32

data/ChangeLog

@@ -1,3 +1,139 @@
+2015-04-04  Kubo Takehiro  <kubo@jiubao.org>
+	* NEWS: add changes between 2.1.7 and 2.1.8.
+	* VERSION: update to 2.1.8.
+	* dist-files: add new files.
+
+2015-04-04  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/extconf.rb, ext/oci8/oci8.h: Add a macro for old rubies which
+	    don't have rb_str_set_len().
+	* ext/oci8/hook_funcs.c: Suppress a warning.
+
+2015-04-04  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/lob.c: Increase the buffer size to read a LOB.
+
+2015-04-04  Kubo Takehiro  <kubo@jiubao.org>
+	* docs/install-instant-client.md, ext/oci8/lob.c, ext/oci8/metadata.c,
+	  ext/oci8/oci8.c: Update documents for YARD.
+
+2015-04-02  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/lob.c: Fix SEGV when a temporary LOB is freed by GC
+	    while reading another lob and the ruby version is 2.0.0 or
+	    upper.
+
+2015-03-01  Kubo Takehiro  <kubo@jiubao.org>
+	* lib/oci8/cursor.rb, lib/oci8/properties.rb:
+	    Fix errors while generating documents by yard such as
+	    "Exception occurred while generating 'OCI8/Cursor.html'."
+
+2015-03-01  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/oci8.c, ext/oci8/oci8.h: Rollback transactions on
+	    logoff only when the transactions are in progress.
+
+2015-01-27  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/ocihandle.c, ext/oci8/ocinumber.c, ext/oci8/oradate.c,
+	  ext/oci8/stmt.c: Suppreess warnings: "[warn]: @param tag has unknown parameter name: xxx"
+            by yard.
+
+2015-01-20  Kubo Takehiro  <kubo@jiubao.org>
+	* lib/oci8/oci8.rb: Add OCI8#send_timeout, OCI8#send_timeout=,
+	    OCI8#recv_timeout and OCI8#recv_timeout=.
+
+2015-01-20  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/hook_funcs.c, ext/oci8/oci8.c, ext/oci8/oci8.h:
+	    Fix for cancel_read_at_exit on Windows.
+
+2015-01-20  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/oci8.c, ext/oci8/oci8lib.c, lib/oci8/properties.rb:
+	    Add OCI8.properties[:cancel_read_at_exit].
+
+2015-01-20  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/extconf.rb, ext/oci8/hook_funcs.c, ext/oci8/oci8.c,
+	  ext/oci8/oci8.h, ext/oci8/oci8lib.c, ext/oci8/plthook.h,
+	  ext/oci8/plthook_elf.c, ext/oci8/plthook_osx.c,
+	  ext/oci8/plthook_win32.c: Cancel read system calls at exit
+	    not to block ruby process termination.
+	    This works on Linux, OSX and Windows Vista or upper.
+	    (github issue #56)
+
+2015-01-12  Kubo Takehiro  <kubo@jiubao.org>
+	* README.md: Fix a broken link.
+	    (github issue #67 reported by Zloy)
+
+2014-12-30  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/lob.c, ext/oci8/oci8lib.c: Revise type checking of LOB.
+
+2014-12-30  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/bind.c, ext/oci8/connection_pool.c, 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/ocihandle.c, ext/oci8/stmt.c:
+	    Add oci8_check_typeddata() and use it instead of oci8_get_handle()
+	    and oci8_get_bind().
+
+2014-12-30  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/oradate.c: Add check_oradate() to check datatype.
+
+2014-12-30  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/lob.c, ext/oci8/metadata.c, ext/oci8/object.c, ext/oci8/stmt.c:
+	    Add more write barriers.
+
+2014-12-29  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/bind.c, ext/oci8/connection_pool.c, 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/oradate.c, ext/oci8/stmt.c:
+	    Use rb_data_type_t as the base type of oci8_handle_data_type_t.
+
+2014-12-29  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/bind.c, ext/oci8/connection_pool.c, 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/oradate.c, ext/oci8/stmt.c:
+	    Rename vtable and vptr to data_type.
+
+2014-12-29  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/bind.c, ext/oci8/connection_pool.c, 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/oradate.c, ext/oci8/stmt.c:
+	    Add oci8_allocate_typeddata() and use it to allocate OCI objects.
+
+2014-12-23  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/connection_pool.c, ext/oci8/metadata.c, ext/oci8/object.c,
+	  ext/oci8/oci8.c, ext/oci8/oci8.h, ext/oci8/oci8lib.c, ext/oci8/ocihandle.c
+	  ext/oci8/ocinumber.c, ext/oci8/oradate.c, ext/oci8/stmt.c:
+	    Add write barriers to use generational GC.
+
+2014-12-23  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/oci8.h, ext/oci8/oci8lib.c, ext/oci8/ocihandle.c,
+	  ext/oci8/ocinumber.c, ext/oci8/oradate.c:
+	    Use TypedData on ruby 1.9.3 and later.
+
+2014-12-22  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/extconf.rb, ext/oci8/stmt.c: Don't use SYM2ID on ruby 2.2.0
+	    or later. Symbols passed to SYM2ID are not GC'ed.
+
+2014-12-21  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/bind.c, ext/oci8/object.c, ext/oci8/oci8.h, ext/oci8/oci8lib.c,
+	  ext/oci8/ocidatetime.c, ext/oci8/ocihandle.c, ext/oci8/ocinumber.c:
+	    Use RARRAY_AREF and RARRAY_CONST_PTR for Generational GC.
+
+2014-12-06  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/connection_pool.c, ext/oci8/lob.c, ext/oci8/oci8.c,
+	  ext/oci8/stmt.c: Fix "RuntimeError:executing in another thread"
+	    when a closed connection is used. This bug was introduced by
+	    the previous commit.
+	    (github issue #64 reported by Yasuo Honda)
+
+2014-11-16  Kubo Takehiro  <kubo@jiubao.org>
+	* ext/oci8/attr.c, ext/oci8/bind.c, ext/oci8/connection_pool.c,
+	  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/ocihandle.c, ext/oci8/stmt.c:
+	    Raises an exception when a closed OCI8 object is used.
+	    Using a closed cursor causes various problems such as segmentation
+	    fault, nil comparison error and so on.
+	    (github issue #61 and #62 reported by Mike Bourgeous)
+
 2014-02-02  Kubo Takehiro  <kubo@jiubao.org>
 	* NEWS: add changes between 2.1.7 and 2.1.6.
 	* VERSION: change the version to 2.1.7.

data/NEWS

@@ -1,5 +1,66 @@
 # @markup markdown
 
+2.1.8
+=====
+
+New Features
+------------
+
+### Send and receive timeouts
+
+New methods {OCI8#send_timeout}, {OCI8#send_timeout=}, {OCI8#recv_timeout} and {OCI8#recv_timeout=}
+were added. They are available on Oracle 11.1 or upper.
+
+Use them at your own risk because they use [undocumented OCI handle attributes](http://blog.jiubao.org/2015/01/undocumented-oci-handle-attributes.html).
+
+### Cancel read system calls not to prevent ruby process termination
+
+When network quality is poor and incoming packets are lost irregularly,
+the ruby process termination may be blocked until TCP keepalive time (2 hours).
+
+By setting [OCI8.properties[:cancel_read_at_exit]](OCI8.html#properties-class_method)
+true, read system calls, which may wait incoming packets, are canceled at exit.
+See: [github issue #56](https://github.com/kubo/ruby-oci8/issues/56)
+
+This feature is disabled by default because it uses [unusual technique](https://github.com/kubo/plthook)
+which hooks read system calls issued by Oracle client library and it works only on
+Linux, Windows and OSX.
+
+### RGenGC
+
+Object allocation code is rewritten to use [RGenGC](http://www.infoq.com/news/2013/12/ruby21).
+
+Fixed Issues
+------------
+
+-   Raises an exception when a closed OCI8 object is used.
+    Using a closed cursor causes various problems such as segmentation
+    fault, nil comparison error and so on.
+    See: [github issue #61](https://github.com/kubo/ruby-oci8/issues/61)
+    and [github issue #62](https://github.com/kubo/ruby-oci8/issues/62)
+
+    (reported by Mike Bourgeous)
+
+-   Fix "RuntimeError:executing in another thread"
+    when a closed connection is used. This bug was introduced by
+    the previously listed issue.
+    See: [github issue #64](https://github.com/kubo/ruby-oci8/issues/64)
+
+    (reported by Yasuo Honda)
+
+-   Fix SEGV when a temporary LOB is freed by GC while reading another
+    lob and the ruby version is 2.0.0 or upper.
+
+-   Skip rollback on logoff when no transactions are in progress.
+
+-   Fix a broken link in README.md.
+    See: [github issue #67](https://github.com/kubo/ruby-oci8/issues/67)
+
+    (reported by Zloy)
+
+-   Don't use SYM2ID on ruby 2.2.0 or later not to make symbols unGCable
+    by [Symbol GC](http://www.infoq.com/news/2014/12/ruby-2.2.0-released).
+
 2.1.7
 =====
 

data/README.md

@@ -21,10 +21,10 @@ Connect to scott/tiger, select `emp` and print as CSV format.
 
 If you install a ruby-oci8 gem package, you may need to add `-rubygems` before `-r oci8`.
 
-API Reference
+Documentation
 =============
 
-* http://rubydoc.info/gems/ruby-oci8/frames/file/README.md
+* http://rubydoc.info/gems/ruby-oci8/
 
 Installation
 ============

data/VERSION

@@ -1 +1 @@
-2.1.7
+2.1.8

data/dist-files

@@ -29,6 +29,7 @@ ext/oci8/encoding.c
 ext/oci8/env.c
 ext/oci8/error.c
 ext/oci8/extconf.rb
+ext/oci8/hook_funcs.c
 ext/oci8/lob.c
 ext/oci8/metadata.c
 ext/oci8/object.c
@@ -42,6 +43,10 @@ ext/oci8/oraconf.rb
 ext/oci8/oradate.c
 ext/oci8/oranumber_util.c
 ext/oci8/oranumber_util.h
+ext/oci8/plthook.h
+ext/oci8/plthook_elf.c
+ext/oci8/plthook_osx.c
+ext/oci8/plthook_win32.c
 ext/oci8/post-config.rb
 ext/oci8/stmt.c
 ext/oci8/thread_util.c

data/docs/install-instant-client.md

@@ -45,6 +45,8 @@ 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.
+* 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.

data/lib/oci8.rb

@@ -69,10 +69,10 @@ else
 end
 require so_basename
 
-if OCI8::VERSION != '2.1.7'
+if OCI8::VERSION != '2.1.8'
   require 'rbconfig'
   so_name = so_basename + "." + RbConfig::CONFIG['DLEXT']
-  raise "VERSION MISMATCH! #{so_name} version is #{OCI8::VERSION}, but oci8.rb version is 2.1.7."
+  raise "VERSION MISMATCH! #{so_name} version is #{OCI8::VERSION}, but oci8.rb version is 2.1.8."
 end
 
 require 'oci8/encoding-init.rb'

data/lib/oci8/cursor.rb

@@ -55,7 +55,7 @@ class OCI8
     # example:
     #   cursor = conn.parse("SELECT * FROM emp WHERE ename = :ename")
     #   cursor.bind_param(1, 'SMITH') # bind by position
-    #     ...or...
+    #   # ...or...
     #   cursor.bind_param(':ename', 'SMITH') # bind by name
     #
     # To bind as number, Fixnum and Float are available, but Bignum is

data/lib/oci8/oci8.rb

@@ -384,6 +384,77 @@ class OCI8
   def self.client_charset_name
     @@client_charset_name
   end
+
+  if OCI8.oracle_client_version >= OCI8::ORAVER_11_1
+    # Returns send timeout in seconds.
+    # Zero means no timeout.
+    # This is equivalent to {http://docs.oracle.com/database/121/NETRF/sqlnet.htm#NETRF228 SQLNET.SEND_TIMEOUT} in client-side sqlnet.ora.
+    #
+    # @return [Float] seconds
+    # @see #recv_timeout
+    # @since 2.1.8 and Oracle 11.1
+    def send_timeout
+      # OCI_ATTR_SEND_TIMEOUT = 435
+      @server_handle.send(:attr_get_ub4, 435).to_f / 1000
+    end
+
+    # Sets send timeout in seconds.
+    # Zero means no timeout.
+    # This is equivalent to {http://docs.oracle.com/database/121/NETRF/sqlnet.htm#NETRF228 SQLNET.SEND_TIMEOUT} in client-side sqlnet.ora.
+    #
+    # If you have trouble by setting this, don't use it because it uses
+    # {http://blog.jiubao.org/2015/01/undocumented-oci-handle-attributes.html an undocumented OCI handle attribute}.
+    #
+    # @param [Float] timeout
+    # @return [void]
+    # @see #recv_timeout=
+    # @since 2.1.8 and Oracle 11.1
+    def send_timeout=(timeout)
+      # OCI_ATTR_SEND_TIMEOUT = 435
+      @server_handle.send(:attr_set_ub4, 435, timeout * 1000)
+    end
+
+    # Returns receive timeout in seconds.
+    # Zero means no timeout.
+    # This is equivalent to {http://docs.oracle.com/database/121/NETRF/sqlnet.htm#NETRF227 SQLNET.RECV_TIMEOUT} in client-side sqlnet.ora.
+    #
+    # @return [Float] seconds
+    # @see #send_timeout
+    # @since 2.1.8 and Oracle 11.1
+    def recv_timeout
+      # OCI_ATTR_RECEIVE_TIMEOUT = 436
+      @server_handle.send(:attr_get_ub4, 436).to_f / 1000
+    end
+
+    # Sets receive timeout in seconds.
+    # Zero means no timeout.
+    # This is equivalent to {http://docs.oracle.com/database/121/NETRF/sqlnet.htm#NETRF227 SQLNET.RECV_TIMEOUT} in client-side sqlnet.ora.
+    #
+    # If you have trouble by setting this, don't use it because it uses
+    # {http://blog.jiubao.org/2015/01/undocumented-oci-handle-attributes.html an undocumented OCI handle attribute}.
+    #
+    # @param [Float] timeout
+    # @return [void]
+    # @see #send_timeout=
+    # @since 2.1.8 and Oracle 11.1
+    def recv_timeout=(timeout)
+      # OCI_ATTR_RECEIVE_TIMEOUT = 436
+      @server_handle.send(:attr_set_ub4, 436, timeout * 1000)
+    end
+  else
+    def send_timeout
+      raise NotImplementedError, 'send_timeout is unimplemented in this Oracle version'
+    end
+    def send_timeout=(timeout)
+      raise NotImplementedError, 'send_timeout= is unimplemented in this Oracle version'
+    end
+    def recv_timeout
+      raise NotImplementedError, 'recv_timeout is unimplemented in this Oracle version'
+    end
+    def recv_timeout=(timeout)
+      raise NotImplementedError, 'revc_timeout= is unimplemented in this Oracle version'
+    end
+  end
 end
 
 class OCIError

data/lib/oci8/properties.rb

@@ -1,6 +1,6 @@
 # properties.rb -- implements OCI8.properties
 #
-# Copyright (C) 2010-2013 KUBO Takehiro <kubo@jiubao.org>
+# Copyright (C) 2010-2015 Kubo Takehiro <kubo@jiubao.org>
 
 #
 class OCI8
@@ -11,7 +11,8 @@ class OCI8
     :bind_string_as_nchar => false,
     :float_conversion_type => OCI8.__get_prop(1) ? :ruby : :oracle,
     :statement_cache_size => 0,
-    :events_mode => ((OCI8.__get_prop(2) & 4) != 0) # 4 <- OCI_EVENTS in oci.h
+    :events_mode => ((OCI8.__get_prop(2) & 4) != 0), # 4 <- OCI_EVENTS in oci.h
+    :cancel_read_at_exit => false,
   }
 
   if OCI8.oracle_client_version < OCI8::ORAVER_9_2
@@ -56,6 +57,9 @@ class OCI8
       else
         OCI8.__set_prop(2, OCI8.__get_prop(2) & ~4) # unset OCI_EVENTS
       end
+    when :cancel_read_at_exit
+      val = val ? true : false
+      OCI8.__set_prop(3, val)
     end
     super(name, val)
   end
@@ -120,11 +124,22 @@ class OCI8
   #     
   #       require 'oci8'
   #       OCI8.properties[:events_mode] = true # works fine.
-  #       ... call some OCI methods ...
+  #       # ... call some OCI methods ...
   #       OCI8.properties[:events_mode] = true # raises a runtime error.
   #     
   #     *Since:* 2.1.4
   #
+  # [:cancel_read_at_exit]
+  #
+  #     +true+ when read system calls are canceled at exit. Otherwise, +false+.
+  #     The default value is +false+ because it uses unusual technique which
+  #     hooks read system calls issued by Oracle client library and it works
+  #     only on Linux, OSX and Windows.
+  #     This feature is added not to block ruby process termination when
+  #     network quality is poor and packets are lost irregularly.
+  #
+  #     *Since:* 2.1.8
+  #
   # @return [a customized Hash]
   # @since 2.0.5
   #

data/test/test_connection_pool.rb

@@ -105,7 +105,7 @@ class TestConnectionPool < Minitest::Test
     assert_equal(non_blocking ? max_cnt : min_cnt, pool.open_count, msg) # open_count doesn't shrink.
     assert_equal(0, pool.busy_count, msg)
     conns[0].ping # make a network roundtrip.
-    sleep(0.5)
+    sleep(1)
     # open_count shrinks.
     # The decrement count depends on Oracle version.
     assert_operator(pool.open_count, :<, max_cnt, msg)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-oci8
 version: !ruby/object:Gem::Version 
-  hash: 5
+  hash: 27
   prerelease: false
   segments: 
   - 2
   - 1
-  - 7
-  version: 2.1.7
+  - 8
+  version: 2.1.8
 platform: x86-mingw32
 authors: 
 - Kubo Takehiro
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2014-02-02 00:00:00 +09:00
+date: 2015-04-04 00:00:00 +09:00
 default_executable: 
 dependencies: []
 
@@ -90,6 +90,7 @@ files:
 - test/test_oradate.rb
 - test/test_oranumber.rb
 - test/test_rowid.rb
+- lib/oci8lib_220.so
 - lib/oci8lib_191.so
 - lib/oci8lib_200.so
 - lib/oci8lib_18.so