# zx_pmt_unpin

## Summary

Unpin pages and revoke device access to them.

## Declaration

    #include <zircon/syscalls.h>

    zx_status_t zx_pmt_unpin(zx_handle_t handle);

## Description

`zx_pmt_unpin()` unpins pages that were previously pinned by [`zx_bti_pin()`](https://fuchsia.dev/reference/syscalls/bti_pin),
and revokes the access that was granted by the pin call.

Always consumes *handle* . It is invalid to use *handle* afterwards, including
to call [`zx_handle_close()`](https://fuchsia.dev/reference/syscalls/handle_close) on it.

## Rights

TODO(https://fxbug.dev/42107318)

## Return value

On success, `zx_pmt_unpin()` returns `ZX_OK`.
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 PMT handle.

## See also

- [`zx_bti_create()`](https://fuchsia.dev/reference/syscalls/bti_create)
- [`zx_bti_pin()`](https://fuchsia.dev/reference/syscalls/bti_pin)
- [`zx_bti_release_quarantine()`](https://fuchsia.dev/reference/syscalls/bti_release_quarantine)