ruby-oci8 2.2.4-x86-mingw32 → 2.2.4.1-x86-mingw32

data/ChangeLog

@@ -1,6 +1,21 @@
+2017-06-17  Kubo Takehiro <kubo@jiubao.org>
+	* NEWS: Add changes between 2.2.4 and 2.2.4.1
+	* lib/oci8/version.rb: Update to 2.2.4.1
+	* lib/oci8/version.rb: Fix URL links
+	* docs/hanging-after-inactivity.md: Revised
+
+2017-06-16  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/extconf.rb, ext/oci8/hook_funcs.c, ext/oci8/oci8lib.c:
+	    Fix to pass compilation on cygwin.
+	* mkpkg-win32.rb: Add tests on cygwin.
+
+2017-06-16  Kubo Takehiro <kubo@jiubao.org>
+	* ext/oci8/hook_funcs.c: Fix the calling convention of setsockopt
+	    on Windows x86.
+
 2017-06-11  Kubo Takehiro <kubo@jiubao.org>
 	* NEWS: Add changes between 2.2.3 and 2.2.4.
-	* lib/oci8/version.rb: update to 2.2.3.
+	* lib/oci8/version.rb: update to 2.2.4.
 	* docs/ldap-auth-and-function-interposition.md,
 	  docs/hanging-after-inactivity.md: updated
 

data/NEWS

@@ -1,5 +1,20 @@
 # @markup markdown
 
+2.2.4.1
+=======
+
+Fixed issue
+-----------
+
+### Fix invalid function calls when TCP keepalive time parameter is set on Windows x86
+
+When TCP keepalive time parameter is set, The win32 API `setsockopt` was hooked
+with incorrect calling convention on Windows x86. As far as I checked it doesn't
+cause bad effects. But it is by chance. If the code in `oci.dll` is optimized
+differently, it may cause unexpected behavior.
+
+### Fix compilation errors in 2.2.4 on cygwin
+
 2.2.4
 =====
 

data/docs/hanging-after-inactivity.md

@@ -6,13 +6,13 @@ Hanging After a Long Period of Inactivity
 When a database connection hangs after a long period of inactivity,
 this document may help you.
 
-When a firewall resides between Oracle database server and client, the
-firewall sometimes drops inactive connections as dead ones. If a
+When a firewall or a NAT proxy resides between Oracle database server
+and client, it sometimes drops inactive connections as dead ones. If a
 client connects to an Oracle server and tries to use the connection
-after a long sleep (> 1 hour), the client may hang due to the
+after a long sleep (> 1 hour), the client may hang in an effort to use the
 dropped connection. This issue will be solved by setting TCP keepalive
 packets whose keepalive time parameter is smaller than the inactive
-connection timeout in the firewall.
+connection timeout.
 
 TCP keepalive is enabled by [(ENABLE=broken)][] in a connect
 descriptor. If you use easy connect naming such as `//hostname/service_name`,
@@ -28,28 +28,29 @@ This is equivalent to the following:
     conn = OCI8.new(username, password, connect_descriptor)
 
 The default TCP keepalive time is two hours, which may be larger
-than the inactive connection timeout in the firewall. The default
+than the inactive connection timeout. The default
 value in the system is configurable via [procfs and sysctl on Linux][]
 or [registry parameters on Windows][]. If you have no privilege to
-customize the system, you can change it in an application layer
-by the tcp_keepalive_time property.
+customize the system, you can change per-connection keepalive time
+by the `tcp_keepalive_time` property.
 
     OCI8.properties[:tcp_keepalive_time] = 600 # 10 minutes
 
-`OCI8.properties[:tcp_keepalive_time]` is supported on the following
-platforms since ruby-oci8 2.2.4.
+It is supported on the following platforms since ruby-oci8 2.2.4.
 
 * Linux i386 and x86_64
 * macOS
 * Windows x86 and x64
 * Solaris x86_64
 
+When it is set on unsupported platforms, you get `NotImplementedError`.
+
 This feature is implemented with hackish way. When
 `tcp_keepalive_time` is set, Oracle client library's
 procedure linkage table is modified to intercept [setsockopt][] system
-calls. When Oracle client library issues a system call which enables
-TCP keepalive, ruby-oci8 changes the TCP keepalive time of the
-connection immediately after the system call.
+call. When Oracle client library issues the system call which enables
+TCP keepalive, [ruby-oci8 changes][] the per-connection TCP keepalive time
+immediately.
 
 I hope that Oracle adds a new OCI handle attribute to support this
 feature natively in the future.
@@ -59,3 +60,4 @@ feature natively in the future.
 [registry parameters on Windows]: https://blogs.technet.microsoft.com/nettracer/2010/06/03/things-that-you-may-want-to-know-about-tcp-keepalives/
 [plthook]: https://github.com/kubo/plthook
 [setsockopt]: http://pubs.opengroup.org/onlinepubs/9699919799/functions/setsockopt.html
+[ruby-oci8 changes]: https://github.com/kubo/ruby-oci8/blob/ruby-oci8-2.2.4/ext/oci8/hook_funcs.c#L302-L318

data/lib/oci8/properties.rb

@@ -177,13 +177,13 @@ class OCI8
   #
   # [:tcp_keepalive]
   #
-  #     See {file:docs/hanging-after-inactivity.md.md}
+  #     See {file:docs/hanging-after-inactivity.md}
   #
   #     *Since:* 2.2.4
   #
   # [:tcp_keepalive_time]
   #
-  #     See {file:docs/hanging-after-inactivity.md.md}
+  #     See {file:docs/hanging-after-inactivity.md}
   #
   #     *Since:* 2.2.4
   #

data/lib/oci8/version.rb

@@ -1,3 +1,3 @@
 class OCI8
-  VERSION = "2.2.4"
+  VERSION = "2.2.4.1"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-oci8
 version: !ruby/object:Gem::Version 
-  hash: 15
+  hash: 109
   prerelease: false
   segments: 
   - 2
   - 2
   - 4
-  version: 2.2.4
+  - 1
+  version: 2.2.4.1
 platform: x86-mingw32
 authors: 
 - Kubo Takehiro
@@ -15,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2017-06-11 00:00:00 +09:00
+date: 2017-06-17 00:00:00 +09:00
 default_executable: 
 dependencies: []