Skip to content

VIP16: Retire parameters aliases

Nils Goroll edited this page Nov 19, 2018 · 2 revisions

Closed

https://github.com/varnishcache/varnish-cache/commit/dc1df48ffe9c3f5ba9bc61cf959d23f233a7a605

Synopsis

Schedule the removal of shm_reclen, vcl_dir and vmod_dir with the appropriate major release.

Why?

The *_dir parameters used to describe directories, but in Varnish 4.1 they grew the ability to describe multiple directories using a colon (:) separator. Varnish 5.0 logically introduced new parameters vcl_path and vmod_path, and the old parameters became aliases to the new ones.

Starting 4.0 shm_reclen was renamed to a more accurate vsl_reclen.

How?

When the EOL of Varnish 4.1 is decided, schedule the removal of the aliases with the corresponding major release. The schedule should be announced at least one major release before the actual removal, in the release notes.

Varnish 4.1 is currently the sole supported branch that doesn't have vcl_path and vmod_path.

Clone this wiki locally