Author: trustin
Date: Mon Jan 29 18:14:38 2007
New Revision: 501293

URL: http://svn.apache.org/viewvc?view=rev&rev=501293
Log:
Related issue: DIRMINA-261 (ioSession.close().join() when SO_LINGERING set)
* Added JavaDoc comment that warns enabling SO_LINGER can result in platform 
dependent behavior and blocking in I/O thread


Modified:
    
mina/branches/1.0/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
    
mina/branches/1.1/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
    
mina/trunk/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java

Modified: 
mina/branches/1.0/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
URL: 
http://svn.apache.org/viewvc/mina/branches/1.0/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java?view=diff&rev=501293&r1=501292&r2=501293
==============================================================================
--- 
mina/branches/1.0/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
 (original)
+++ 
mina/branches/1.0/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
 Mon Jan 29 18:14:38 2007
@@ -92,14 +92,22 @@
     void setOobInline( boolean oobInline );
 
     /**
+     * Please note that enabling <tt>SO_LINGER</tt> in Java NIO can result
+     * in platform-dependent behavior and unexpected blocking of I/O thread.
+     * 
      * @see Socket#getSoLinger()
+     * @see <a 
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6179351";>Sun Bug 
Database</a>
      */
     int getSoLinger();
 
     /**
+     * Please note that enabling <tt>SO_LINGER</tt> in Java NIO will result
+     * in platform-dependent behavior and unexpected blocking of I/O thread.
+     * 
      * @param soLinger Please specify a negative value to disable 
<tt>SO_LINGER</tt>.
      * 
      * @see Socket#setSoLinger(boolean, int)
+     * @see <a 
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6179351";>Sun Bug 
Database</a>
      */
     void setSoLinger( int soLinger );
 

Modified: 
mina/branches/1.1/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
URL: 
http://svn.apache.org/viewvc/mina/branches/1.1/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java?view=diff&rev=501293&r1=501292&r2=501293
==============================================================================
--- 
mina/branches/1.1/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
 (original)
+++ 
mina/branches/1.1/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
 Mon Jan 29 18:14:38 2007
@@ -92,14 +92,22 @@
     void setOobInline( boolean oobInline );
 
     /**
+     * Please note that enabling <tt>SO_LINGER</tt> in Java NIO can result
+     * in platform-dependent behavior and unexpected blocking of I/O thread.
+     * 
      * @see Socket#getSoLinger()
+     * @see <a 
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6179351";>Sun Bug 
Database</a>
      */
     int getSoLinger();
 
     /**
+     * Please note that enabling <tt>SO_LINGER</tt> in Java NIO can result
+     * in platform-dependent behavior and unexpected blocking of I/O thread.
+     * 
      * @param soLinger Please specify a negative value to disable 
<tt>SO_LINGER</tt>.
      * 
      * @see Socket#setSoLinger(boolean, int)
+     * @see <a 
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6179351";>Sun Bug 
Database</a>
      */
     void setSoLinger( int soLinger );
 

Modified: 
mina/trunk/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
URL: 
http://svn.apache.org/viewvc/mina/trunk/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java?view=diff&rev=501293&r1=501292&r2=501293
==============================================================================
--- 
mina/trunk/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
 (original)
+++ 
mina/trunk/core/src/main/java/org/apache/mina/transport/socket/nio/SocketSessionConfig.java
 Mon Jan 29 18:14:38 2007
@@ -92,14 +92,22 @@
     void setOobInline( boolean oobInline );
 
     /**
+     * Please note that enabling <tt>SO_LINGER</tt> in Java NIO can result
+     * in platform-dependent behavior and unexpected blocking of I/O thread.
+     * 
      * @see Socket#getSoLinger()
+     * @see <a 
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6179351";>Sun Bug 
Database</a>
      */
     int getSoLinger();
 
     /**
+     * Please note that enabling <tt>SO_LINGER</tt> in Java NIO can result
+     * in platform-dependent behavior and unexpected blocking of I/O thread.
+     * 
      * @param soLinger Please specify a negative value to disable 
<tt>SO_LINGER</tt>.
      * 
      * @see Socket#setSoLinger(boolean, int)
+     * @see <a 
href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6179351";>Sun Bug 
Database</a>
      */
     void setSoLinger( int soLinger );
 


Reply via email to