Upgrading to Vinyl Cache 9.0¶

This document only lists breaking changes that you should be aware of when upgrading from varnish 8.x to vinyl 9.0. For a complete list of changes, please refer to the change log or Changes in Vinyl Cache 9.0.

Name change¶

As you may have noticed, the project name has been changed from “Varnish Cache” to “Vinyl Cache”, and this is the first release under the new name. All binaries, documentation, and other references have been updated to reflect this change. Starting from this release, the main binary is now vinyld instead of varnishd. Similarly, all VUTs were renamed accordingly (vinyllog, vinylncsa.. etc).

Besides this cosmetic change, there are no functional changes related to the name change, and the upgrade process should be as usual.

vinyld¶

VCL variable `beresp.storage_hint` removed¶

The VCL variable beresp.storage_hint has been removed. If you were using this variable in your VCL, you will need to remove any references to it.

VCL variable `req.ttl` deprecated¶

The req.ttl variable has been renamed to req.max_age for clarity. req.ttl is retained as an alias and continues to work, but is now deprecated and will be removed in a future version of Vinyl Cache. You should update your VCL to use req.max_age instead.

Content-Length handling for requests without body¶

For requests having no request body, the Content-Length header will now only be unset when the request method is one of: GET, HEAD, DELETE, OPTIONS, TRACE. For other methods, a Content-Length header with value 0 will be set instead. This may affect backends that are sensitive to the presence of the Content-Length header.

Upgrade notes for VMOD developers¶

`VSL_Setup()` replaced with `VSL_Init()` and `VSL_Alloc()`¶

VSL_Setup() has been replaced with two new functions:

VSL_Init() to initialize caller-provided space as a VSL buffer
VSL_Alloc() to allocate the default vsl_buffer on the heap

VSL_Free() has been added to free the memory allocated by VSL_Alloc().

The coccinelle script tools/coccinelle/vsl_setup_retire.cocci can be used to partially automate the transition (it does not add VSL_Free() calls).

eof