git: caabdb3aefdc - main - contigmalloc.9: Note that M_WAITOK may still return NULL
Date: Tue, 21 Jul 2026 18:28:06 UTC
The branch main has been updated by emaste:
URL: https://cgit.FreeBSD.org/src/commit/?id=caabdb3aefdc45cae90203210034086801fa9005
commit caabdb3aefdc45cae90203210034086801fa9005
Author: Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2026-07-21 18:10:00 +0000
Commit: Ed Maste <emaste@FreeBSD.org>
CommitDate: 2026-07-21 18:27:47 +0000
contigmalloc.9: Note that M_WAITOK may still return NULL
Reviewed by: markj, bapt
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D58382
---
share/man/man9/contigmalloc.9 | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)
diff --git a/share/man/man9/contigmalloc.9 b/share/man/man9/contigmalloc.9
index 2e5d55ae8ba1..a9ebaf100eb9 100644
--- a/share/man/man9/contigmalloc.9
+++ b/share/man/man9/contigmalloc.9
@@ -23,7 +23,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd July 26, 2024
+.Dd July 21, 2026
.Dt CONTIGMALLOC 9
.Os
.Sh NAME
@@ -124,6 +124,15 @@ function returns a kernel virtual address if allocation succeeds,
or
.Dv NULL
otherwise.
+Note that in contrast with
+.Xr malloc 9 ,
+.Fn contigmalloc
+may return
+.Dv NULL
+even if
+.Dv M_WAITOK
+is specified, if no physically congiguous range is available that meets the
+specified constraints.
.Sh EXAMPLES
.Bd -literal
void *p;