vm_map_check_protection(9) [linux man page]

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

NAME

     vm_map_check_protection -- check memory protection for a vm_map

SYNOPSIS

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

     boolean_t
     vm_map_check_protection(vm_map_t map, vm_offset_t start, vm_offset_t end, vm_prot_t protection);

DESCRIPTION

     The vm_map_check_protection() function asserts that the target map allows the specified privilege protection over the entire address range
     from start to end.  The region MUST be contiguous; no holes are allowed.

IMPLEMENTATION NOTES

     This code does not and SHOULD not check whether the contents of the region are accessible.  For example, a small file may be mapped into an
     address space which is significantly larger in size.

RETURN VALUES

     The vm_map_check_protection() function returns TRUE if the privilege is allowed; if it is not allowed, or if any other error occurred, the
     value FALSE is returned.

SEE ALSO

     munmap(2), vm_map(9), vm_map_protect(9)

AUTHORS

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

BSD
								   July 19, 2003							       BSD

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

NAME

     vm_map_protect -- apply protection bits to a virtual memory region

SYNOPSIS

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

     int
     vm_map_protect(vm_map_t map, vm_offset_t start, vm_offset_t end, vm_prot_t new_prot, boolean_t set_max);

DESCRIPTION

     The vm_map_protect() function sets the protection bits of the address region bounded by start and end within the map map to new_prot.

     If set_max is TRUE, new_prot is treated as the new max_protection setting for each underlying entry.  Otherwise, only the protection field is
     affected.

     The range MUST be contiguous, and MUST NOT contain sub-maps.

IMPLEMENTATION NOTES

     The function acquires a lock on the map for the duration, by calling vm_map_lock(9).

RETURN VALUES

     The vm_map_protect() function returns KERN_SUCCESS if the protection bits could be set successfully.

     If a sub-map entry was encountered in the range, KERN_INVALID_ARGUMENT is returned.  If the value of new_prot would exceed max_protection for
     an entry within the range, KERN_PROTECTION_FAILURE is returned.

SEE ALSO

     vm_map(9)

AUTHORS

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

BSD
								   July 19, 2003							       BSD