vm_map_create(9) [debian man page]

VM_MAP_CREATE(9)					   BSD Kernel Developer's Manual					  VM_MAP_CREATE(9)

NAME

     vm_map_create -- create a new vm_map structure

SYNOPSIS

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

     vm_map_t
     vm_map_create(pmap_t pmap, vm_offset_t min, vm_offset_t max);

DESCRIPTION

     The vm_map_create() function creates and returns a new, empty map structure, associated with the physical map pmap, and with the upper and
     lower address bounds specified by max and min respectively.

IMPLEMENTATION NOTES

     The kernel's zone allocator is used to allocate the map.

RETURN VALUES

     The vm_map_create() function returns a pointer to the newly allocated map if successful.  Otherwise, it returns NULL.

SEE ALSO

     pmap(9), vm_map(9), vm_map_init(9)

AUTHORS

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

BSD
								   July 19, 2003							       BSD

VM_MAP_SUBMAP(9)					   BSD Kernel Developer's Manual					  VM_MAP_SUBMAP(9)

NAME

     vm_map_submap -- create a subordinate map

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 recom-
     mended.

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 <bms@spc.org>.

BSD
								   July 19, 2003							       BSD