NAME    [Toc]    [Back]

     vm_map_submap -- create a subordinate map

SYNOPSIS    [Toc]    [Back]

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

     int
     vm_map_submap(vm_map_t map, vm_offset_t start, vm_offset_t end,
	 vm_map_t submap);

DESCRIPTION    [Toc]    [Back]

     The vm_map_submap() function marks the range bounded by start and end
     within the map map as being handled by a subordinate map sub_map.

     It is generally called by the kernel memory allocator.

IMPLEMENTATION NOTES    [Toc]    [Back]

     This function is for internal use only.

     Both maps must exist.  The range must have been created with
     vm_map_find(9) previously.

     No other operations may have been performed on this range before calling
     this function.  Only the vm_fault() operation may be performed within
     this range after calling this function.

     To remove a submapping, one must first remove the range from the parent
     map, and then destroy the sub_map.  This procedure is not recommended.

RETURN VALUES    [Toc]    [Back]

     The vm_map_submap() function returns KERN_SUCCESS if successful.

     Otherwise, it returns KERN_INVALID_ARGUMENT if the caller requested copyon-write
 flags, or if the range specified for the sub-map was out of
     range for the parent map, or if a NULL backing object was specified.

SEE ALSO    [Toc]    [Back]

     vm_map(9), vm_map_find(9)

AUTHORS    [Toc]    [Back]

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


				 July 19, 2003