NAME
vm_map_lookup
,
vm_map_lookup_done
—
lookup the vm_object backing a given
virtual region
SYNOPSIS
#include
<sys/param.h>
#include <vm/vm.h>
#include <vm/vm_map.h>
int
vm_map_lookup
(vm_map_t *var_map,
vm_offset_t vaddr, vm_prot_t
fault_type, vm_map_entry_t *out_entry,
vm_object_t *object, vm_pindex_t
*pindex, vm_prot_t *out_prot,
boolean_t *wired);
void
vm_map_lookup_done
(vm_map_t
map, vm_map_entry_t
entry);
DESCRIPTION
Thevm_map_lookup
()
function attempts to find the vm_object, page index and
protection, for the given virtual address vaddr, in the
map var_map, assuming a page fault of the type
fault_type had occurred.
Return values are guaranteed until
vm_map_lookup_done
()
is called to release the lock.
IMPLEMENTATION NOTES
The function vm_map_lookup
() acquires a
read-lock on the map *var_map, but does not release
it. The caller should invoke vm_map_lookup_done
() in
order to release this lock.
RETURN VALUES
The vm_map_lookup
() function returns
KERN_SUCCESS
, and sets the
*object, *pindex,
*out_prot, and *out_entry
arguments appropriately for the hypothetical page fault.
SEE ALSO
AUTHORS
This manual page was written by Bruce M Simpson <bms@spc.org>.