[master] 6127079b5 changelog tlc and a minor addition to the API log

Dridi Boukelmoune dridi at varni.sh
Tue Sep 1 11:11:14 UTC 2020


On Tue, Sep 1, 2020 at 10:42 AM Nils Goroll <nils.goroll at uplex.de> wrote:
>
>
> commit 6127079b50d2debd966ba9332ba9877d5c0071f2
> Author: Nils Goroll <nils.goroll at uplex.de>
> Date:   Tue Sep 1 12:13:01 2020 +0200
>
>     changelog tlc and a minor addition to the API log
>
> diff --git a/doc/changes.rst b/doc/changes.rst
> index a6ecf1d96..5a00c1fde 100644
> --- a/doc/changes.rst
> +++ b/doc/changes.rst
> @@ -30,6 +30,11 @@ release process.
>  NEXT (scheduled 2020-09-15)
>  ===========================
>
> +[ABI] marks potentially breaking changes to binary compatibility.
> +
> +[API] marks potentially breaking changes to source compatibility
> +(implies [ABI]).

Not necessarily, if you rename a field you break the API but not the
ABI for example. If you add fields to a struct that is not supposed to
be stored, and only pointed to, without relying on the struct size,
appending the new fields may not break.

>  * ``varnishstat`` now has a help screen, available via the ``h`` key
>    in curses mode
>
> @@ -46,7 +51,7 @@ NEXT (scheduled 2020-09-15)
>  * ``varnishstat`` JSON format (``-j`` option) has been changed:
>
>    * on the top level, a ``version`` identifier has been introduced,
> -    which will be used to mark breaking changes to the JSON
> +    which will be used to mark future breaking changes to the JSON
>      formatting. It will not be used to mark changes to the counters
>      themselves.
>
> @@ -59,7 +64,7 @@ NEXT (scheduled 2020-09-15)
>    build a ``struct suckaddr``
>
>  * Depending on the setting of the new ``vcc_acl_pedantic`` parameter,
> -  VCC now either emits or warning or fails if network numbers used in
> +  VCC now either emits a warning or fails if network numbers used in
>    ACLs do not have an all-zero host part.
>
>    For ``vcc_acl_pedantic`` off, the host part is fixed to all-zero and
> @@ -69,7 +74,7 @@ NEXT (scheduled 2020-09-15)
>    ``vcl_backend_response`` (3273_)
>
>  * ``obj.can_esi`` has been added to identify if the response can be
> -  ESI processed (See 3002_)
> +  ESI processed (3002_)
>
>  * ``resp.filters`` now contains a correct value when the
>    auto-determined filter list is read (3002_)
> @@ -78,6 +83,35 @@ NEXT (scheduled 2020-09-15)
>    ``beresp.do_`` fields which determine the filter list after setting
>    ``resp.filters`` and ``beresp.filters``, respectively
>
> +* Behavior for 304 responses was changed not to update
> +  the ``Content-Encoding`` response header of the stored object.
> +
> +* [ABI] ``struct vfp_entry`` and ``struct vdp_ctx`` changed
> +
> +* [API] VSB_QUOTE_GLOB, which was prematurely added to 6.4, has been
> +  removed again.
> +
> +* [API] Add ``VDP_END`` action for delivery processors, which has to
> +  be sent with or after the last buffer.
> +
> +* Respect the administrative health for "real" (VBE) backends (3299_)
> +
> +* Fixed handling of illegal (internal) four-digit response codes and
> +  with HTTP/2 (3301_)
> +
> +* Fixed backend connection pooling of closed connections (3266_)
> +
> +* Added the ``.resolve`` method for the ``BACKEND`` type to resolve
> +  (determine the "real" backend) a director.
> +
> +* Improved ``vmodtool`` support for out-of-tree builds
> +
> +* Added ``VJ_unlink()`` and ``VJ_rmdir()`` jail functions
> +
> +* Fixed workdir cleanup (3307_)
> +
> +* Added ``JAIL_MASTER_SYSTEM`` jail level
> +
>  * The Varnish Jail (least privileges) code for Solaris has been
>    largely rewritten. It now reduces privileges even further and thus
>    should improve the security of Varnish on Solaris even more.
> @@ -89,12 +123,105 @@ NEXT (scheduled 2020-09-15)
>  * The shard director and shard director parameter objects should now
>    work in ``vcl_pipe {}`` like in ``vcl_backend_* {}`` subs.
>
> +* For a failure in ``vcl_recv {}``, the VCL state engine now returns
> +  right after return from that subroutine. (3303_)
> +
> +* The shard director now supports weights by scaling the number of
> +  replicas of each backend on the consistent hashing ring
> +
> +* Fixed a race in the cache expiry code which could lead to a panic (2999_)
> +
> +* Added ``VRE_quote()`` to facilitate building literal string matches
> +  with regular expressions.
> +
> +* The ``BackendReuse`` VSL (log) tag has been retired and replaced
> +  with ``BackendClose``, which has been changed to contain either
> +  ``close`` or ``recycle`` to signify whether the connection was
> +  closed or returned to a pool for later reuse.
> +
> +* ``BackendOpen`` VSL entries have been changed to contain ``reuse``
> +  or ``connect`` in the last column to signify whether the connection
> +  was reused from a pool or newly opened.
> +
> +* ``std.rollback()`` of backend requests with ``return(retry)`` has
> +  been fixed (3353_)
> +
> +* ``FetchError`` logs now differentiate between ``No backend`` and
> +  "none resolved" as ``Director %s returned no backend``
> +
> +* Added ``VRT_DirectorResolve()`` to resolve a director
> +
> +* Improved VCC handling of symbols and, in particular, type methods
> +
> +* Fixed use of the shard director from ``vcl_pipe {}`` (3361_)
> +
> +* Handle recursive use of vcl ``include`` (3360_)
> +
> +* VCL: Added native support for BLOBs in structured fields notation
> +  (``:<base64>:``)
> +
> +* Fixed handling of the ``Connection:`` header when multiple instances
> +  of the named headers existed.
> +
> +* Added support for naming ``PRIV_`` arguments to vmod methods/functions
> +
> +* The varnish binary heap implementation has been renamed to use the
> +  ``VBH_`` prefix, complemented with a destructor and added to header
> +  files for use with vmods (via include of ``vbh.h``).
> +
> +* A bug in ``vmod_blob`` for base64 decoding with a ``length``
> +  argument and non-padding decoding has been fixed (3378_)
> +
> +* Added ``VRT_BLOB_string()`` to ``vrt.h``
> +
> +* VSB support for dynamic vs. static allocations has been changed:
> +
> +  For dynamic allocations use::
> +
> +       VSB_new_auto() + VSB_destroy()
> +
> +  For preexisting buffers use::
> +
> +       VSB_init() + VSB_fini()
> +
> +  ``VSB_new()`` + ``VSB_delete()`` are now deprecated.
> +
> +* ``std.blobread()`` has been added
> +
> +* New ``main.beresp_uncacheable`` and ``main.beresp_shortlived``
> +  counters have been added.
> +
> +* The ``I``, ``X`` and ``R`` arguments have been added to the VSC API
> +  and ``varnishstat`` for inclusion, exclusion and required glob
> +  patterns on the statistic field names. (3394_)
> +
> +* [API] overhaul of the workspace API
> +
> +  * The previously deprecated ``WS_Reserve()`` has been removed
> +  * The signature of ``WS_Printf()`` has been changed
> +  * Add ``WS_ReservationSize()``
> +  * ``WS_Front()`` replaced by ``WS_Reservation()``
> +  * Add ``WS_Id()``
> +
> +* Handle a workspace overflow in ``VRY_Validate()`` (3319_)
> +
>  .. _2990: https://github.com/varnishcache/varnish-cache/issues/2990
> +.. _2999: https://github.com/varnishcache/varnish-cache/issues/2999
>  .. _3002: https://github.com/varnishcache/varnish-cache/issues/3002
>  .. _3241: https://github.com/varnishcache/varnish-cache/issues/3241
>  .. _3253: https://github.com/varnishcache/varnish-cache/issues/3253
> +.. _3266: https://github.com/varnishcache/varnish-cache/issues/3266
>  .. _3273: https://github.com/varnishcache/varnish-cache/issues/3273
> -
> +.. _3299: https://github.com/varnishcache/varnish-cache/issues/3299
> +.. _3301: https://github.com/varnishcache/varnish-cache/issues/3301
> +.. _3303: https://github.com/varnishcache/varnish-cache/issues/3303
> +.. _3307: https://github.com/varnishcache/varnish-cache/issues/3307
> +.. _3319: https://github.com/varnishcache/varnish-cache/issues/3319
> +.. _3353: https://github.com/varnishcache/varnish-cache/issues/3353
> +.. _3360: https://github.com/varnishcache/varnish-cache/issues/3360
> +.. _3361: https://github.com/varnishcache/varnish-cache/issues/3361
> +.. _3378: https://github.com/varnishcache/varnish-cache/issues/3378
> +.. _3394: https://github.com/varnishcache/varnish-cache/issues/3394
>
>  ================================
>  Varnish Cache 6.4.0 (2020-03-16)
> diff --git a/include/vrt.h b/include/vrt.h
> index a99798c95..1095d6ab0 100644
> --- a/include/vrt.h
> +++ b/include/vrt.h
> @@ -59,6 +59,7 @@
>   *     [cache.h] WS_Printf() changed
>   *     [cache.h] WS_ReservationSize() added
>   *     [cache.h] WS_Front() replaced by WS_Reservation()
> + *     [cache.h] WS_Id() added
>   * 11.0 (2020-03-16)
>   *     Changed type of vsa_suckaddr_len from int to size_t
>   *     New prefix_{ptr|len} fields in vrt_backend
> _______________________________________________
> varnish-commit mailing list
> varnish-commit at varnish-cache.org
> https://www.varnish-cache.org/lists/mailman/listinfo/varnish-commit


More information about the varnish-commit mailing list