SYNOPSISIn sys/param.h In vm/vm.h In vm/vm_map.h Ft int Fo vm_map_submap Fa vm_map_t map vm_offset_t start vm_offset_t end vm_map_t submap Fc
DESCRIPTIONThe Fn vm_map_submap function marks the range bounded by Fa start and Fa end within the map Fa map as being handled by a subordinate map Fa sub_map .
It is generally called by the kernel memory allocator.
IMPLEMENTATION NOTESThis function is for internal use only.
Both maps must exist. The range must have been created with vm_map_find9 previously.
No other operations may have been performed on this range before calling this function. Only the Fn 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 Fa map , and then destroy the Fa sub_map . This procedure is not recommended.
RETURN VALUESThe Fn vm_map_submap function returns KERN_SUCCESS if successful.
Otherwise, it returns KERN_INVALID_ARGUMENT if the caller requested copy-on-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.
AUTHORSThis manual page was written by An Bruce M Simpson Aq [email protected] .