What's new in 4.5 - Revision history

Akhassin at 18:02, 18 July 2010

2010-07-18T18:02:05Z

Akhassin at 00:49, 6 July 2010

2010-07-06T00:49:15Z

Akhassin at 05:28, 23 June 2010

2010-06-23T05:28:47Z

Akhassin at 04:27, 23 June 2010

2010-06-23T04:27:18Z

Akhassin at 04:25, 23 June 2010

2010-06-23T04:25:20Z

Akhassin at 04:17, 23 June 2010

2010-06-23T04:17:48Z

Akhassin at 04:12, 23 June 2010

2010-06-23T04:12:34Z

Akhassin at 03:18, 23 June 2010

2010-06-23T03:18:02Z

Akhassin at 01:37, 19 June 2010

2010-06-19T01:37:28Z

Akhassin at 01:28, 19 June 2010

2010-06-19T01:28:52Z

@@ Line 31: / Line 31: @@
 * Added output buffer improvements via new Ns_ConnFlush.  See '''[[ns_adp_close]]''' and '''[[ns_adp_flush]]'''
 * Added automatic UTF-8 to output charset encoding.
-* Added gzip output compression.
+* Added gzip output compression.  KNOWN ISSUE: When streaming is enabled or when the content exceeds the buffer size (see [[ns_adp_ctl]]) and is therefore flushed to the browser in multiple pieces, gzip compression is not performed even if you enable it.  However, the last piece to be flushed ends up compressed and is therefore seen as garbage by the browser.  This issue is fixed in version 4.5.2.  You can workaround by explicitly disabling gzip compression when using streaming and for large content either also disabling gzip compression or increasing the buffer size to only have a single flush.
 * Added streaming output in chunked-encoding format instead of the previous "response with no length" HTTP/1.0 method.
 * Enhanced ADP error handling and reporting.

@@ Line 20: / Line 20: @@
 * Added ability to manage larger file uploads by spooling to a temporary file (currenty not for Windows).
-* New '''[[nsproxy]]''' module which provides the '''ns_proxy''' command which enables sending Tcl scripts to a proxy process connected via a pipe. The proxy includes core Tcl commands as well as AOLserver commands from the libnsd library. Evaluating scripts in a proxy process can be used to isolate and/or timeout thread-unsafe or otherwise unsafe 3rd party code.
+* New '''[[nsproxy]]''' module which provides the '''ns_proxy''' command which enables sending Tcl scripts to a proxy process connected via a pipe. The proxy includes core Tcl commands as well as AOLserver commands from the libnsd library. Evaluating scripts in a proxy process can be used to isolate and/or timeout thread-unsafe or otherwise unsafe 3rd party code.  Currently this module does not compile under Windows.
 === ADP Improvements: ===

@@ Line 10: / Line 10: @@
 ** As of 1 August 2007, the HEAD revision contains "pools.tcl", which will handle many pre-4.5 configurations.
 ** There are known issues when using this feature in conjunction with virtual servers; see the SourceForge bug list (and development mailing list archive) for details.
 === I/O Features: ===
@@ Line 81: / Line 82: @@
 * In early versions of AOLserver 4.0, '''[[ns_tmpnam]]''' on Windows used to return names without a path (they were relative to current directory).  In later builds, Jamie Rasmussen changed it to use a temp directory using GetTempPath and GetTempFileName with a prefix which resulted in names like %TEMP%/AOL1234.tmp, where 1234 is derived from time.  In 4.5.1, [[ns_tmpnam]] uses _tempnam but without a prefix and also has no extension and names are just sequential integers with sequence apparently maintained per process, thus making them not very safe. This issue is fixed in version 4.5.2.
 * Failure to call '''[[ns_adp_abort]]''' in an adp page after calling ns_return* will now result in a Tcl error being thrown and logged.  On the other hand, without a patch from Tom Jackson (portions of which are included in version 4.5.2), ns_adp_abort itself would throw an error.  In addition, adp flush errors (i.e. due to the client no longer being connected) now also result in Tcl errors being thrown and logged. These benign errors can be suppresed using the IgnoreFinalFlushErrors setting in version 4.5.2.  See '''[[ns_adp_ctl]]''' for more details.

@@ Line 80: / Line 80: @@
 </code>
 * In early versions of AOLserver 4.0, '''[[ns_tmpnam]]''' on Windows used to return names without a path (they were relative to current directory).  In later builds, Jamie Rasmussen changed it to use a temp directory using GetTempPath and GetTempFileName with a prefix which resulted in names like %TEMP%/AOL1234.tmp, where 1234 is derived from time.  In 4.5.1, [[ns_tmpnam]] uses _tempnam but without a prefix and also has no extension and names are just sequential integers with sequence apparently maintained per process, thus making them not very safe. This issue is fixed in version 4.5.2.
-* Failure to call '''[[ns_adp_abort]]''' in an adp page after calling ns_return* will now result in a Tcl error being thrown and logged.  On the other hand, without a patch from Tom Jackson (portions of which are included in version 4.5.2), ns_adp_abort itself would throw an error.  In addition, adp flush errors (i.e. due to the client no longer being connected) now also result in Tcl errors being thrown and logged. These benign errors can be suppresed using the IgnoreFinalFlushErrors setting in version 4.5.2.
+* Failure to call '''[[ns_adp_abort]]''' in an adp page after calling ns_return* will now result in a Tcl error being thrown and logged.  On the other hand, without a patch from Tom Jackson (portions of which are included in version 4.5.2), ns_adp_abort itself would throw an error.  In addition, adp flush errors (i.e. due to the client no longer being connected) now also result in Tcl errors being thrown and logged. These benign errors can be suppresed using the IgnoreFinalFlushErrors setting in version 4.5.2.  See '''[[ns_adp_ctl]]''' for more details.

