xref: /unit/docs/changes.xml (revision 2161)

<?xml version="1.0" ?>
<!DOCTYPE change_log SYSTEM "changes.dtd" >


<change_log title="unit">


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9 unit-python3.10
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15 unit-jsc16 unit-jsc17 unit-jsc18"
         ver="1.28.0" rev="1"
         date="" time=""
         packager="Nginx Packaging &lt;nginx-packaging@f5.com&gt;">

<change>
<para>
NGINX Unit updated to 1.28.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.28.0" rev="1"
         date="" time=""
         packager="Nginx Packaging &lt;nginx-packaging@f5.com&gt;">

<change type="feature">
<para>
supporting UNIX sockets in address matching.
</para>
</change>

<change type="feature">
<para>
forwarded header to replace client address and protocol.
</para>
</change>

<change type="feature">
<para>
ability to get dynamic variables.
</para>
</change>

<change type="feature">
<para>
more http variables support.
</para>
</change>

<change type="feature">
<para>
added a new variable, $dollar, that translates to a literal "$" during
</para>
</change>

<change type="bugfix">
<para>
an index file that didn't contain a file extension was incorrectly
handled, and caused a use-after-free bug.
</para>
</change>

<change type="change">
<para>
increased the applications' startup timeout.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9 unit-python3.10
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15 unit-jsc16 unit-jsc17 unit-jsc18"
         ver="1.27.0" rev="1"
         date="2022-06-02" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.27.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.27.0" rev="1"
         date="2022-06-02" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="feature">
<para>
ability to specify a custom index file name when serving static files.
</para>
</change>

<change type="feature">
<para>
variables support in the "location" option of the "return" action.
</para>
</change>

<change type="feature">
<para>
support empty strings in the "location" option of the "return" action.
</para>
</change>

<change type="feature">
<para>
added a new variable, $request_uri, that includes both the path and the query
parts as per RFC 3986, sections 3-4.
</para>
</change>

<change type="feature">
<para>
Ruby Rack environment parameter "SCRIPT_NAME" support.
</para>
</change>

<change type="feature">
<para>
compatibility with GCC 12.
</para>
</change>

<change type="bugfix">
<para>
Ruby Sinatra applications don't work without custom logging.
</para>
</change>

<change type="bugfix">
<para>
the controller process could crash when a chain of more than four
certificates was uploaded.
</para>
</change>

<change type="bugfix">
<para>
some Perl applications failed to process the request body, notably with Plack.
</para>
</change>

<change type="bugfix">
<para>
some Spring Boot applications failed to start, notably with Grails.
</para>
</change>

<change type="bugfix">
<para>
incorrect Python protocol auto detection (ASGI or WSGI) for native callable
object, notably with Falcon.
</para>
</change>

<change type="bugfix">
<para>
ECMAScript modules did not work with the recent Node.js versions.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9 unit-python3.10
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15 unit-jsc16 unit-jsc17 unit-jsc18"
         ver="1.26.1" rev="1"
         date="2021-12-02" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.26.1.
</para>
</change>

</changes>


<changes apply="unit" ver="1.26.1" rev="1"
         date="2021-12-02" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="bugfix">
<para>
occasionally, the Unit daemon was unable to fully terminate; the bug had
appeared in 1.26.0.
</para>
</change>

<change type="bugfix">
<para>
a prototype process could crash on an application process exit; the bug had
appeared in 1.26.0.
</para>
</change>

<change type="bugfix">
<para>
the router process crashed on reconfiguration if "access_log" was configured
without listeners.
</para>
</change>

<change type="bugfix">
<para>
a segmentation fault occurred in the PHP module if chdir() or
fastcgi_finish_request() was called in the OPcache preloading script.
</para>
</change>

<change type="bugfix">
<para>
fatal errors on DragonFly BSD; the bug had appeared in 1.26.0.
</para>
</change>

</changes>


<changes apply="unit-jsc18" ver="1.26.0" rev="1"
         date="2021-11-18" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Java 18 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-python3.10" ver="1.26.0" rev="1"
         date="2021-11-18" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Python 3.10 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15 unit-jsc16 unit-jsc17"
         ver="1.26.0" rev="1"
         date="2021-11-18" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.26.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.26.0" rev="1"
         date="2021-11-18" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="change">
<para>
the "share" option now specifies the entire path to the files it serves,
rather than a document root directory to be prepended to the request URI.
</para>
</change>

<change type="feature">
<para>
automatic adjustment of existing configurations to the new "share" behavior
when updating from previous versions.
</para>
</change>

<change type="feature">
<para>
variables support in the "share" option.
</para>
</change>

<change type="feature">
<para>
multiple paths in the "share" option.
</para>
</change>

<change type="feature">
<para>
variables support in the "chroot" option.
</para>
</change>

