SLOWCLOSE (JANUS DEFINE parameter): Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:SLOWCLOSE}} | {{DISPLAYTITLE:SLOWCLOSE}} | ||
<span class="pageSubtitle"><section begin="desc" />mask<section end="desc" /></span> | <span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask -- don't be hasty closing connections.<section end="desc" /></span> | ||
SLOWCLOSE is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | SLOWCLOSE is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | ||
| Line 11: | Line 11: | ||
While the default setting covers the known browser bug which only seems to occur on POSTs, SLOWCLOSE can be set to other values for other request types. These settings should only be necessary if browsers that send junk characters under other conditions are discovered: | While the default setting covers the known browser bug which only seems to occur on POSTs, SLOWCLOSE can be set to other values for other request types. These settings should only be necessary if browsers that send junk characters under other conditions are discovered: | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>X'02'</th> | <tr><th>X'02'</th> | ||
| Line 22: | Line 23: | ||
<tr><th>X'40'</th> | <tr><th>X'40'</th> | ||
<td>Slow close for a PUT that is followed by extra carriage-return and line-feed characters, whether the characters are read or not | <td>Slow close for a PUT that is followed by extra carriage-return and line-feed characters, whether the characters are read or not | ||
</td></tr></table> | </td></tr> | ||
</table> | |||
The SLOWCLOSE parameter is | The SLOWCLOSE parameter is available in ''[[Sirius Mods]]'' Version 6.0 and later. | ||
Valid only for WEBSERV ports. | Valid only for WEBSERV ports. | ||
Revision as of 15:00, 14 March 2011
<section begin="desc" />SLOWCLOSE mask -- don't be hasty closing connections.<section end="desc" />
SLOWCLOSE is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.
The SLOWCLOSE parameter is followed by a bitmask that indicates the conditions under which Janus Web Server is to perform a "slow" close of a connection with a browser.
This parameter is useful for dealing with a bug in some browsers that sends an extra, junk, carriage-return and line-feed character after the contents of an HTTP POST. If these two extra characters are sent by the browser, and Janus Web Server does not read them from TCP/IP (most of the time it will), then under certain conditions TCP/IP will discard outgoing data from Janus Web Server when a normal close is done on the socket. To prevent losing this data in this case, Janus Web Server must perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.
This parameter defaults to X'01': Janus Web Server will only perform "slow" close processing for a POST, and only when it has not already received an extra carriage-return and line-feed.
While the default setting covers the known browser bug which only seems to occur on POSTs, SLOWCLOSE can be set to other values for other request types. These settings should only be necessary if browsers that send junk characters under other conditions are discovered:
| X'02' | Slow close for a GET that is followed by extra carriage-return and line-feed characters that are not read by the Web Server |
|---|---|
| X'04' | Slow close for a PUT that is followed by extra carriage-return and line-feed characters that are not read |
| X'10' | Slow close for a POST that is followed by extra carriage-return and line-feed characters, whether the characters are read by the Server or not |
| X'20' | Slow close for a GET that is followed by extra carriage-return and line-feed characters, whether the characters are read or not |
| X'40' | Slow close for a PUT that is followed by extra carriage-return and line-feed characters, whether the characters are read or not |
The SLOWCLOSE parameter is available in Sirius Mods Version 6.0 and later.
Valid only for WEBSERV ports.
References
See: List of Janus commands | List of JANUS DEFINE parameters.