git: 93a321b60750 - stable/14 - libc: Note that getentropy is nearly POSIX 2024

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Sun, 24 Nov 2024 16:46:27 UTC
The branch stable/14 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=93a321b60750df2900e0a856c5e7210276147816

commit 93a321b60750df2900e0a856c5e7210276147816
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2024-11-15 02:29:49 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2024-11-24 16:46:00 +0000

    libc: Note that getentropy is nearly POSIX 2024
    
    Our implementation currently diverges from POSIX 2024 in a couple of
    ways, as now noted in the BUGS section.
    
    Reviewed by:    brooks
    Sponsored by:   The FreeBSD Foundation
    Differential Revision: https://reviews.freebsd.org/D47589
    
    (cherry picked from commit 95b71a659a9bdc6e9071d80c7369a935c2bc16f4)
---
 lib/libc/gen/getentropy.3 | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/lib/libc/gen/getentropy.3 b/lib/libc/gen/getentropy.3
index 0a3ba3e25610..5bbbc80e2414 100644
--- a/lib/libc/gen/getentropy.3
+++ b/lib/libc/gen/getentropy.3
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd February 24, 2018
+.Dd November 20, 2024
 .Dt GETENTROPY 3
 .Os
 .Sh NAME
@@ -69,10 +69,8 @@ Too many bytes requested, or some other fatal error occurred.
 .Xr random 4
 .Sh STANDARDS
 .Fn getentropy
-is non-standard.
-It is present on
-.Ox
-and Linux.
+nearly conforms to
+.St -p1003.1-2024 .
 .Sh HISTORY
 The
 .Fn getentropy
@@ -82,3 +80,9 @@ The
 .Fx
 libc compatibility shim first appeared in
 .Fx 12.0 .
+.Sh BUGS
+.In limits.h
+does not define
+.Dv GETENTROPY_MAX .
+Some error values do not match
+.St -p1003.1-2024 .