SLOWCLOSE (JANUS DEFINE parameter) - Revision history

JAL: wordsmithing

2017-03-15T16:45:23Z

wordsmithing

← Older revision		Revision as of 16:45, 15 March 2017
Line 6:		Line 6:

	==Description==		==Description==
	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 (nowadays they almost certainly ~~aren't~~)~~, and~~ <var class="product">Janus Web Server</var> has not read ~~them~~ from TCP/IP (~~back~~ when this used to happen ~~most of~~ the ~~time they~~ would be in the data Janus has already read) ~~Janus has no way of knowing if these junk characters follow. And, if that's the case (~~this probably just ~~doesn't~~ happen anymore~~) then~~ under certain conditions TCP/IP ~~will~~ discard outgoing data from <var class="product">Janus Web Server</var> when a normal close is done on the socket. To prevent ~~losing~~ this data ~~in this case~~, <var class="product">Janus Web Server</var> ~~must~~ perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.		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.

			This is the problematic scenario <var>SLOWCLOSE</var> is designed for. If both of the following are true, then Janus has no way of knowing if these junk characters follow:
			<ul>
			<li>The two extra characters are sent by the browser (nowadays they almost certainly are <i>not</i>) </li>

			<li><var class="product">Janus Web Server</var> has not read the characters from TCP/IP (when this used to happen, the characters would usually be in the data Janus has already read) </li>
			</ul>
			Although this scenario probably just does not happen anymore, under certain conditions when it did in the past TCP/IP might discard outgoing data from <var class="product">Janus Web Server</var> when a normal close was done on the socket.

			To prevent this rare loss of data, <var class="product">Janus Web Server</var> can perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.

	This parameter defaults to <code>X'01'</code>. However:		This parameter defaults to <code>X'01'</code>. However:

Alex: /* Description */

2017-03-15T14:38:55Z

Description

← Older revision		Revision as of 14:38, 15 March 2017
Line 6:		Line 6:

	==Description==		==Description==
	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 <var class="product">Janus Web Server</var> ~~does~~ not read them from TCP/IP (most of the time ~~it will~~), then under certain conditions TCP/IP will discard outgoing data from <var class="product">Janus Web Server</var> when a normal close is done on the socket. To prevent losing this data in this case, <var class="product">Janus Web Server</var> must perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.		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 (nowadays they almost certainly aren't), and <var class="product">Janus Web Server</var> has not read them from TCP/IP (back when this used to happen most of the time they would be in the data Janus has already read) Janus has no way of knowing if these junk characters follow. And, if that's the case (this probably just doesn't happen anymore) then under certain conditions TCP/IP will discard outgoing data from <var class="product">Janus Web Server</var> when a normal close is done on the socket. To prevent losing this data in this case, <var class="product">Janus Web Server</var> must perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.

	This parameter defaults to <code>X'01'</code>. However:		This parameter defaults to <code>X'01'</code>. However:

	<p class="note"><b>Note:</b> With the passage of time, <var>SLOWCLOSE</var> processing has ~~probably~~ become an anachronism, and setting it to 0 on Janus Web ports is recommended. </p>		<p class="note"><b>Note:</b> With the passage of time, <var>SLOWCLOSE</var> processing has become an anachronism, and setting it to 0 on Janus Web ports is recommended.</p>

	While the default setting covers the known browser bug which only seems to occur on POSTs, <var>SLOWCLOSE</var> 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, <var>SLOWCLOSE</var> 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:
Line 17:		Line 17:
	<tr class="head"><th>Bit</th><th>Meaning</th>		<tr class="head"><th>Bit</th><th>Meaning</th>
	<tr><th>X'01'</th>		<tr><th>X'01'</th>
	<td>Perform "slow" close processing for a POST, and only ~~when~~ Janus Web has not already received an extra carriage-return and line-feed. This is the default value. </td></tr>		<td>Perform "slow" close processing for a POST, if and only if Janus Web has not already received an extra carriage-return and line-feed. This is the default value. </td></tr>

	<tr><th>X'02'</th>		<tr><th>X'02'</th>
	<td>~~Slow~~ close for a GET ~~that is followed by~~ extra carriage-return and line-feed ~~characters that are '''not''' read by the Web Server~~.</td></tr>		<td>Perform "slow" close processing for a GET, if and only if Janus Web has not already received an extra carriage-return and line-feed.</td></tr>

	<tr><th>X'04'</th>		<tr><th>X'04'</th>
	<td>~~Slow~~ close for a PUT ~~that is followed by~~ extra carriage-return and line-feed ~~characters that are '''not''' read~~.</td></tr>		<td>Perform "slow" close processing for a PUT, if and only if Janus Web has not already received an extra carriage-return and line-feed.</td></tr>

	<tr><th>X'10'</th>		<tr><th>X'10'</th>
	<td>~~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~~.</td></tr>		<td>Always do a slow close for a POST.</td></tr>

	<tr><th>X'20'</th>		<tr><th>X'20'</th>
	<td>~~Slow~~ close for a GET ~~that is followed by extra carriage-return and line-feed characters, whether the characters are read or not~~.</td></tr>		<td>Always do a slow close for a GET.</td></tr>

	<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>Always do a slow close for a PUT.
	</td></tr>		</td></tr>
	</table>		</table>

JAL: minor formatting

2016-10-04T16:35:59Z

minor formatting

← Older revision		Revision as of 16:35, 4 October 2016
Line 17:		Line 17:
	<tr class="head"><th>Bit</th><th>Meaning</th>		<tr class="head"><th>Bit</th><th>Meaning</th>
	<tr><th>X'01'</th>		<tr><th>X'01'</th>
	<td>Perform "slow" close processing for a POST, and only when it has not already received an extra carriage-return and line-feed. This is the default value. </td></tr>		<td>Perform "slow" close processing for a POST, and only when Janus Web has not already received an extra carriage-return and line-feed. This is the default value. </td></tr>

	<tr><th>X'02'</th>		<tr><th>X'02'</th>
	<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters that are '''not''' read by the Web Server</td></tr>		<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters that are '''not''' read by the Web Server.</td></tr>

	<tr><th>X'04'</th>		<tr><th>X'04'</th>
	<td>Slow close for a PUT that is followed by extra carriage-return and line-feed characters that are '''not''' read</td></tr>		<td>Slow close for a PUT that is followed by extra carriage-return and line-feed characters that are '''not''' read.</td></tr>

	<tr><th>X'10'</th>		<tr><th>X'10'</th>
	<td>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</td></tr>		<td>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.</td></tr>

	<tr><th>X'20'</th>		<tr><th>X'20'</th>
	<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters, whether the characters are read or not</td></tr>		<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters, whether the characters are read or not.</td></tr>

	<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>		</td></tr>
	</table>		</table>

JAL: add note re "set to 0"

2016-10-04T15:36:14Z

add note re "set to 0"

← Older revision		Revision as of 15:36, 4 October 2016
Line 5:		Line 5:
	The <var>SLOWCLOSE</var> parameter is followed by a bitmask that indicates the conditions under which <var class="product">[[Janus Web Server]]</var> is to perform a "slow" close of a connection with a browser.		The <var>SLOWCLOSE</var> parameter is followed by a bitmask that indicates the conditions under which <var class="product">[[Janus Web Server]]</var> is to perform a "slow" close of a connection with a browser.

			==Description==
	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 <var class="product">Janus Web Server</var> does not read them from TCP/IP (most of the time it will), then under certain conditions TCP/IP will discard outgoing data from <var class="product">Janus Web Server</var> when a normal close is done on the socket. To prevent losing this data in this case, <var class="product">Janus Web Server</var> must perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.		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 <var class="product">Janus Web Server</var> does not read them from TCP/IP (most of the time it will), then under certain conditions TCP/IP will discard outgoing data from <var class="product">Janus Web Server</var> when a normal close is done on the socket. To prevent losing this data in this case, <var class="product">Janus Web Server</var> must perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.

	This parameter defaults to <code>X'01'</code>: <~~var~~ class="~~product~~">~~Janus Web Server~~</var> ~~will only perform "slow" close~~ processing ~~for a POST~~, and ~~only when~~ it ~~has not already received an extra carriage-return and line-feed~~.		This parameter defaults to <code>X'01'</code>. However:

			<p class="note"><b>Note:</b> With the passage of time, <var>SLOWCLOSE</var> processing has probably become an anachronism, and setting it to 0 on Janus Web ports is recommended. </p>

	While the default setting covers the known browser bug which only seems to occur on POSTs, <var>SLOWCLOSE</var> 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, <var>SLOWCLOSE</var> 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="thJustBold">		<table class="thJustBold">
			<tr class="head"><th>Bit</th><th>Meaning</th>
			<tr><th>X'01'</th>
			<td>Perform "slow" close processing for a POST, and only when it has not already received an extra carriage-return and line-feed. This is the default value. </td></tr>

	<tr><th>X'02'</th>		<tr><th>X'02'</th>
	<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters that are '''not''' read by the Web Server</td></tr>		<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters that are '''not''' read by the Web Server</td></tr>

JAL: minor formatting

2016-10-04T15:10:14Z

minor formatting

← Older revision		Revision as of 15:10, 4 October 2016
Line 11:		Line 11:
	While the default setting covers the known browser bug which only seems to occur on POSTs, <var>SLOWCLOSE</var> 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, <var>SLOWCLOSE</var> 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="~~list~~">		<table class="thJustBold">
	<tr><th>X'02'</th>		<tr><th>X'02'</th>
	<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters that are '''not''' read by the Web Server</td></tr>		<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters that are '''not''' read by the Web Server</td></tr>

	<tr><th>X'04'</th>		<tr><th>X'04'</th>
	<td>Slow close for a PUT that is followed by extra carriage-return and line-feed characters that are '''not''' read</td></tr>		<td>Slow close for a PUT that is followed by extra carriage-return and line-feed characters that are '''not''' read</td></tr>

	<tr><th>X'10'</th>		<tr><th>X'10'</th>
	<td>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</td></tr>		<td>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</td></tr>

	<tr><th>X'20'</th>		<tr><th>X'20'</th>
	<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters, whether the characters are read or not</td></tr>		<td>Slow close for a GET that is followed by extra carriage-return and line-feed characters, whether the characters are read or not</td></tr>

	<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

JALWiccan: Automatically generated page update

2013-04-16T22:24:00Z

Automatically generated page update

← Older revision		Revision as of 22:24, 16 April 2013
Line 1:		Line 1:
	<span class="pageSubtitle"~~><section begin="desc" /~~>SLOWCLOSE mask — Don't be hasty closing connections~~<section end="desc" />~~</span>		<span class="pageSubtitle">SLOWCLOSE mask — Don't be hasty closing connections</span>

	<var>SLOWCLOSE</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.		<var>SLOWCLOSE</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.

JAL2 at 18:21, 1 March 2012

2012-03-01T18:21:57Z

← Older revision		Revision as of 18:21, 1 March 2012
Line 1:		Line 1:
	~~{{DISPLAYTITLE:SLOWCLOSE}}~~
	<span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask — Don't be hasty closing connections<section end="desc" /></span>		<span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask — Don't be hasty closing connections<section end="desc" /></span>

	<var>SLOWCLOSE</var> is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port.		<var>SLOWCLOSE</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.

	The <var>SLOWCLOSE</var> 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.		The <var>SLOWCLOSE</var> parameter is followed by a bitmask that indicates the conditions under which <var class="product">[[Janus Web Server]]</var> 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 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 <var class="product">Janus Web Server</var> does not read them from TCP/IP (most of the time it will), then under certain conditions TCP/IP will discard outgoing data from <var class="product">Janus Web Server</var> when a normal close is done on the socket. To prevent losing this data in this case, <var class="product">Janus Web Server</var> must perform a more complex and so "slower" and, not incidentally, more expensive close for the connection.

	This parameter defaults to <code>X'01'</code>: ''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.		This parameter defaults to <code>X'01'</code>: <var class="product">Janus Web Server</var> 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, <var>SLOWCLOSE</var> 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, <var>SLOWCLOSE</var> 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:

JAL2 at 23:16, 29 February 2012

2012-02-29T23:16:48Z

← Older revision		Revision as of 23:16, 29 February 2012
Line 1:		Line 1:
	{{DISPLAYTITLE:SLOWCLOSE}}		{{DISPLAYTITLE:SLOWCLOSE}}
	<span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask — ~~don~~'t be hasty closing connections<section end="desc" /></span>		<span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask — Don't be hasty closing connections<section end="desc" /></span>

	<var>SLOWCLOSE</var> is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port.		<var>SLOWCLOSE</var> is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port.

JAL2 at 23:15, 29 February 2012

2012-02-29T23:15:59Z

← Older revision		Revision as of 23:15, 29 February 2012
Line 1:		Line 1:
	{{DISPLAYTITLE:SLOWCLOSE}}		{{DISPLAYTITLE:SLOWCLOSE}}
	<span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask — don't be hasty closing connections.<section end="desc" /></span>		<span class="pageSubtitle"><section begin="desc" />SLOWCLOSE mask — don't be hasty closing connections<section end="desc" /></span>

	<var>SLOWCLOSE</var> is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port.		<var>SLOWCLOSE</var> is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port.

JALWiccan: 1 revision

2012-02-29T23:08:39Z

1 revision

← Older revision	Revision as of 23:08, 29 February 2012
(No difference)