@@ Line 57: / Line 57: @@
 * More detailed information when logging uncaught Tcl errors.  Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.
-=== '''Changes in Behavior from 4.0''' ===
+=== '''Changes in Behavior from 4.0:''' ===
 * Interpreter deallocate/cleanup process is different from 4.0 - in 4.0 global variables get unset and database handles get closed prior to running the rest of the oncleanup traces.  In 4.5, that happens last.
@@ Line 80: / Line 80: @@
 </code>
 * In early versions of AOLserver 4.0, '''[[ns_tmpnam]]''' on Windows used to return names without a path (they were relative to current directory).  In later builds, Jamie Rasmussen changed it to use a temp directory using GetTempPath and GetTempFileName with a prefix which resulted in names like %TEMP%/AOL1234.tmp, where 1234 is derived from time.  In 4.5.1, [[ns_tmpnam]] uses _tempnam but without a prefix and also has no extension and names are just sequential integers with sequence apparently maintained per process, thus making them not very safe. This issue is fixed in version 4.5.2.
+* Failure to call '''[[ns_adp_abort]]''' in an adp page after calling ns_return* will now result in a Tcl error being thrown and logged.  On the other hand, without a patch from Tom Jackson (portions of which are included in version 4.5.2), ns_adp_abort itself would throw an error.  In addition, adp flush errors (i.e. due to the client no longer being connected) now also result in Tcl errors being thrown and logged. These benign errors can be suppresed using the IgnoreFinalFlushErrors setting in version 4.5.2.

@@ Line 71: / Line 71: @@
          namespace eval ::ns {}
          set ::ns::thread_name [ns_thread name]
-         ns_thread name ""$::ns::thread_name[ns_info server]""
+         ns_thread name "$::ns::thread_name[ns_info server]"
+     }
      ns_interp_ctl trace deallocate {
@@ Line 79: / Line 79: @@
+     }
 </code>

@@ Line 42: / Line 42: @@
 * New '''[[ns_internalredirect]]''' command to restart connection processing with a new URL.
 * 4.5.1 - Added '''ns_conn channel''' and '''ns_conn contentsentlength''' subcommands to [[ns_conn]] to allow raw communication via Tcl I/O to the remote client.
-* New '''[[ns_cache]]''' command based on ideas from the [[nscache]] module.   This is semi-backward-compatible with the ns_cache module (differences are described in detail in '''[[ns_cache]]''').
+* New '''[[ns_cache]]''' command based on ideas from the [[nscache]] module.   This is semi-backward-compatible with the ns_cache module.  The new command does not support the nscache module's -thread functionality, nor can create virtual-server-specific caches - all caches are now serverwide.  More importantly, -timeout is no longer sliding.  For details of all the differences see '''[[ns_cache]]'''.
 * New '''[[ns_loop_ctl]]''' command to monitor and manage ''for'', ''while'', and ''foreach'' loops.
 * Added '''ns_ictl once''' subcommand to [[ns_ictl]] / [[ns_interp_ctl]] command to execute a script exactly once for a virtual server (i.e. at startup).
@@ Line 60: / Line 60: @@
 * Interpreter deallocate/cleanup process is different from 4.0 - in 4.0 global variables get unset and database handles get closed prior to running the rest of the oncleanup traces.  In 4.5, that happens last.
-* conn ids are no longer allocated/counted per pool per virtual server and only for queued connections - conn ids are now process-wide global for all pools and provide a counter of all requests, including those that did not get to be queued and processed
+* Conn ids are no longer allocated/counted per pool per virtual server and only for queued connections - conn ids are now process-wide global for all pools and provide a counter of all requests, including those that did not get to be queued and processed.

← Older revision		Revision as of 03:18, 23 June 2010
Line 56:		Line 56:
	* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.		* Stack checking has returned. In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
	* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.		* More detailed information when logging uncaught Tcl errors. Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.
		+
		+	=== '''Changes in Behavior from 4.0''' ===
		+
		+	* Interpreter deallocate/cleanup process is different from 4.0 - in 4.0 global variables get unset and database handles get closed prior to running the rest of the oncleanup traces. In 4.5, that happens last.
		+	* conn ids are no longer allocated/counted per pool per virtual server and only for queued connections - conn ids are now process-wide global for all pools and provide a counter of all requests, including those that did not get to be queued and processed

@@ Line 51: / Line 51: @@
 * 4.5.1 - New '''[[ns_register_cgi]]''' command to dynamically register a CGI executable to a url.
 * New '''[[ns_driver]]''' command to get some stats on socket drivers.
-* [[nszlib]] module is now integrated into the core and provides for on-the-fly gzip compression and other gzip facilities in '''[[ns_gzip]]'''
+* [[nszlib]] module is now integrated into the core and provides for on-the-fly gzip compression and other gzip facilities in '''[[ns_zlib]]'''
 * -all switch added to '''[[ns_addrbyhost]]''' command.
 * Added ability to access more AOLserver functionality from a tclsh (nsv_*, ns_thread, etc).
 * Stack checking has returned.  In a multi-threaded application like AOLserver, stack checking is important for detecting buffer overruns and deep call trees blowing your thread stack, etc.
 * More detailed information when logging uncaught Tcl errors.  Especially for connection threads, details of the HTTP request are logged to make diagnosing the root cause of errors easier.