zx_vmo_set_size

NAME

Resize a VMO object.

SYNOPSIS

#include <zircon/syscalls.h>

zx_status_t zx_vmo_set_size(zx_handle_t handle, uint64_t size);

DESCRIPTION

zx_vmo_set_size() sets the new size of a VMO object.

The size will be rounded up to the next page size boundary. Subsequent calls to zx_vmo_get_size() will return the rounded up size.

RIGHTS

handle must be of type ZX_OBJ_TYPE_VMO and have ZX_RIGHT_WRITE.

RETURN VALUE

zx_vmo_set_size() returns ZX_OK on success. In the event of failure, a negative error value is returned.

ERRORS

ZX_ERR_BAD_HANDLE handle is not a valid handle.

ZX_ERR_WRONG_TYPE handle is not a VMO handle.

ZX_ERR_ACCESS_DENIED handle does not have the ZX_RIGHT_WRITE right.

ZX_ERR_UNAVAILABLE The VMO was created with ZX_VMO_NON_RESIZABLE option.

ZX_ERR_OUT_OF_RANGE Requested size is too large.

ZX_ERR_NO_MEMORY Failure due to lack of system memory.

SEE ALSO