tail head cat sleep
QR code linking to this page

Manual Pages  — VM_MAP_SUBMAP

NAME

vm_map_submap – create a subordinate map

CONTENTS

SYNOPSIS

#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

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

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

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

SEE ALSO

vm_map(9), vm_map_find(9)

AUTHORS

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

VM_MAP_SUBMAP (9) July 19, 2003

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

Not only is UNIX dead, it's starting to smell really bad.
— Rob Pike