vm_map_lookupvm_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
Fo vm_map_lookup
Fa vm_map_t *var_map vm_offset_t vaddr vm_prot_t fault_type
Fa vm_map_entry_t *out_entry vm_object_t *object vm_pindex_t *pindex
Fa vm_prot_t *out_prot boolean_t *wired
Fc Ft void
vm_map_lookup_done (vm_map_t map vm_map_entry_t entry);
DESCRIPTION
The
vm_map_lookup ();
function attempts to find the
Vt vm_object ,
page index and protection, for the given virtual address
Fa vaddr ,
in the map
Fa var_map ,
assuming a page fault of the type
Fa 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
Fa *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
Fa *object ,
Fa *pindex ,
Fa *out_prot ,
and
Fa *out_entry
arguments appropriately for the hypothetical page fault.
SEE ALSO
vm_map9
AUTHORS
This manual page was written by
An Bruce M Simpson Aq bms@spc.org .