<change type="feature">
<para>
PHP opcache is shared between application processes.
</para>
</change>

<change type="feature">
<para>
request routing by the query string.
</para>
</change>

<change type="bugfix">
<para>
the router and app processes could crash when the requests limit was reached
by asynchronous or multithreaded apps.
</para>
</change>

<change type="bugfix">
<para>
established WebSocket connections could stop reading frames from the client
after the corresponding listener had been reconfigured.
</para>
</change>

<change type="bugfix">
<para>
fixed building with glibc 2.34, notably Fedora 35.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15 unit-jsc16 unit-jsc17"
         ver="1.25.0" rev="1"
         date="2021-08-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.25.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.25.0" rev="1"
         date="2021-08-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="feature">
<para>
client IP address replacement from a specified HTTP header field.
</para>
</change>

<change type="feature">
<para>
TLS sessions cache.
</para>
</change>

<change type="feature">
<para>
TLS session tickets.
</para>
</change>

<change type="feature">
<para>
application restart control.
</para>
</change>

<change type="feature">
<para>
process and thread lifecycle hooks in Ruby.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash on TLS connection open when multiple listeners
with TLS certificates were configured; the bug had appeared in 1.23.0.
</para>
</change>

<change type="bugfix">
<para>
TLS connections were rejected for configurations with multiple certificate
bundles in a listener if the client did not use SNI.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash with frequent multithreaded application
reconfiguration.
</para>
</change>

<change type="bugfix">
<para>
compatibility issues with some Python ASGI apps, notably based on the Starlette
framework.
</para>
</change>

<change type="bugfix">
<para>
a descriptor and memory leak occurred in the router process when an app process
stopped or crashed.
</para>
</change>

<change type="bugfix">
<para>
the controller or router process could crash if the configuration contained
a full-form IPv6 in a listener address.
</para>
</change>

<change type="bugfix">
<para>
the router process crashed when a request was passed to an empty "routes"
or "upstreams" using a variable "pass" option.
</para>
</change>

<change type="bugfix">
<para>
the router process crashed while matching a request to an empty array of source
or destination address patterns.
</para>
</change>

</changes>


<changes apply="unit-jsc17" ver="1.24.0" rev="1"
         date="2021-05-27" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Java 17 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-jsc16" ver="1.24.0" rev="1"
         date="2021-05-27" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Java 16 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15"
         ver="1.24.0" rev="1"
         date="2021-05-27" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.24.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.24.0" rev="1"
         date="2021-05-27" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="change">
<para>
PHP added to the default MIME type list.
</para>
</change>

<change type="feature">
<para>
arbitrary configuration of TLS connections via OpenSSL commands.
</para>
</change>

<change type="feature">
<para>
the ability to limit static file serving by MIME types.
</para>
</change>

<change type="feature">
<para>
support for chrooting, rejecting symlinks, and rejecting mount
point traversal on a per-request basis when serving static files.
</para>
</change>

<change type="feature">
<para>
a loader for automatically overriding the "http" and "websocket" modules in
Node.js.
</para>
</change>

<change type="feature">
<para>
multiple "targets" in Python applications.
</para>
</change>

<change type="feature">
<para>
compatibility with Ruby 3.0.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash while closing a TLS connection.
</para>
</change>

<change type="bugfix">
<para>
a segmentation fault might have occurred in the PHP module if
fastcgi_finish_request() was used with the "auto_globals_jit" option enabled.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8 unit-python3.9
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15"
         ver="1.23.0" rev="1"
         date="2021-03-25" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.23.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.23.0" rev="1"
         date="2021-03-25" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="feature">
<para>
support for multiple certificate bundles on a listener via the Server Name
Indication (SNI) TLS extension.
</para>
</change>

<change type="feature">
<para>
"--mandir" ./configure option to specify the directory for man page
installation.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash on premature TLS connection close; the bug had
appeared in 1.17.0.
</para>
</change>

<change type="bugfix">
<para>
a connection leak occurred on premature TLS connection close; the bug had
appeared in 1.6.
</para>
</change>

<change type="bugfix">
<para>
a descriptor and memory leak occurred in the router process when processing
small WebSocket frames from a client; the bug had appeared in 1.19.0.
</para>
</change>

<change type="bugfix">
<para>
a descriptor leak occurred in the router process when removing or
reconfiguring an application; the bug had appeared in 1.19.0.
</para>
</change>

<change type="bugfix">
<para>
persistent storage of certificates might've not worked with some filesystems in
Linux, and all uploaded certificate bundles were forgotten after restart.
</para>
</change>

<change type="bugfix">
<para>
the controller process could crash while requesting information about a
certificate with a non-DNS SAN entry.
</para>
</change>

<change type="bugfix">
<para>
the controller process could crash on manipulations with a certificate
containing a SAN and no standard name attributes in subject or issuer.
</para>
</change>

