From 95b71a659a9bdc6e9071d80c7369a935c2bc16f4 Mon Sep 17 00:00:00 2001
From: Ed Maste <emaste@FreeBSD.org>
Date: Thu, 14 Nov 2024 21:29:49 -0500
Subject: [PATCH] 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
---
 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 .