man.bsd.lv manual page server

Manual Page Search Parameters

VM_PAGE_GRAB(9) Kernel Developer's Manual VM_PAGE_GRAB(9)

vm_page_grabreturns a page from an object

#include <sys/param.h>
#include <vm/vm.h>
#include <vm/vm_page.h>

vm_page_t
vm_page_grab(vm_object_t object, vm_pindex_t pindex, int allocflags);

The () function returns the page at pindex from the given object. If the page exists and is busy, vm_page_grab() will sleep while waiting for it. If the page does not exist, it is allocated. The function sleeps until the allocation request can be satisfied.

The function requires the object to be locked on entry, and returns with the object locked. If the () function sleeps for any reason, the object lock is temporary dropped.

The () supports all of the flags supported by vm_page_alloc(9). In addition, vm_page_grab() supports the following flags:

When waiting for the busy state of the existing page to drain, only test for exclusive busy; ignore the shared busy counter.

The vm_page_grab() always returns the page.

vm_page_alloc(9)

This manual page was written by Chad David <davidc@acns.ab.ca>.

August 23, 2013 FreeBSD-12.0