<change type="bugfix">
<para>
the Ruby module didn't respect the user locale for defaults in the Encoding
class.
</para>
</change>

<change type="bugfix">
<para>
the PHP 5 module failed to build with thread safety enabled; the bug had
appeared in 1.22.0.
</para>
</change>

</changes>


<changes apply="unit-python3.9" ver="1.22.0" rev="1"
         date="2021-02-04" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Python 3.9 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11 unit-jsc13
                unit-jsc14 unit-jsc15"
         ver="1.22.0" rev="1"
         date="2021-02-04" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.22.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.22.0" rev="1"
         date="2021-02-04" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="feature">
<para>
the ServerRequest and ServerResponse objects of Node.js module are now
compliant with Stream API.
</para>
</change>

<change type="feature">
<para>
support for specifying multiple directories in the "path" option of Python
apps.
</para>
</change>

<change type="bugfix">
<para>
a memory leak occurred in the router process when serving files larger than
128K; the bug had appeared in 1.13.0.
</para>
</change>

<change type="bugfix">
<para>
apps could stop processing new requests under high load; the bug had
appeared in 1.19.0.
</para>
</change>

<change type="bugfix">
<para>
app processes could terminate unexpectedly under high load; the bug had
appeared in 1.19.0.
</para>
</change>

<change type="bugfix">
<para>
invalid HTTP responses were generated for some unusual status codes.
</para>
</change>

<change type="bugfix">
<para>
the PHP_AUTH_USER, PHP_AUTH_PW, and PHP_AUTH_DIGEST server variables were
missing in the PHP module.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash with multithreaded apps under high load.
</para>
</change>

<change type="bugfix">
<para>
Ruby apps with multithreading configured could crash on start under load.
</para>
</change>

<change type="bugfix">
<para>
mount points weren't unmounted when the "mount" namespace isolation was used;
the bug had appeared in 1.21.0.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash while removing or reconfiguring an app that used
WebSocket.
</para>
</change>

<change type="bugfix">
<para>
a memory leak occurring in the router process when removing or reconfiguring
an application; the bug had appeared in 1.19.0.
</para>
</change>

</changes>


<changes apply="unit-jsc15" ver="1.21.0" rev="1"
         date="2020-11-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Java 15 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-jsc14" ver="1.21.0" rev="1"
         date="2020-11-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Java 14 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-jsc13" ver="1.21.0" rev="1"
         date="2020-11-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
Initial release of Java 13 module for NGINX Unit.
</para>
</change>

</changes>


<changes apply="unit-php
                unit-python unit-python2.7
                unit-python3.4 unit-python3.5 unit-python3.6 unit-python3.7
                unit-python3.8
                unit-go
                unit-perl
                unit-ruby
                unit-jsc-common unit-jsc8 unit-jsc10 unit-jsc11"
         ver="1.21.0" rev="1"
         date="2020-11-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change>
<para>
NGINX Unit updated to 1.21.0.
</para>
</change>

</changes>


<changes apply="unit" ver="1.21.0" rev="1"
         date="2020-11-19" time="18:00:00 +0300"
         packager="Andrei Belov &lt;defan@nginx.com&gt;">

<change type="change">
<para>
procfs is mounted by default for all languages when "rootfs" isolation is used.
</para>
</change>

<change type="change">
<para>
any characters valid according to RFC 7230 are now allowed in HTTP header field
names.
</para>
</change>

<change type="change">
<para>
HTTP header fields with underscores ("_") are now discarded from requests by
default.
</para>
</change>

<change type="feature">
<para>
optional multithreaded request processing for Java, Python, Perl, and Ruby apps.
</para>
</change>

<change type="feature">
<para>
regular expressions in route matching patterns.
</para>
</change>

<change type="feature">
<para>
compatibility with Python 3.9.
</para>
</change>

<change type="feature">
<para>
the Python module now supports ASGI 2.0 legacy applications.
</para>
</change>

<change type="feature">
<para>
the "protocol" option in Python applications aids choice between ASGI and WSGI.
</para>
</change>

<change type="feature">
<para>
the fastcgi_finish_request() PHP function that finalizes request processing and
continues code execution without holding onto the client connection.
</para>
</change>

<change type="feature">
<para>
the "discard_unsafe_fields" HTTP option that enables discarding request header
fields with irregular (but still valid) characters in the field name.
</para>
</change>

<change type="feature">
<para>
the "procfs" and "tmpfs" automount isolation options to disable automatic
mounting of eponymous filesystems.
</para>
</change>

<change type="bugfix">
<para>
the router process could crash when running Go applications under high load;
the bug had appeared in 1.19.0.
</para>
</change>

<change type="bugfix">
<para>
some language dependencies could remain mounted after using "rootfs" isolation.
</para>