git: 811d05449bea - main - vm_page_alloc.9: Document VM_ALLOC_NORECLAIM

The branch main has been updated by markj:

URL: https://cgit.FreeBSD.org/src/commit/?id=811d05449bea1b3a6f0206afb4866623569071c7

commit 811d05449bea1b3a6f0206afb4866623569071c7
Author:     Mark Johnston <markj@FreeBSD.org>
AuthorDate: 2021-11-11 19:36:30 +0000
Commit:     Mark Johnston <markj@FreeBSD.org>
CommitDate: 2021-11-11 19:52:00 +0000

    vm_page_alloc.9: Document VM_ALLOC_NORECLAIM
    
    MFC after:      2 weeks
    Sponsored by:   The FreeBSD Foundation
---
 share/man/man9/vm_page_alloc.9 | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/share/man/man9/vm_page_alloc.9 b/share/man/man9/vm_page_alloc.9
index 1b587339b0cd..95463483c25c 100644
--- a/share/man/man9/vm_page_alloc.9
+++ b/share/man/man9/vm_page_alloc.9
@@ -30,7 +30,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 17, 2021
+.Dd November 11, 2021
 .Dt VM_PAGE_ALLOC 9
 .Os
 .Sh NAME
@@ -315,6 +315,16 @@ If this flag is specified, the
 .Dq noobj
 variants will return zeroed pages.
 The other allocator interfaces ignore this flag.
+.It Dv VM_ALLOC_NORECLAIM
+If this flag is specified and the request can not be immediately satisfied,
+the allocator will not attempt to break superpage reservations to satisfy the
+allocation.
+This may be useful when the overhead of scanning the reservation queue
+outweighs the cost of a failed allocation.
+This flag may be used only with the
+.Dq contig
+variants, and must not be specified in combination with
+.Dv VM_ALLOC_WAITOK .
 .It Dv VM_ALLOC_COUNT(n)
 Hint that at least
 .Fa n