NAME    [Toc]    [Back]

     vm_map_lookup, vm_map_lookup_done -- lookup the vm_object backing a given
     virtual region

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     vm_map(9)

AUTHORS    [Toc]    [Back]

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


				 July 19, 2003