Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 1 | /* |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 2 | * Copyright (c) 2017-2020, ARM Limited and Contributors. All rights reserved. |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 3 | * |
| 4 | * SPDX-License-Identifier: BSD-3-Clause |
| 5 | */ |
| 6 | |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 7 | #include <assert.h> |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 8 | #include <stdbool.h> |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 9 | |
Antonio Nino Diaz | e0f9063 | 2018-12-14 00:18:21 +0000 | [diff] [blame] | 10 | #include <arch.h> |
| 11 | #include <arch_helpers.h> |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 12 | |
Antonio Nino Diaz | e0f9063 | 2018-12-14 00:18:21 +0000 | [diff] [blame] | 13 | #include <lib/el3_runtime/pubsub_events.h> |
| 14 | #include <lib/extensions/amu.h> |
| 15 | #include <lib/extensions/amu_private.h> |
Antonio Nino Diaz | e0f9063 | 2018-12-14 00:18:21 +0000 | [diff] [blame] | 16 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 17 | #include <plat/common/platform.h> |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 18 | |
| 19 | static struct amu_ctx amu_ctxs[PLATFORM_CORE_COUNT]; |
| 20 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 21 | /* Check if AMUv1 for Armv8.4 or 8.6 is implemented */ |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 22 | bool amu_supported(void) |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 23 | { |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 24 | uint64_t features = read_id_aa64pfr0_el1() >> ID_AA64PFR0_AMU_SHIFT; |
| 25 | |
| 26 | features &= ID_AA64PFR0_AMU_MASK; |
| 27 | return ((features == 1U) || (features == 2U)); |
| 28 | } |
| 29 | |
| 30 | #if AMU_GROUP1_NR_COUNTERS |
| 31 | /* Check if group 1 counters is implemented */ |
| 32 | bool amu_group1_supported(void) |
| 33 | { |
| 34 | uint64_t features = read_amcfgr_el0() >> AMCFGR_EL0_NCG_SHIFT; |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 35 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 36 | return (features & AMCFGR_EL0_NCG_MASK) == 1U; |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 37 | } |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 38 | #endif |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 39 | |
| 40 | /* |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 41 | * Enable counters. This function is meant to be invoked |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 42 | * by the context management library before exiting from EL3. |
| 43 | */ |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 44 | void amu_enable(bool el2_unused) |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 45 | { |
| 46 | uint64_t v; |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 47 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 48 | if (!amu_supported()) { |
| 49 | INFO("AMU is not implemented\n"); |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 50 | return; |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 51 | } |
| 52 | |
| 53 | #if AMU_GROUP1_NR_COUNTERS |
| 54 | /* Check and set presence of group 1 counters */ |
| 55 | if (!amu_group1_supported()) { |
| 56 | ERROR("AMU Counter Group 1 is not implemented\n"); |
| 57 | panic(); |
| 58 | } |
| 59 | |
| 60 | /* Check number of group 1 counters */ |
| 61 | uint64_t cnt_num = (read_amcgcr_el0() >> AMCGCR_EL0_CG1NC_SHIFT) & |
| 62 | AMCGCR_EL0_CG1NC_MASK; |
| 63 | VERBOSE("%s%llu. %s%u\n", |
| 64 | "Number of AMU Group 1 Counters ", cnt_num, |
| 65 | "Requested number ", AMU_GROUP1_NR_COUNTERS); |
| 66 | |
| 67 | if (cnt_num < AMU_GROUP1_NR_COUNTERS) { |
| 68 | ERROR("%s%llu is less than %s%u\n", |
| 69 | "Number of AMU Group 1 Counters ", cnt_num, |
| 70 | "Requested number ", AMU_GROUP1_NR_COUNTERS); |
| 71 | panic(); |
| 72 | } |
| 73 | #endif |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 74 | |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 75 | if (el2_unused) { |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 76 | /* |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 77 | * CPTR_EL2.TAM: Set to zero so any accesses to |
| 78 | * the Activity Monitor registers do not trap to EL2. |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 79 | */ |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 80 | v = read_cptr_el2(); |
| 81 | v &= ~CPTR_EL2_TAM_BIT; |
| 82 | write_cptr_el2(v); |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 83 | } |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 84 | |
| 85 | /* |
| 86 | * CPTR_EL3.TAM: Set to zero so that any accesses to |
| 87 | * the Activity Monitor registers do not trap to EL3. |
| 88 | */ |
| 89 | v = read_cptr_el3(); |
| 90 | v &= ~TAM_BIT; |
| 91 | write_cptr_el3(v); |
| 92 | |
| 93 | /* Enable group 0 counters */ |
| 94 | write_amcntenset0_el0(AMU_GROUP0_COUNTERS_MASK); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 95 | |
| 96 | #if AMU_GROUP1_NR_COUNTERS |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 97 | /* Enable group 1 counters */ |
| 98 | write_amcntenset1_el0(AMU_GROUP1_COUNTERS_MASK); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 99 | #endif |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 100 | } |
| 101 | |
| 102 | /* Read the group 0 counter identified by the given `idx`. */ |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 103 | uint64_t amu_group0_cnt_read(unsigned int idx) |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 104 | { |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 105 | assert(amu_supported()); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 106 | assert(idx < AMU_GROUP0_NR_COUNTERS); |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 107 | |
| 108 | return amu_group0_cnt_read_internal(idx); |
| 109 | } |
| 110 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 111 | /* Write the group 0 counter identified by the given `idx` with `val` */ |
| 112 | void amu_group0_cnt_write(unsigned int idx, uint64_t val) |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 113 | { |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 114 | assert(amu_supported()); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 115 | assert(idx < AMU_GROUP0_NR_COUNTERS); |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 116 | |
| 117 | amu_group0_cnt_write_internal(idx, val); |
| 118 | isb(); |
| 119 | } |
| 120 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 121 | #if AMU_GROUP1_NR_COUNTERS |
| 122 | /* Read the group 1 counter identified by the given `idx` */ |
| 123 | uint64_t amu_group1_cnt_read(unsigned int idx) |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 124 | { |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 125 | assert(amu_supported()); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 126 | assert(amu_group1_supported()); |
| 127 | assert(idx < AMU_GROUP1_NR_COUNTERS); |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 128 | |
| 129 | return amu_group1_cnt_read_internal(idx); |
| 130 | } |
| 131 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 132 | /* Write the group 1 counter identified by the given `idx` with `val` */ |
| 133 | void amu_group1_cnt_write(unsigned int idx, uint64_t val) |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 134 | { |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 135 | assert(amu_supported()); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 136 | assert(amu_group1_supported()); |
| 137 | assert(idx < AMU_GROUP1_NR_COUNTERS); |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 138 | |
| 139 | amu_group1_cnt_write_internal(idx, val); |
| 140 | isb(); |
| 141 | } |
| 142 | |
| 143 | /* |
| 144 | * Program the event type register for the given `idx` with |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 145 | * the event number `val` |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 146 | */ |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 147 | void amu_group1_set_evtype(unsigned int idx, unsigned int val) |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 148 | { |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 149 | assert(amu_supported()); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 150 | assert(amu_group1_supported()); |
| 151 | assert(idx < AMU_GROUP1_NR_COUNTERS); |
Dimitris Papastamos | 525c37a | 2017-11-13 09:49:45 +0000 | [diff] [blame] | 152 | |
| 153 | amu_group1_set_evtype_internal(idx, val); |
| 154 | isb(); |
Dimitris Papastamos | e08005a | 2017-10-12 13:02:29 +0100 | [diff] [blame] | 155 | } |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 156 | #endif /* AMU_GROUP1_NR_COUNTERS */ |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 157 | |
| 158 | static void *amu_context_save(const void *arg) |
| 159 | { |
| 160 | struct amu_ctx *ctx = &amu_ctxs[plat_my_core_pos()]; |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 161 | unsigned int i; |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 162 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 163 | if (!amu_supported()) { |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 164 | return (void *)-1; |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 165 | } |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 166 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 167 | #if AMU_GROUP1_NR_COUNTERS |
| 168 | if (!amu_group1_supported()) { |
| 169 | return (void *)-1; |
| 170 | } |
| 171 | #endif |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 172 | /* Assert that group 0/1 counter configuration is what we expect */ |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 173 | assert(read_amcntenset0_el0() == AMU_GROUP0_COUNTERS_MASK); |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 174 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 175 | #if AMU_GROUP1_NR_COUNTERS |
| 176 | assert(read_amcntenset1_el0() == AMU_GROUP1_COUNTERS_MASK); |
| 177 | #endif |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 178 | /* |
| 179 | * Disable group 0/1 counters to avoid other observers like SCP sampling |
| 180 | * counter values from the future via the memory mapped view. |
| 181 | */ |
| 182 | write_amcntenclr0_el0(AMU_GROUP0_COUNTERS_MASK); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 183 | |
| 184 | #if AMU_GROUP1_NR_COUNTERS |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 185 | write_amcntenclr1_el0(AMU_GROUP1_COUNTERS_MASK); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 186 | #endif |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 187 | isb(); |
| 188 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 189 | /* Save all group 0 counters */ |
| 190 | for (i = 0U; i < AMU_GROUP0_NR_COUNTERS; i++) { |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 191 | ctx->group0_cnts[i] = amu_group0_cnt_read(i); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 192 | } |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 193 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 194 | #if AMU_GROUP1_NR_COUNTERS |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 195 | /* Save group 1 counters */ |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 196 | for (i = 0U; i < AMU_GROUP1_NR_COUNTERS; i++) { |
| 197 | if ((AMU_GROUP1_COUNTERS_MASK & (1U << i)) != 0U) { |
| 198 | ctx->group1_cnts[i] = amu_group1_cnt_read(i); |
| 199 | } |
| 200 | } |
| 201 | #endif |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 202 | return (void *)0; |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 203 | } |
| 204 | |
| 205 | static void *amu_context_restore(const void *arg) |
| 206 | { |
| 207 | struct amu_ctx *ctx = &amu_ctxs[plat_my_core_pos()]; |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 208 | unsigned int i; |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 209 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 210 | if (!amu_supported()) { |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 211 | return (void *)-1; |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 212 | } |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 213 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 214 | #if AMU_GROUP1_NR_COUNTERS |
| 215 | if (!amu_group1_supported()) { |
| 216 | return (void *)-1; |
| 217 | } |
| 218 | #endif |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 219 | /* Counters were disabled in `amu_context_save()` */ |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 220 | assert(read_amcntenset0_el0() == 0U); |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 221 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 222 | #if AMU_GROUP1_NR_COUNTERS |
| 223 | assert(read_amcntenset1_el0() == 0U); |
| 224 | #endif |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 225 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 226 | /* Restore all group 0 counters */ |
| 227 | for (i = 0U; i < AMU_GROUP0_NR_COUNTERS; i++) { |
| 228 | amu_group0_cnt_write(i, ctx->group0_cnts[i]); |
| 229 | } |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 230 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 231 | /* Restore group 0 counter configuration */ |
| 232 | write_amcntenset0_el0(AMU_GROUP0_COUNTERS_MASK); |
| 233 | |
| 234 | #if AMU_GROUP1_NR_COUNTERS |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 235 | /* Restore group 1 counters */ |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 236 | for (i = 0U; i < AMU_GROUP1_NR_COUNTERS; i++) { |
| 237 | if ((AMU_GROUP1_COUNTERS_MASK & (1U << i)) != 0U) { |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 238 | amu_group1_cnt_write(i, ctx->group1_cnts[i]); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 239 | } |
| 240 | } |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 241 | |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 242 | /* Restore group 1 counter configuration */ |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 243 | write_amcntenset1_el0(AMU_GROUP1_COUNTERS_MASK); |
Alexei Fedorov | 7e6306b | 2020-07-14 08:17:56 +0100 | [diff] [blame] | 244 | #endif |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 245 | |
Antonio Nino Diaz | 033b4bb | 2018-10-25 16:52:26 +0100 | [diff] [blame] | 246 | return (void *)0; |
Dimitris Papastamos | eaf3e6d | 2017-11-28 13:47:06 +0000 | [diff] [blame] | 247 | } |
| 248 | |
| 249 | SUBSCRIBE_TO_EVENT(psci_suspend_pwrdown_start, amu_context_save); |
| 250 | SUBSCRIBE_TO_EVENT(psci_suspend_pwrdown_finish, amu_context_restore); |