From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 5C8AA1582EF for ; Fri, 28 Feb 2025 14:48:37 +0000 (UTC) Received: from lists.gentoo.org (bobolink.gentoo.org [140.211.166.189]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) (Authenticated sender: relay-lists.gentoo.org@gentoo.org) by smtp.gentoo.org (Postfix) with ESMTPSA id 4882F343292 for ; Fri, 28 Feb 2025 14:48:37 +0000 (UTC) Received: from bobolink.gentoo.org (localhost [127.0.0.1]) by bobolink.gentoo.org (Postfix) with ESMTP id 0DE40110470; Fri, 28 Feb 2025 14:47:53 +0000 (UTC) Received: from mail-wr1-x42a.google.com (mail-wr1-x42a.google.com [IPv6:2a00:1450:4864:20::42a]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by bobolink.gentoo.org (Postfix) with ESMTPS id 4671E1102C9 for ; Fri, 28 Feb 2025 14:47:52 +0000 (UTC) Received: by mail-wr1-x42a.google.com with SMTP id ffacd0b85a97d-390ec7c2cd8so643383f8f.1 for ; Fri, 28 Feb 2025 06:47:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1740754070; x=1741358870; darn=lists.gentoo.org; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=nbG6GzwcwrnEWYYnHv4+nHWKCMjw6aw6pcPb2kucjDE=; b=k9QE9BKgR1H0f+Pr5cyaGytNCdRmkIUm/POqXyHFSVJA/jAUPiz+6azkiC961+hXI5 dh6YO6xOhHTr0+2ZIvfccuLMT2nS7Ye92BOizVns2S1/XL0Wu1WxN7UxibKFHvyWQeBa P1akF9ndwWxgyNNRIWOkLJbEnBsHq5retq2BQQp/eZeLNs6PFgYtQMrW6bl2l1FCYW1Y 5c9LxGTBbrSaRtoZVnISkSJKjwuAROVsmAxxi8a1JM2G2oHc/q/ZmEKnZ/GScnBocZ5n FdVzlQyEkBhPKxDQEHHtQqapWSI1Xgr8eZuO/KL9/ZM1o75DETyEyEM94cLIFe0rQHZs FuQg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1740754070; x=1741358870; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=nbG6GzwcwrnEWYYnHv4+nHWKCMjw6aw6pcPb2kucjDE=; b=MUPauTaVMNXvOAKu1zDKiDsRQz9TQzZCVU6RIzBsby5KuKvLKRlow/t5jy38teN0lb AMh9t0Ps/CP9iKoiUiBxbPO5ZcQ+8xacwUH/cMnA9rjOnVNPWySqfzmWS6d8qQcbzIw0 bs9/lBeAoR2rK4tAKdFKJg71aq1iLQRpb06rJZf3EQuxE8uQwOwS8RIWmxm/pvjiCNXd KXp/OIWAT0hibTEodMA27r2cOd45BdpOF0bqQfyOTlHLRt6dHbSMPmTe5tsdk0sR/buD Jk2hHieBXUf3LOEZclPfly8t0d5Xq94Uf4FqPylSm58oH5EDs3g1aMYKJg1ErY+3eSf2 JECA== X-Gm-Message-State: AOJu0Yx8M1nXoS3jvHCRMJPRcxv2M8y+LVVCfePB2gsfa4Zg33xn1BCU eIFv3xf5aX1u1bk11S7ufBrMHvt/aeUzK6euddca3j6GsHZof7pbJnmK0KMnxwlMjSB9eIHyo1/ RZSLK0HJWcQ89XmtRjeesH48TeOwghRjQ X-Gm-Gg: ASbGnctUUdoj3YevBMas1M4S0Y5fYYrJM20NiArT76xWKUS56YidxnASaR9JCiDbCxx VPv2C9pJdyHUpUOr/XAiFFamkNkIbuqCJhfCV1aV52qe3nvkKaXUMbz6odiuiVnF3DJske+xnpB 7pFykeJn8= X-Google-Smtp-Source: AGHT+IHLYsybLTmdqk5vrLIFiIpqLDF7bxP4kjQ0YgPkkLVkZO5DGWtB5t8UMQyaQtI+p9stCGQPMBnuZeDTH/C+NKI= X-Received: by 2002:a5d:598d:0:b0:390:f0ff:2bf8 with SMTP id ffacd0b85a97d-390f0ff2f85mr2010568f8f.10.1740754070067; Fri, 28 Feb 2025 06:47:50 -0800 (PST) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 References: <20250221153621.26266-1-zurabid2016@gmail.com> <20250221153621.26266-2-zurabid2016@gmail.com> In-Reply-To: <20250221153621.26266-2-zurabid2016@gmail.com> From: Tomas Mozes Date: Fri, 28 Feb 2025 15:47:38 +0100 X-Gm-Features: AQ5f1JqOQOdWsDgCTF9s6DVWo3OrENRUahrcUwxwK6Jmlja3LhEERrgImdzYZqE Message-ID: Subject: Re: [gentoo-dev] [PATCH 1/1] 2025-02-21-NGINX-packaging-changes: Add news item To: gentoo-dev@lists.gentoo.org Content-Type: multipart/alternative; boundary="000000000000fce2fc062f34e337" X-Archives-Salt: 14f06013-6785-4f19-9968-e2883464ab4d X-Archives-Hash: c5a993ebc17b36dadc32fd3f7591529f --000000000000fce2fc062f34e337 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Fri, Feb 21, 2025 at 4:38=E2=80=AFPM Zurab Kvachadze wrote: > Signed-off-by: Zurab Kvachadze > --- > .../2025-02-21-NGINX-packaging-changes.txt | 118 ++++++++++++++++++ > 1 file changed, 118 insertions(+) > create mode 100644 > 2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.txt > > diff --git > a/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.t= xt > b/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.t= xt > new file mode 100644 > index 0000000..8050bda > --- /dev/null > +++ > b/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.t= xt > @@ -0,0 +1,118 @@ > +Title: Breaking changes in NGINX packaging in Gentoo > +Author: Zurab Kvachadze > +Posted: 2025-02-21 > +Revision: 1 > +News-Item-Format: 2.0 > +Display-If-Installed: www-servers/nginx > + > +NGINX is a web server and a reverse proxy. Following a year-long effort, > +its packaging in Gentoo has undergone a major revamp[1]. Starting from > +the mainline version %PUT_MAINLINE_NGINX_VERSION_HERE% and the stable > +version %PUT_STABLE_NGINX_VERSION_HERE%, the changes will come into > +force. If you are reading this NEWS item, the information below is > +relevant for you. > + > +What changed? > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +There are a few user-facing changes with the updated packaging. > + > +1. Third-party modules. > + > +Third-party modules, which were previously part of the NGINX package, > +www-servers/nginx, are now separate packages in the www-nginx/ category. > +The Lua, Brotli, headers-more and upload-progress are examples of the > +modules that have been separated. Some of the modules have been removed > +completely due to their apparent low usage and needlessness. > + > +The following is a list of modules that have been removed. If you rely > +on any of the modules outlined below, please file a bug on Gentoo > +Bugzilla[2][3] asking the module to be added. The recommended summary > +for a bug is "www-servers/nginx: please add module MODULE_NAME", where > +MODULE_NAME is the name of the module you would like to see added. > + > +Removed modules: > + - ngx_cache_purge/http_cache_purge_module > + - nginx_ngx_slowfs_cache/http_slowfs_cache_module > + - ngx-fancyindex/http_fancyindex_module > + - ngx_http_auth_pam_module/http_authpam_module > + - nginx_upstream_check_module/http_upstream_check_module > + - ngx_metrics/http_metrics_module > + - naxsi/http_naxsi_module > + - nginx-rtmp-module/rtmp_module > + - nginx-dav-ext-module/http_dav_ext_module > + - ModSecurity-nginx/http_security_module > + - nginx-push-stream-module/http_push_stream_module > + - nginx-sticky-module-ng/http_sticky_module > + - nginx-mogilefs-module/http_mogilefs_module > + - nginx-auth-ldap/http_auth_ldap_module > + - nginx-vod-module/http_vod_module > + - ngx_http_geoip2_module/http_geoip2_module > + > +2. USE flags. > + > +Some USE flags, like "http-cache", "ktls", "pcre", "pcre-jit" and so on, > +have been removed. They did not have any effect or served no purpose, > +thus you need not worry about them. > + > +The "http2", "http3" use flags have been renamed to > +nginx_modules_http_v2 and nginx_modules_http_v3 respectively. They > +correspond to NGINX_MODULES_HTTP "v2" and "v3" USE_EXPAND flags > +accordingly. "ssl" use flag has been changed into individual "ssl" > +USE_EXPAND flags for the mail, stream and HTTP servers. > + > +Thread pool support[4], previously toggled by the "threads" USE flag, is > +now enabled unconditionally. Vim syntax files are now provided by the > +main www-servers/nginx package. > + > +3. Default log files. > + > +Default log filenames are now error.log and access.log, instead of > +error_log and access_log. > + > +User Action Required > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +If you use any third-party modules, install the new separate package. > +For instance, if you previously enabled the nginx_modules_http_lua USE > +flag on www-servers/nginx, here is how you install the new Lua module > +package. > + > + emerge www-nginx/ngx-lua-module > + > +To list all the available module packages, use > + > + emerge --search @www-nginx | less > + > +If you use the "http2" or "http3" USE flags, enable the corresponding > +USE_EXPAND flags. To enable http2 only: > + > + echo 'www-servers/nginx NGINX_MODULES_HTTP: v2' >> \ > + /etc/portage/package.use/nginx.use > + > +To enable http3: > + > + echo 'www-servers/nginx NGINX_MODULES_HTTP: v3' >> \ > + /etc/portage/package.use/nginx.use > + > +To enable both http2 and http3: > + > + echo 'www-servers/nginx NGINX_MODULES_HTTP: v2 v3' >> \ > + /etc/portage/package.use/nginx.use > + > +SSL/TLS modules are enabled by default. If you wish to disable them, use > +the following command. > + > + echo www-servers/nginx NGINX_MODULES_HTTP: -ssl \ > + NGINX_MODULES_STREAM: -ssl \ > + NGINX_MODULES_MAIL: -ssl >> \ > + /etc/portage/package.use/nginx.use > + > +The updated NGINX comes with a new logrotate file that points to the new > +log filenames. If any of your scripts rely on the old log files, change > +them accordingly as needed. > + > +[1]: https://github.com/gentoo/gentoo/pull/37590 > +[2]: https://bugs.gentoo.org/ > +[3]: https://wiki.gentoo.org/wiki/Bugzilla/Bug_report_guide > +[4]: https://nginx.org/en/docs/ngx_core_module.html#thread_pool > -- > 2.45.3 > > Please keep these modules: - nginx_upstream_check_module/http_upstream_check_module - ModSecurity-nginx/http_security_module - ngx_http_geoip2_module/http_geoip2_module Thank you, Tomas --000000000000fce2fc062f34e337 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

On Fri, Feb 21, 2025 at 4:38=E2=80=AFPM Zu= rab Kvachadze <zurabid2016@gmai= l.com> wrote:
Signed-off-by: Zurab Kvachadze <zurabid2016@gmail.com>
---
=C2=A0.../2025-02-21-NGINX-packaging-changes.txt=C2=A0 =C2=A0 | 118 +++++++= +++++++++++
=C2=A01 file changed, 118 insertions(+)
=C2=A0create mode 100644 2025-02-21-NGINX-packaging-changes/2025-02-21-NGIN= X-packaging-changes.txt

diff --git a/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-= changes.txt b/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging= -changes.txt
new file mode 100644
index 0000000..8050bda
--- /dev/null
+++ b/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes= .txt
@@ -0,0 +1,118 @@
+Title: Breaking changes in NGINX packaging in Gentoo
+Author: Zurab Kvachadze <zurabid2016@gmail.com>
+Posted: 2025-02-21
+Revision: 1
+News-Item-Format: 2.0
+Display-If-Installed: www-servers/nginx
+
+NGINX is a web server and a reverse proxy. Following a year-long effort, +its packaging in Gentoo has undergone a major revamp[1]. Starting from
+the mainline version %PUT_MAINLINE_NGINX_VERSION_HERE% and the stable
+version %PUT_STABLE_NGINX_VERSION_HERE%, the changes will come into
+force. If you are reading this NEWS item, the information below is
+relevant for you.
+
+What changed?
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+There are a few user-facing changes with the updated packaging.
+
+1. Third-party modules.
+
+Third-party modules, which were previously part of the NGINX package,
+www-servers/nginx, are now separate packages in the www-nginx/ category. +The Lua, Brotli, headers-more and upload-progress are examples of the
+modules that have been separated. Some of the modules have been removed +completely due to their apparent low usage and needlessness.
+
+The following is a list of modules that have been removed. If you rely
+on any of the modules outlined below, please file a bug on Gentoo
+Bugzilla[2][3] asking the module to be added. The recommended summary
+for a bug is "www-servers/nginx: please add module MODULE_NAME",= where
+MODULE_NAME is the name of the module you would like to see added.
+
+Removed modules:
+=C2=A0 =C2=A0 - ngx_cache_purge/http_cache_purge_module
+=C2=A0 =C2=A0 - nginx_ngx_slowfs_cache/http_slowfs_cache_module
+=C2=A0 =C2=A0 - ngx-fancyindex/http_fancyindex_module
+=C2=A0 =C2=A0 - ngx_http_auth_pam_module/http_authpam_module
+=C2=A0 =C2=A0 - nginx_upstream_check_module/http_upstream_check_module
+=C2=A0 =C2=A0 - ngx_metrics/http_metrics_module
+=C2=A0 =C2=A0 - naxsi/http_naxsi_module
+=C2=A0 =C2=A0 - nginx-rtmp-module/rtmp_module
+=C2=A0 =C2=A0 - nginx-dav-ext-module/http_dav_ext_module
+=C2=A0 =C2=A0 - ModSecurity-nginx/http_security_module
+=C2=A0 =C2=A0 - nginx-push-stream-module/http_push_stream_module
+=C2=A0 =C2=A0 - nginx-sticky-module-ng/http_sticky_module
+=C2=A0 =C2=A0 - nginx-mogilefs-module/http_mogilefs_module
+=C2=A0 =C2=A0 - nginx-auth-ldap/http_auth_ldap_module
+=C2=A0 =C2=A0 - nginx-vod-module/http_vod_module
+=C2=A0 =C2=A0 - ngx_http_geoip2_module/http_geoip2_module
+
+2. USE flags.
+
+Some USE flags, like "http-cache", "ktls", "pcre&= quot;, "pcre-jit" and so on,
+have been removed. They did not have any effect or served no purpose,
+thus you need not worry about them.
+
+The "http2", "http3" use flags have been renamed to +nginx_modules_http_v2 and nginx_modules_http_v3 respectively. They
+correspond to NGINX_MODULES_HTTP "v2" and "v3" USE_EXP= AND flags
+accordingly. "ssl" use flag has been changed into individual &qu= ot;ssl"
+USE_EXPAND flags for the mail, stream and HTTP servers.
+
+Thread pool support[4], previously toggled by the "threads" USE = flag, is
+now enabled unconditionally. Vim syntax files are now provided by the
+main www-servers/nginx package.
+
+3. Default log files.
+
+Default log filenames are now error.log and access.log, instead of
+error_log and access_log.
+
+User Action Required
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+If you use any third-party modules, install the new separate package.
+For instance, if you previously enabled the nginx_modules_http_lua USE
+flag on www-servers/nginx, here is how you install the new Lua module
+package.
+
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 emerge www-nginx/ngx-lua-module
+
+To list all the available module packages, use
+
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 emerge --search @www-nginx | less
+
+If you use the "http2" or "http3" USE flags, enable th= e corresponding
+USE_EXPAND flags. To enable http2 only:
+
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 echo 'www-servers/nginx NGINX_MODULES_HTTP= : v2' >> \
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 /etc/portage/package.use/nginx.u= se
+
+To enable http3:
+
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 echo 'www-servers/nginx NGINX_MODULES_HTTP= : v3' >> \
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 /etc/portage/package.use/nginx.u= se
+
+To enable both http2 and http3:
+
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 echo 'www-servers/nginx NGINX_MODULES_HTTP= : v2 v3' >> \
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 /etc/portage/package.use/nginx.u= se
+
+SSL/TLS modules are enabled by default. If you wish to disable them, use +the following command.
+
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 echo www-servers/nginx NGINX_MODULES_HTTP: -ss= l \
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 NGINX_MODULES_STREAM: -ssl \
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 NGINX_MODULES_MAIL: -ssl >>= ; \
+=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 /etc/portage/package.use/nginx.u= se
+
+The updated NGINX comes with a new logrotate file that points to the new +log filenames. If any of your scripts rely on the old log files, change +them accordingly as needed.
+
+[1]: https://github.com/gentoo/gentoo/pull/37590
+[2]: https://bugs.gentoo.org/
+[3]: https://wiki.gentoo.org/wiki/Bugzilla/Bu= g_report_guide
+[4]: https://nginx.org/en/docs/ngx_core_m= odule.html#thread_pool
--
2.45.3



Please = keep these modules:
- nginx_upstream_check_module/http_upstream_c= heck_module
- ModSecurity-nginx/http_security_module
- ngx_http_geoip= 2_module/http_geoip2_module

Thank you,
Tomas
=C2=A0
--000000000000fce2fc062f34e337--