From bcf12ef8b6d4fcb4f9c12e2e43a004b9c28d063c Mon Sep 17 00:00:00 2001 From: pero Date: Fri, 18 May 2007 08:50:57 +0000 Subject: [PATCH] Add selectorTimeout default and a lot of value formatings. git-svn-id: https://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk@539322 13f79535-47bb-0310-9956-ffa450edef68 --- webapps/docs/config/http.xml | 64 ++++++++++++++++++++++---------------------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/webapps/docs/config/http.xml b/webapps/docs/config/http.xml index cd677f0eb..4d5afa2bd 100644 --- a/webapps/docs/config/http.xml +++ b/webapps/docs/config/http.xml @@ -378,7 +378,7 @@ Most of these attributes are directly linked to the socket implementation in the JDK so you can find out about the actual meaning in the JDK API documentation.
NoteOn some JDK versions, setTrafficClass causes a problem, a work around for this is to add - the -Djava.net.preferIPv4Stack=true value to your command line

+ the -Djava.net.preferIPv4Stack=true value to your command line

@@ -398,11 +398,11 @@

(int)The number of threads to be used to accept connections. Increase this value on a multi CPU machine, - although you would never really need more than 2. Also, with a lot of non keep alive connections, - you might want to increase this value as well. Default value is 1.

+ although you would never really need more than 2. Also, with a lot of non keep alive connections, + you might want to increase this value as well. Default value is 1.

 -

(int)The number of threads to be used to run for the polling events. Default value is 1. +

(int)The number of threads to be used to run for the polling events. Default value is 1. Can't see a reason to go above that. But experiment and find your own results.

 @@ -423,15 +423,15 @@

(int)The time in milliseconds to timeout on a select() for the poller. This value is important, since connection clean up is done on the same thread, so dont set this - value to an extremely high one.

+ value to an extremely high one. The default value is 1000 milliseconds.

 -

(bool)Whether to allow comet servlets or not, Default value is true.

+

(bool)Whether to allow comet servlets or not, Default value is true.

(int)The protocol handler caches Http11NioProcessor objects to speed up performance. This setting dictates how many of these objects get cached. - -1 means unlimited, default is 200. Set this value somewhere close to your maxThreads value. + -1 means unlimited, default is 200. Set this value somewhere close to your maxThreads value.

@@ -440,20 +440,20 @@ direct memory space. On Sun's JDK that would be something like -XX:MaxDirectMemorySize=256m

 -

(int)The socket receive buffer (SO_RCVBUF) size in bytes. Default value is 25188

+

(int)The socket receive buffer (SO_RCVBUF) size in bytes. Default value is 25188

 -

(int)The socket send buffer (SO_SNDBUF) size in bytes. Default value is 43800

+

(int)The socket send buffer (SO_SNDBUF) size in bytes. Default value is 43800

(int)Each connection that is opened up in Tomcat get associated with a read and a write ByteBuffer - This attribute controls the size of these buffers. By default this read buffer is sized at 8192 bytes. + This attribute controls the size of these buffers. By default this read buffer is sized at 8192 bytes. For lower concurrency, you can increase this to buffer more data. For an extreme amount of keep alive connections, decrease this number or increase your heap size.

(int)Each connection that is opened up in Tomcat get associated with a read and a write ByteBuffer - This attribute controls the size of these buffers. By default this write buffer is sized at 8192 bytes. + This attribute controls the size of these buffers. By default this write buffer is sized at 8192 bytes. For low concurrency you can increase this to buffer more response data. For an extreme amount of keep alive connections, decrease this number or increase your heap size.
@@ -464,36 +464,36 @@

(int)The Nio connector uses a class called NioChannel that holds elements linked to a socket. To reduce garbage collection, the Nio connector caches these channel objects. This value specifies the size of this cache. - The default value is 500, and represents that the cache will hold 500 NioChannel objects. - Other values are -1. unlimited cache, and 0, no cache.

+ The default value is 500, and represents that the cache will hold 500 NioChannel objects. + Other values are -1. unlimited cache, and 0, no cache.

(int)The NioChannel pool can also be size based, not used object based. The size is calculated as follows:
- NioChannel buffer size = read buffer size + write buffer size
- SecureNioChannel buffer size = application read buffer size + application write buffer size + network read buffer size + network write buffer size
- The value is in bytes, the default value is 1024*1024*100 (100MB) + NioChannel buffer size = read buffer size + write buffer size
+ SecureNioChannel buffer size = application read buffer size + application write buffer size + network read buffer size + network write buffer size
+ The value is in bytes, the default value is 1024*1024*100 (100MB)

(int)Tomcat will cache SocketProcessor objects to reduce garbage collection. The integer value specifies how many objects to keep in the cache at most. - The default is 500. - Other values are -1. unlimited cache, and 0, no cache.

+ The default is 500. + Other values are -1. unlimited cache, and 0, no cache.

(int)Tomcat will cache KeyAttachment objects to reduce garbage collection. The integer value specifies how many objects to keep in the cache at most. - The default is 500. - Other values are -1. unlimited cache, and 0, no cache.

+ The default is 500. + Other values are -1. unlimited cache, and 0, no cache.

(int)Tomcat will cache PollerEvent objects to reduce garbage collection. The integer value specifies how many objects to keep in the cache at most. - The default is 500. - Other values are -1. unlimited cache, and 0, no cache.

+ The default is 500. + Other values are -1. unlimited cache, and 0, no cache.

 -

(bool)same as the standard setting tcpNoDelay. Default value is false

+

(bool)same as the standard setting tcpNoDelay. Default value is false

(bool)Boolean value for the socket's keep alive setting (SO_KEEPALIVE). Default is false.

@@ -506,7 +506,7 @@

(bool)Boolean value for the sockets so linger option (SO_LINGER). Default value is true. - This option is paired with the soLingerTime value.

+ This option is paired with the soLingerTime value.

(bool)Value in seconds for the sockets so linger option (SO_LINGER). Default value is 25 seconds. @@ -516,27 +516,27 @@

(int)Value in milliseconds for the sockets read timeout (SO_TIMEOUT). Default value is 5000 milliseconds.

 -

(byte)Value between 0 and 255 for the traffic class on the socket, 0x04 | 0x08 | 0x010

+

(byte)Value between 0 and 255 for the traffic class on the socket, 0x04 | 0x08 | 0x010

 -

(int)The first value for the performance settings. Default is 1, see Socket Performance Options

+

(int)The first value for the performance settings. Default is 1, see Socket Performance Options

 -

(int)The second value for the performance settings. Default is 0, see Socket Performance Options

+

(int)The second value for the performance settings. Default is 0, see Socket Performance Options

 -

(int)The third value for the performance settings. Default is 1, see Socket Performance Options

+

(int)The third value for the performance settings. Default is 1, see Socket Performance Options

(int)The max selectors to be used in the pool, to reduce selector contention. - Use this option when the command line o.a.t.u.net.NioSelectorShared value is set to false. - Default value is 200.

+ Use this option when the command line org.apache.tomcat.util.net.NioSelectorShared value is set to false. + Default value is 200.

(int)The max spare selectors to be used in the pool, to reduce selector contention. When a selector is returned to the pool, the system can decide to keep it or let it be GC:ed. - Use this option when the command line o.a.t.u.net.NioSelectorShared value is set to false. - Default value is -1 (unlimited)

+ Use this option when the command line org.apache.tomcat.util.net.NioSelectorShared value is set to false. + Default value is -1 (unlimited)

The following command line options are available for the NIO connector:
-- 2.11.0