SLOWCLOSE (JANUS DEFINE parameter)

From m204wiki
Revision as of 16:02, 8 March 2011 by 198.242.244.47 (talk) (Created page with "{{DISPLAYTITLE:SLOWCLOSE}} <span class="pageSubtitle"><section begin="desc" />mask<section end="desc" /></span> SLOWCLOSE is a parameter on JANUS DEFINE, which defines and s...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

<section begin="desc" />mask<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 only 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.