Skip to content

Latest commit

 

History

History
59 lines (35 loc) · 1.26 KB

vmar_destroy.md

File metadata and controls

59 lines (35 loc) · 1.26 KB

zx_vmar_destroy

NAME

vmar_destroy - destroy a virtual memory address region

SYNOPSIS

#include <zircon/syscalls.h>

zx_status_t zx_vmar_destroy(zx_handle_t handle);

DESCRIPTION

zx_vmar_destroy() unmaps all mappings within the given region, and destroys all sub-regions of the region. Note that this operation is logically recursive.

This operation does not close handle. Any outstanding handles to this VMAR will remain valid handles, but all VMAR operations on them will fail.

RIGHTS

TODO(ZX-2399)

RETURN VALUE

zx_vmar_destroy() returns ZX_OK on success.

ERRORS

ZX_ERR_BAD_HANDLE handle is not a valid handle.

ZX_ERR_WRONG_TYPE handle is not a VMAR handle.

ZX_ERR_BAD_STATE This region is already destroyed.

NOTES

SEE ALSO