Supply pages into a pager owned VMO.
#include <zircon/syscalls.h> zx_status_t zx_pager_supply_pages(zx_handle_t pager, zx_handle_t pager_vmo, uint64_t offset, uint64_t length, zx_handle_t aux_vmo, uint64_t aux_offset);
Moves the pages of aux_vmo in the range [aux_offset, aux_offset + length) to pager_vmo in the range [offset, offset + length). Any pages in pager_vmo in the specified range will not be replaced; instead the corresponding pages from aux_vmo will be freed. aux_vmo must have been created by zx_vmo_create()
, must have no children, and must have no pinned pages in the specified range. Any uncommitted pages in aux_vmo will cause zero pages, or equivalent, to be inserted into pager_vmo. After this operation, the specified region of aux_vmo will be fully decommitted.
pager must be of type ZX_OBJ_TYPE_PAGER and have ZX_RIGHT_MANAGE_VMO.
pager_vmo must be of type ZX_OBJ_TYPE_VMO and have ZX_RIGHT_WRITE.
aux_vmo must be of type ZX_OBJ_TYPE_VMO and have ZX_RIGHT_WRITE.
zx_pager_supply_pages()
returns ZX_OK on success, or one of the following error codes on failure. On failure the specified range of aux_vmo may be either untouched or fully decommitted. If aux_vmo is decommitted, then an unspecified number of pages in pager_vmo will have been populated.
ZX_ERR_BAD_HANDLE pager, pager_vmo, or aux_vmo is not a valid handle.
ZX_ERR_WRONG_TYPE pager is not a pager handle, pager_vmo is not a VMO handle, or aux_vmo is not a VMO handle.
ZX_ERR_INVALID_ARGS pager_vmo is not a VMO created from pager, or offset, size, or aux_offset is not page aligned.
ZX_ERR_ACCESS_DENIED pager does not have ZX_RIGHT_MANAGE_VMO, or aux_vmo does not have ZX_RIGHT_WRITE, or pager_vmo does not have ZX_RIGHT_WRITE.
ZX_ERR_BAD_STATE aux_vmo is not in a state where it can supply the required pages, or pager_vmo has been detached from the pager.
ZX_ERR_NOT_SUPPORTED aux_vmo is a physical VMO or a contiguous VMO.
ZX_ERR_OUT_OF_RANGE The specified range in pager_vmo or aux_vmo is invalid.
ZX_ERR_NO_MEMORY Failure due to lack of memory.