1# zx_bti_release_quarantine
2
3## NAME
4
5<!-- Updated by update-docs-from-abigen, do not edit. -->
6
7bti_release_quarantine - releases all quarantined PMTs
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_bti_release_quarantine(zx_handle_t handle);
17```
18
19## DESCRIPTION
20
21`zx_bti_release_quarantine()` releases all quarantined PMTs for the given BTI.
22This will release the PMTs' underlying references to VMOs and physical page
23pins.  The underlying physical pages may be eligible to be reallocated
24afterwards.
25
26## RIGHTS
27
28<!-- Updated by update-docs-from-abigen, do not edit. -->
29
30*handle* must be of type **ZX_OBJ_TYPE_BTI** and have **ZX_RIGHT_WRITE**.
31
32## RETURN VALUE
33
34`zx_bti_release_quarantine()` returns **ZX_OK** on success.
35In the event of failure, a negative error value is returned.
36
37## ERRORS
38
39**ZX_ERR_BAD_HANDLE**  *handle* is not a valid handle.
40
41**ZX_ERR_WRONG_TYPE**  *handle* is not a BTI handle.
42
43**ZX_ERR_ACCESS_DENIED** *handle* does not have the **ZX_RIGHT_WRITE** right.
44
45## SEE ALSO
46
47 - [`zx_bti_pin()`]
48 - [`zx_pmt_unpin()`]
49
50<!-- References updated by update-docs-from-abigen, do not edit. -->
51
52[`zx_bti_pin()`]: bti_pin.md
53[`zx_pmt_unpin()`]: pmt_unpin.md
54