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

       The vm_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

       vm_map(9)

AUTHORS

       This manual page was written by Bruce M Simpson <bms@spc.org>.

Debian                                            July 19, 2003                                 VM_MAP_LOOKUP(9)