vmar_map - add a memory mapping
#include <zircon/syscalls.h> zx_status_t zx_vmar_map(zx_handle_t vmar, size_t vmar_offset, zx_handle_t vmo, uint64_t vmo_offset, size_t len, uint32_t map_flags, uintptr_t* mapped_addr)
Maps the given VMO into the given virtual memory address region. The mapping retains a reference to the underlying virtual memory object, which means closing the VMO handle does not remove the mapping added by this function.
map_flags is a bit vector of the following flags:
vmar_offset must be 0 if map_flags does not have ZX_VM_FLAG_SPECIFIC or ZX_VM_FLAG_SPECIFIC_OVERWRITE set. If neither of those flags are set, then the mapping will be assigned an offset at random by the kernel (with an allocator determined by policy set on the target VMAR).
vmar_map() returns ZX_OK and the absolute base address of the mapping (via mapped_addr) on success. In the event of failure, a negative error value is returned.
ZX_ERR_BAD_HANDLE vmar or vmo is not a valid handle.
ZX_ERR_WRONG_TYPE vmar or vmo is not a VMAR or VMO handle, respectively.
ZX_ERR_BAD_STATE vmar refers to a destroyed VMAR.
ZX_ERR_INVALID_ARGS mapped_addr or map_flags are not valid, vmar_offset is non-zero when neither ZX_VM_FLAG_SPECIFIC nor ZX_VM_FLAG_SPECIFIC_OVERWRITE are given, ZX_VM_FLAG_SPECIFIC_OVERWRITE and ZX_VM_FLAG_MAP_RANGE are both given, vmar_offset and len describe an unsatisfiable allocation due to exceeding the region bounds, vmar_offset or vmo_offset are not page-aligned, vmo_offset + ROUNDUP(len, PAGE_SIZE) overflows, or len is 0.
ZX_ERR_ACCESS_DENIED Insufficient privileges to make the requested mapping.
ZX_ERR_NO_MEMORY (Temporary) Failure due to lack of memory.
A virtual memory object can be larger than the address space, which means you should check for overflow before converting the uint64_t size of the VMO to vmar_map's size_t len parameter.