From 11a4d4a1a0b2234f0458cc8d4ee20e84358abf3f Mon Sep 17 00:00:00 2001
From: dybucc <149513579+dybucc@users.noreply.github.com>
Date: Thu, 28 May 2026 09:35:15 +0200
Subject: [PATCH] refactor: annotate `RAND_MAX` unstable in FreeBSD

This symbol has been modified in the last few versions of FreeBSD. It
can possibly be assumed that the constant is likely to change upstream,
and users should likely be advised of its use.

The link in the doc comment is broken until rust-lang/libc#5179 gets merged.
---
 src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs | 3 +++
 src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs | 2 ++
 src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs | 2 ++
 src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs | 2 ++
 src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs | 2 ++
 5 files changed, 11 insertions(+)

diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs
index 6b333560d9fb..eaaeb405093b 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd11/mod.rs
@@ -262,7 +262,10 @@ s! {
 /// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const ELAST: c_int = 96;
 
+/// This symbols is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_fffd;
+
 pub const KI_NSPARE_PTR: usize = 6;
 pub const MINCORE_SUPER: c_int = 0x20;
 /// max length of devicename
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs
index 505e54b2d1e4..091351fb0751 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd12/mod.rs
@@ -303,6 +303,8 @@ s! {
     }
 }
 
+/// This symbols is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_fffd;
 
 /// This symbols is prone to change across releases upstream.
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs
index 731362a58e0b..ced4832f870c 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd13/mod.rs
@@ -316,6 +316,8 @@ s! {
     }
 }
 
+/// This symbols is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 
 /// This symbols is prone to change across releases upstream.
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs
index b61df3b1be17..a6c70d2f3b1f 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd14/mod.rs
@@ -318,6 +318,8 @@ s! {
     }
 }
 
+/// This symbols is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 
 /// This symbols is prone to change across releases upstream.
diff --git a/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs b/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs
index 7ea5c27eea34..f92c71649bcf 100644
--- a/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs
+++ b/src/unix/bsd/freebsdlike/freebsd/freebsd15/mod.rs
@@ -320,6 +320,8 @@ s! {
     }
 }
 
+/// This symbols is prone to change across releases upstream.
+/// See the [usage guidelines](crate::#usage-guidelines) for details and use.
 pub const RAND_MAX: c_int = 0x7fff_ffff;
 
 /// This symbols is prone to change across releases upstream.