1# zx_pmt_unpin
2
3## NAME
4
5<!-- Updated by update-docs-from-abigen, do not edit. -->
6
7pmt_unpin - unpin pages and revoke device access to them
8
9## SYNOPSIS
10
11<!-- Updated by update-docs-from-abigen, do not edit. -->
12
13```
14#include <zircon/syscalls.h>
15
16zx_status_t zx_pmt_unpin(zx_handle_t handle);
17```
18
19## DESCRIPTION
20
21`zx_pmt_unpin()` unpins pages that were previously pinned by [`zx_bti_pin()`],
22and revokes the access that was granted by the pin call.
23
24Always consumes *handle*. It is invalid to use *handle* afterwards, including
25to call [`zx_handle_close()`] on it.
26
27## RIGHTS
28
29<!-- Updated by update-docs-from-abigen, do not edit. -->
30
31TODO(ZX-2399)
32
33## RETURN VALUE
34
35On success, `zx_pmt_unpin()` returns **ZX_OK**.
36In the event of failure, a negative error value is returned.
37
38## ERRORS
39
40**ZX_ERR_BAD_HANDLE**  *handle* is not a valid handle.
41
42**ZX_ERR_WRONG_TYPE**  *handle* is not a PMT handle.
43
44## SEE ALSO
45
46 - [`zx_bti_create()`]
47 - [`zx_bti_pin()`]
48 - [`zx_bti_release_quarantine()`]
49
50<!-- References updated by update-docs-from-abigen, do not edit. -->
51
52[`zx_bti_create()`]: bti_create.md
53[`zx_bti_pin()`]: bti_pin.md
54[`zx_bti_release_quarantine()`]: bti_release_quarantine.md
55[`zx_handle_close()`]: handle_close.md
56