Re: UPDATING stuff

From: Alexander Leidinger <Alexander_at_Leidinger.net>
Date: Mon, 25 Aug 2025 09:11:51 UTC
Am 2025-08-25 10:44, schrieb Marcin Cieslak:
> On Thu, 21 Aug 2025, Alexander Leidinger wrote:
> 
>>>> COMPAT_FREEBSD14?  (Recently [gs]etgroups were changed, with 
>>>> compatibility syscalls moved to COMPAT_FREEBSD14).
>> 
>> UPDATING only mentions VMM stuff for COMPAT_FREEBSD14. I give this a 
>> try tomorrow. But would this also affect the zfs dataset stuff?
> 
> This thread could have been a simple UPDATING update.  I think this is 
> the fourth
> time or so I have run into problems, because the changes were not 
> explained.
> 
> UPDATING entry on VMM got only there after I've spent 2 days+ 
> troubleshooting
> my wifibox failures.
> 
> When I read your message I was immediately thinking you might need 
> "COMPAT_FREEBSD14",
> but, again, I couldn't find any obvious entry neither in the docs nor 
> in
> the git log I was looking at.
> 
> @glebus - maybe during the stabilization effort the changes done to the 
> tree
> could be reviewed and documented?
> 
>  - where the FreeBSD_version got bumped and why

This is normally documented in 
https://docs.freebsd.org/en/books/porters-handbook/versions/ (intended 
to be updated at the time when the FreeBSD_versions is increased), but I 
can agree that the info there is a bit terse sometimes.

>  - ABI changes
>  - ....
> 
> For example it could be useful to be able to find the information "what
> does COMPAT_FREEBSD14 do exactly" in the UPDATING/release notes file.
> Otherwise I can't be sure if I need that option or "is my system fresh 
> enough"
> to remove it from the kernel.

What do you think about this?
diff --git UPDATING UPDATING
index ddb2e7603b2a..e197940c6431 100644
--- UPDATING
+++ UPDATING
@@ -73,6 +73,12 @@ NOTE TO PEOPLE WHO THINK THAT FreeBSD 15.x IS SLOW:
         If you only have FreeBSD-sendmail installed for applications 
that
         require libmilter, you can now remove it.

+20250815:
+       The [gs}etgroups(2)syscalls have changed. To maintain backwards
+       compatibility with existing programs, you need COMPAT_FREEBSD14 
in
+       your kernel config until all applications which use this are
+       rebuild/reinstalled.
+
  20250815:
         jemalloc 5.3.0 has been committed to the tree.

Bye,
Alexander.

-- 
http://www.Leidinger.net Alexander@Leidinger.net: PGP 0x8F31830F9F2772BF
http://www.FreeBSD.org    netchild@FreeBSD.org  : PGP 0x8F31830F9F2772BF