Re: [gentoo-news v3] 2026-03-30-varnish-renamed: add news item

Sam James <[email protected]> Tue, 31 Mar 2026 16:53:21 +0100
Newsgroups	gmane.linux.gentoo.devel
Organization	Gentoo
Message-ID	<[email protected]>
Brett A C Sheffield <[email protected]> writes:

> Signed-off-by: Brett A C Sheffield <[email protected]>
> ---
> v3:
>  - remove version from Display-If-Installed
> v2:
>  - CC: [email protected]
>  - change title + id to fit within 20 chars
>  - filename - date changed
>  - added section headings
>  - numbered reference to URL
>  - added more detail on name changes and files affected
>  - other rewording and clarifications
>
>  .../2026-03-30-varnish-renamed.en.txt         | 78 +++++++++++++++++++
>  1 file changed, 78 insertions(+)
>  create mode 100644 2026-03-30-varnish-renamed/2026-03-30-varnish-renamed.en.txt
>
> diff --git a/2026-03-30-varnish-renamed/2026-03-30-varnish-renamed.en.txt b/2026-03-30-varnish-renamed/2026-03-30-varnish-renamed.en.txt
> new file mode 100644
> index 0000000..6d3c913
> --- /dev/null
> +++ b/2026-03-30-varnish-renamed/2026-03-30-varnish-renamed.en.txt
> @@ -0,0 +1,78 @@
> +Title: Varnish Renamed
> +Author: Brett A C Sheffield <[email protected]>
> +Posted: 2026-03-30
> +Revision: 1
> +News-Item-Format: 2.0
> +Display-If-Installed: www-servers/varnish
> +
> +# Varnish Renamed to Vinyl-Cache
> +
> +As of version 9.0.0, www-servers/varnish has been renamed to
> +www-servers/vinyl-cache in line with upstream's change of name[0]. The name
> +change also affects binaries, directories, init scripts, configuration and the
> +user and group used by the server daemon.
> +
> +If you are upgrading from a previous version of www-servers/varnish you will
> +need to update your configuration as described in "Upgrading" below.
> +
> +
> +# Summary of Changes

I think '# Changes' would work better, but it's fine as-is.

> +
> +All varnish* binaries have been renamed to their vinyl* equivalents:
> +
> + varnishd                  -> vinyld
> + varnishlog                -> vinyllog
> + varnishncsa               -> vinylncsa
> + varnishadm                -> vinyladm
> + varnishhist               -> vinylhist
> + varnishstat               -> vinylstat
> + varnishstat_help_gen      -> vinylstat_help_gen
> + varnishstatdiff           -> vinylstatdiff
> + varnishtest               -> vinyltest
> + varnishtop                -> vinyltop
> +
> +This name change also affects all related conf.d/* files, init scripts,
> +systemd service files, logrotate etc.
> +
> +The api library has been renamed:
> + libvarnishapi.so -> libvinylapi.so
> +
> +In these conf.d files, all VARNISH* options are now VINYL* and you will need to
> +update your configuration accordingly:
> +
> + /etc/conf.d/varnishd      -> /etc/conf.d/vinyld
> + /etc/conf.d/varnishlog    -> /etc/conf.d/vinyllog
> + /etc/conf.d/varnishncsa   -> /etc/conf.d/vinylncsa
> +
> +The configuration directory has been moved:
> + /etc/varnish/ -> /etc/vinyl-cache/
> +
> +Other varnish directories have also been renamed:
> +
> + /usr/include/varnish      -> /usr/include/vinyl-cache
> + /usr/lib/varnish          -> /usr/lib/vinyl-cache
> + /usr/lib64/varnish        -> /usr/lib64/vinyl-cache
> + /usr/share/varnish        -> /usr/share/vinyl-cache
> + /var/lib/varnish          -> /var/lib/vinyl-cache
> + /var/log/varnish          -> /var/log/vinyl-cache
> +
> +
> +# Upgrading
> +
> +To upgrade from varnish 8.x to 9.x:
> +
> +0) Take a backup of your existing configuration files
> +1) Stop all running varnish services
> +2) emerge --oneshot www-servers/vinyl-cache
> +3) Update and install your VCL files in /etc/vinyl-cache/
> +
> +You can now start the new vinyld, vinyllog and vinylncsa services, remembering
> +to add them to the appropriate runlevels as usual.

"Ditto systemd services."

> +
> +For more details of the changes, you are encouraged to read the upstream
> +announcement[0].
> +
> +
> +# Refs
> +
> +[0] https://vinyl-cache.org/docs/9.0/whats-new/upgrading-9.0.html
signature.asc (application/pgp-signature, 418 B)