| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 1 | /* | 
|  | 2 | * This program is free software; you can redistribute it and/or modify | 
|  | 3 | * it under the terms of the GNU General Public License, version 2, as | 
|  | 4 | * published by the Free Software Foundation. | 
|  | 5 | * | 
|  | 6 | * This program is distributed in the hope that it will be useful, | 
|  | 7 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | 
|  | 8 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
|  | 9 | * GNU General Public License for more details. | 
|  | 10 | * | 
|  | 11 | * You should have received a copy of the GNU General Public License | 
|  | 12 | * along with this program; if not, write to the Free Software | 
|  | 13 | * Foundation, 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA. | 
|  | 14 | * | 
|  | 15 | * Copyright IBM Corp. 2007 | 
|  | 16 | * | 
|  | 17 | * Authors: Hollis Blanchard <hollisb@us.ibm.com> | 
|  | 18 | */ | 
|  | 19 |  | 
|  | 20 | #include <linux/types.h> | 
|  | 21 | #include <linux/string.h> | 
| Jerone Young | 31711f2 | 2008-07-14 14:00:03 +0200 | [diff] [blame] | 22 | #include <linux/kvm.h> | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 23 | #include <linux/kvm_host.h> | 
|  | 24 | #include <linux/highmem.h> | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 25 |  | 
|  | 26 | #include <asm/tlbflush.h> | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 27 | #include <asm/mmu-44x.h> | 
|  | 28 | #include <asm/kvm_ppc.h> | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 29 | #include <asm/kvm_44x.h> | 
| Hollis Blanchard | 73e75b4 | 2008-12-02 15:51:57 -0600 | [diff] [blame] | 30 | #include "timing.h" | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 31 |  | 
|  | 32 | #include "44x_tlb.h" | 
| Marcelo Tosatti | 46f43c6 | 2009-06-18 11:47:27 -0300 | [diff] [blame] | 33 | #include "trace.h" | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 34 |  | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 35 | #ifndef PPC44x_TLBE_SIZE | 
|  | 36 | #define PPC44x_TLBE_SIZE	PPC44x_TLB_4K | 
|  | 37 | #endif | 
|  | 38 |  | 
|  | 39 | #define PAGE_SIZE_4K (1<<12) | 
|  | 40 | #define PAGE_MASK_4K (~(PAGE_SIZE_4K - 1)) | 
|  | 41 |  | 
| Hollis Blanchard | df9b856 | 2008-11-10 14:57:35 -0600 | [diff] [blame] | 42 | #define PPC44x_TLB_UATTR_MASK \ | 
|  | 43 | (PPC44x_TLB_U0|PPC44x_TLB_U1|PPC44x_TLB_U2|PPC44x_TLB_U3) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 44 | #define PPC44x_TLB_USER_PERM_MASK (PPC44x_TLB_UX|PPC44x_TLB_UR|PPC44x_TLB_UW) | 
|  | 45 | #define PPC44x_TLB_SUPER_PERM_MASK (PPC44x_TLB_SX|PPC44x_TLB_SR|PPC44x_TLB_SW) | 
|  | 46 |  | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 47 | #ifdef DEBUG | 
|  | 48 | void kvmppc_dump_tlbs(struct kvm_vcpu *vcpu) | 
|  | 49 | { | 
| Hollis Blanchard | 0b3bafc | 2010-08-07 10:33:57 -0700 | [diff] [blame] | 50 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 51 | struct kvmppc_44x_tlbe *tlbe; | 
|  | 52 | int i; | 
|  | 53 |  | 
|  | 54 | printk("vcpu %d TLB dump:\n", vcpu->vcpu_id); | 
|  | 55 | printk("| %2s | %3s | %8s | %8s | %8s |\n", | 
|  | 56 | "nr", "tid", "word0", "word1", "word2"); | 
|  | 57 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 58 | for (i = 0; i < ARRAY_SIZE(vcpu_44x->guest_tlb); i++) { | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 59 | tlbe = &vcpu_44x->guest_tlb[i]; | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 60 | if (tlbe->word0 & PPC44x_TLB_VALID) | 
|  | 61 | printk(" G%2d |  %02X | %08X | %08X | %08X |\n", | 
|  | 62 | i, tlbe->tid, tlbe->word0, tlbe->word1, | 
|  | 63 | tlbe->word2); | 
|  | 64 | } | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 65 | } | 
|  | 66 | #endif | 
|  | 67 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 68 | static inline void kvmppc_44x_tlbie(unsigned int index) | 
|  | 69 | { | 
|  | 70 | /* 0 <= index < 64, so the V bit is clear and we can use the index as | 
|  | 71 | * word0. */ | 
|  | 72 | asm volatile( | 
|  | 73 | "tlbwe %[index], %[index], 0\n" | 
|  | 74 | : | 
|  | 75 | : [index] "r"(index) | 
|  | 76 | ); | 
|  | 77 | } | 
|  | 78 |  | 
| Hollis Blanchard | c5fbdff | 2008-12-02 15:51:56 -0600 | [diff] [blame] | 79 | static inline void kvmppc_44x_tlbre(unsigned int index, | 
|  | 80 | struct kvmppc_44x_tlbe *tlbe) | 
|  | 81 | { | 
|  | 82 | asm volatile( | 
|  | 83 | "tlbre %[word0], %[index], 0\n" | 
|  | 84 | "mfspr %[tid], %[sprn_mmucr]\n" | 
|  | 85 | "andi. %[tid], %[tid], 0xff\n" | 
|  | 86 | "tlbre %[word1], %[index], 1\n" | 
|  | 87 | "tlbre %[word2], %[index], 2\n" | 
|  | 88 | : [word0] "=r"(tlbe->word0), | 
|  | 89 | [word1] "=r"(tlbe->word1), | 
|  | 90 | [word2] "=r"(tlbe->word2), | 
|  | 91 | [tid]   "=r"(tlbe->tid) | 
|  | 92 | : [index] "r"(index), | 
|  | 93 | [sprn_mmucr] "i"(SPRN_MMUCR) | 
|  | 94 | : "cc" | 
|  | 95 | ); | 
|  | 96 | } | 
|  | 97 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 98 | static inline void kvmppc_44x_tlbwe(unsigned int index, | 
|  | 99 | struct kvmppc_44x_tlbe *stlbe) | 
|  | 100 | { | 
|  | 101 | unsigned long tmp; | 
|  | 102 |  | 
|  | 103 | asm volatile( | 
|  | 104 | "mfspr %[tmp], %[sprn_mmucr]\n" | 
|  | 105 | "rlwimi %[tmp], %[tid], 0, 0xff\n" | 
|  | 106 | "mtspr %[sprn_mmucr], %[tmp]\n" | 
|  | 107 | "tlbwe %[word0], %[index], 0\n" | 
|  | 108 | "tlbwe %[word1], %[index], 1\n" | 
|  | 109 | "tlbwe %[word2], %[index], 2\n" | 
|  | 110 | : [tmp]   "=&r"(tmp) | 
|  | 111 | : [word0] "r"(stlbe->word0), | 
|  | 112 | [word1] "r"(stlbe->word1), | 
|  | 113 | [word2] "r"(stlbe->word2), | 
|  | 114 | [tid]   "r"(stlbe->tid), | 
|  | 115 | [index] "r"(index), | 
|  | 116 | [sprn_mmucr] "i"(SPRN_MMUCR) | 
|  | 117 | ); | 
|  | 118 | } | 
|  | 119 |  | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 120 | static u32 kvmppc_44x_tlb_shadow_attrib(u32 attrib, int usermode) | 
|  | 121 | { | 
| Hollis Blanchard | df9b856 | 2008-11-10 14:57:35 -0600 | [diff] [blame] | 122 | /* We only care about the guest's permission and user bits. */ | 
|  | 123 | attrib &= PPC44x_TLB_PERM_MASK|PPC44x_TLB_UATTR_MASK; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 124 |  | 
|  | 125 | if (!usermode) { | 
|  | 126 | /* Guest is in supervisor mode, so we need to translate guest | 
|  | 127 | * supervisor permissions into user permissions. */ | 
|  | 128 | attrib &= ~PPC44x_TLB_USER_PERM_MASK; | 
|  | 129 | attrib |= (attrib & PPC44x_TLB_SUPER_PERM_MASK) << 3; | 
|  | 130 | } | 
|  | 131 |  | 
|  | 132 | /* Make sure host can always access this memory. */ | 
|  | 133 | attrib |= PPC44x_TLB_SX|PPC44x_TLB_SR|PPC44x_TLB_SW; | 
|  | 134 |  | 
| Hollis Blanchard | df9b856 | 2008-11-10 14:57:35 -0600 | [diff] [blame] | 135 | /* WIMGE = 0b00100 */ | 
|  | 136 | attrib |= PPC44x_TLB_M; | 
|  | 137 |  | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 138 | return attrib; | 
|  | 139 | } | 
|  | 140 |  | 
| Hollis Blanchard | c5fbdff | 2008-12-02 15:51:56 -0600 | [diff] [blame] | 141 | /* Load shadow TLB back into hardware. */ | 
|  | 142 | void kvmppc_44x_tlb_load(struct kvm_vcpu *vcpu) | 
|  | 143 | { | 
|  | 144 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
|  | 145 | int i; | 
|  | 146 |  | 
|  | 147 | for (i = 0; i <= tlb_44x_hwater; i++) { | 
|  | 148 | struct kvmppc_44x_tlbe *stlbe = &vcpu_44x->shadow_tlb[i]; | 
|  | 149 |  | 
|  | 150 | if (get_tlb_v(stlbe) && get_tlb_ts(stlbe)) | 
|  | 151 | kvmppc_44x_tlbwe(i, stlbe); | 
|  | 152 | } | 
|  | 153 | } | 
|  | 154 |  | 
|  | 155 | static void kvmppc_44x_tlbe_set_modified(struct kvmppc_vcpu_44x *vcpu_44x, | 
|  | 156 | unsigned int i) | 
|  | 157 | { | 
|  | 158 | vcpu_44x->shadow_tlb_mod[i] = 1; | 
|  | 159 | } | 
|  | 160 |  | 
|  | 161 | /* Save hardware TLB to the vcpu, and invalidate all guest mappings. */ | 
|  | 162 | void kvmppc_44x_tlb_put(struct kvm_vcpu *vcpu) | 
|  | 163 | { | 
|  | 164 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
|  | 165 | int i; | 
|  | 166 |  | 
|  | 167 | for (i = 0; i <= tlb_44x_hwater; i++) { | 
|  | 168 | struct kvmppc_44x_tlbe *stlbe = &vcpu_44x->shadow_tlb[i]; | 
|  | 169 |  | 
|  | 170 | if (vcpu_44x->shadow_tlb_mod[i]) | 
|  | 171 | kvmppc_44x_tlbre(i, stlbe); | 
|  | 172 |  | 
|  | 173 | if (get_tlb_v(stlbe) && get_tlb_ts(stlbe)) | 
|  | 174 | kvmppc_44x_tlbie(i); | 
|  | 175 | } | 
|  | 176 | } | 
|  | 177 |  | 
|  | 178 |  | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 179 | /* Search the guest TLB for a matching entry. */ | 
|  | 180 | int kvmppc_44x_tlb_index(struct kvm_vcpu *vcpu, gva_t eaddr, unsigned int pid, | 
|  | 181 | unsigned int as) | 
|  | 182 | { | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 183 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 184 | int i; | 
|  | 185 |  | 
|  | 186 | /* XXX Replace loop with fancy data structures. */ | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 187 | for (i = 0; i < ARRAY_SIZE(vcpu_44x->guest_tlb); i++) { | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 188 | struct kvmppc_44x_tlbe *tlbe = &vcpu_44x->guest_tlb[i]; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 189 | unsigned int tid; | 
|  | 190 |  | 
|  | 191 | if (eaddr < get_tlb_eaddr(tlbe)) | 
|  | 192 | continue; | 
|  | 193 |  | 
|  | 194 | if (eaddr > get_tlb_end(tlbe)) | 
|  | 195 | continue; | 
|  | 196 |  | 
|  | 197 | tid = get_tlb_tid(tlbe); | 
|  | 198 | if (tid && (tid != pid)) | 
|  | 199 | continue; | 
|  | 200 |  | 
|  | 201 | if (!get_tlb_v(tlbe)) | 
|  | 202 | continue; | 
|  | 203 |  | 
|  | 204 | if (get_tlb_ts(tlbe) != as) | 
|  | 205 | continue; | 
|  | 206 |  | 
|  | 207 | return i; | 
|  | 208 | } | 
|  | 209 |  | 
|  | 210 | return -1; | 
|  | 211 | } | 
|  | 212 |  | 
| Hollis Blanchard | be8d1ca | 2009-01-03 16:23:02 -0600 | [diff] [blame] | 213 | gpa_t kvmppc_mmu_xlate(struct kvm_vcpu *vcpu, unsigned int gtlb_index, | 
|  | 214 | gva_t eaddr) | 
|  | 215 | { | 
|  | 216 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
|  | 217 | struct kvmppc_44x_tlbe *gtlbe = &vcpu_44x->guest_tlb[gtlb_index]; | 
|  | 218 | unsigned int pgmask = get_tlb_bytes(gtlbe) - 1; | 
|  | 219 |  | 
|  | 220 | return get_tlb_raddr(gtlbe) | (eaddr & pgmask); | 
|  | 221 | } | 
|  | 222 |  | 
| Hollis Blanchard | fa86b8d | 2009-01-03 16:23:03 -0600 | [diff] [blame] | 223 | int kvmppc_mmu_itlb_index(struct kvm_vcpu *vcpu, gva_t eaddr) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 224 | { | 
| Alexander Graf | 666e725 | 2010-07-29 14:47:43 +0200 | [diff] [blame] | 225 | unsigned int as = !!(vcpu->arch.shared->msr & MSR_IS); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 226 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 227 | return kvmppc_44x_tlb_index(vcpu, eaddr, vcpu->arch.pid, as); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 228 | } | 
|  | 229 |  | 
| Hollis Blanchard | fa86b8d | 2009-01-03 16:23:03 -0600 | [diff] [blame] | 230 | int kvmppc_mmu_dtlb_index(struct kvm_vcpu *vcpu, gva_t eaddr) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 231 | { | 
| Alexander Graf | 666e725 | 2010-07-29 14:47:43 +0200 | [diff] [blame] | 232 | unsigned int as = !!(vcpu->arch.shared->msr & MSR_DS); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 233 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 234 | return kvmppc_44x_tlb_index(vcpu, eaddr, vcpu->arch.pid, as); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 235 | } | 
|  | 236 |  | 
| Hollis Blanchard | b52a638 | 2009-01-03 16:23:11 -0600 | [diff] [blame] | 237 | void kvmppc_mmu_itlb_miss(struct kvm_vcpu *vcpu) | 
|  | 238 | { | 
|  | 239 | } | 
|  | 240 |  | 
|  | 241 | void kvmppc_mmu_dtlb_miss(struct kvm_vcpu *vcpu) | 
|  | 242 | { | 
|  | 243 | } | 
|  | 244 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 245 | static void kvmppc_44x_shadow_release(struct kvmppc_vcpu_44x *vcpu_44x, | 
|  | 246 | unsigned int stlb_index) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 247 | { | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 248 | struct kvmppc_44x_shadow_ref *ref = &vcpu_44x->shadow_refs[stlb_index]; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 249 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 250 | if (!ref->page) | 
|  | 251 | return; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 252 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 253 | /* Discard from the TLB. */ | 
|  | 254 | /* Note: we could actually invalidate a host mapping, if the host overwrote | 
|  | 255 | * this TLB entry since we inserted a guest mapping. */ | 
|  | 256 | kvmppc_44x_tlbie(stlb_index); | 
|  | 257 |  | 
|  | 258 | /* Now release the page. */ | 
|  | 259 | if (ref->writeable) | 
|  | 260 | kvm_release_page_dirty(ref->page); | 
|  | 261 | else | 
|  | 262 | kvm_release_page_clean(ref->page); | 
|  | 263 |  | 
|  | 264 | ref->page = NULL; | 
|  | 265 |  | 
|  | 266 | /* XXX set tlb_44x_index to stlb_index? */ | 
|  | 267 |  | 
| Marcelo Tosatti | 46f43c6 | 2009-06-18 11:47:27 -0300 | [diff] [blame] | 268 | trace_kvm_stlb_inval(stlb_index); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 269 | } | 
|  | 270 |  | 
| Hollis Blanchard | ecc0981 | 2009-01-03 16:22:59 -0600 | [diff] [blame] | 271 | void kvmppc_mmu_destroy(struct kvm_vcpu *vcpu) | 
| Hollis Blanchard | c30f8a6 | 2008-11-24 11:37:38 -0600 | [diff] [blame] | 272 | { | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 273 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | c30f8a6 | 2008-11-24 11:37:38 -0600 | [diff] [blame] | 274 | int i; | 
|  | 275 |  | 
|  | 276 | for (i = 0; i <= tlb_44x_hwater; i++) | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 277 | kvmppc_44x_shadow_release(vcpu_44x, i); | 
| Hollis Blanchard | 83aae4a | 2008-07-25 13:54:52 -0500 | [diff] [blame] | 278 | } | 
|  | 279 |  | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 280 | /** | 
|  | 281 | * kvmppc_mmu_map -- create a host mapping for guest memory | 
|  | 282 | * | 
|  | 283 | * If the guest wanted a larger page than the host supports, only the first | 
|  | 284 | * host page is mapped here and the rest are demand faulted. | 
|  | 285 | * | 
|  | 286 | * If the guest wanted a smaller page than the host page size, we map only the | 
|  | 287 | * guest-size page (i.e. not a full host page mapping). | 
|  | 288 | * | 
|  | 289 | * Caller must ensure that the specified guest TLB entry is safe to insert into | 
|  | 290 | * the shadow TLB. | 
|  | 291 | */ | 
| Hollis Blanchard | 58a9621 | 2009-01-03 16:23:01 -0600 | [diff] [blame] | 292 | void kvmppc_mmu_map(struct kvm_vcpu *vcpu, u64 gvaddr, gpa_t gpaddr, | 
|  | 293 | unsigned int gtlb_index) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 294 | { | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 295 | struct kvmppc_44x_tlbe stlbe; | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 296 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | 58a9621 | 2009-01-03 16:23:01 -0600 | [diff] [blame] | 297 | struct kvmppc_44x_tlbe *gtlbe = &vcpu_44x->guest_tlb[gtlb_index]; | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 298 | struct kvmppc_44x_shadow_ref *ref; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 299 | struct page *new_page; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 300 | hpa_t hpaddr; | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 301 | gfn_t gfn; | 
| Hollis Blanchard | 58a9621 | 2009-01-03 16:23:01 -0600 | [diff] [blame] | 302 | u32 asid = gtlbe->tid; | 
|  | 303 | u32 flags = gtlbe->word2; | 
|  | 304 | u32 max_bytes = get_tlb_bytes(gtlbe); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 305 | unsigned int victim; | 
|  | 306 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 307 | /* Select TLB entry to clobber. Indirectly guard against races with the TLB | 
|  | 308 | * miss handler by disabling interrupts. */ | 
|  | 309 | local_irq_disable(); | 
|  | 310 | victim = ++tlb_44x_index; | 
|  | 311 | if (victim > tlb_44x_hwater) | 
|  | 312 | victim = 0; | 
|  | 313 | tlb_44x_index = victim; | 
|  | 314 | local_irq_enable(); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 315 |  | 
|  | 316 | /* Get reference to new page. */ | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 317 | gfn = gpaddr >> PAGE_SHIFT; | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 318 | new_page = gfn_to_page(vcpu->kvm, gfn); | 
|  | 319 | if (is_error_page(new_page)) { | 
| Joerg Roedel | 5689cc5 | 2010-07-01 16:00:12 +0200 | [diff] [blame] | 320 | printk(KERN_ERR "Couldn't get guest page for gfn %llx!\n", | 
|  | 321 | (unsigned long long)gfn); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 322 | return; | 
|  | 323 | } | 
|  | 324 | hpaddr = page_to_phys(new_page); | 
|  | 325 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 326 | /* Invalidate any previous shadow mappings. */ | 
|  | 327 | kvmppc_44x_shadow_release(vcpu_44x, victim); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 328 |  | 
|  | 329 | /* XXX Make sure (va, size) doesn't overlap any other | 
|  | 330 | * entries. 440x6 user manual says the result would be | 
|  | 331 | * "undefined." */ | 
|  | 332 |  | 
|  | 333 | /* XXX what about AS? */ | 
|  | 334 |  | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 335 | /* Force TS=1 for all guest mappings. */ | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 336 | stlbe.word0 = PPC44x_TLB_VALID | PPC44x_TLB_TS; | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 337 |  | 
|  | 338 | if (max_bytes >= PAGE_SIZE) { | 
|  | 339 | /* Guest mapping is larger than or equal to host page size. We can use | 
|  | 340 | * a "native" host mapping. */ | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 341 | stlbe.word0 |= (gvaddr & PAGE_MASK) | PPC44x_TLBE_SIZE; | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 342 | } else { | 
|  | 343 | /* Guest mapping is smaller than host page size. We must restrict the | 
|  | 344 | * size of the mapping to be at most the smaller of the two, but for | 
|  | 345 | * simplicity we fall back to a 4K mapping (this is probably what the | 
|  | 346 | * guest is using anyways). */ | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 347 | stlbe.word0 |= (gvaddr & PAGE_MASK_4K) | PPC44x_TLB_4K; | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 348 |  | 
|  | 349 | /* 'hpaddr' is a host page, which is larger than the mapping we're | 
|  | 350 | * inserting here. To compensate, we must add the in-page offset to the | 
|  | 351 | * sub-page. */ | 
|  | 352 | hpaddr |= gpaddr & (PAGE_MASK ^ PAGE_MASK_4K); | 
|  | 353 | } | 
|  | 354 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 355 | stlbe.word1 = (hpaddr & 0xfffffc00) | ((hpaddr >> 32) & 0xf); | 
|  | 356 | stlbe.word2 = kvmppc_44x_tlb_shadow_attrib(flags, | 
| Alexander Graf | 666e725 | 2010-07-29 14:47:43 +0200 | [diff] [blame] | 357 | vcpu->arch.shared->msr & MSR_PR); | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 358 | stlbe.tid = !(asid & 0xff); | 
| Jerone Young | 31711f2 | 2008-07-14 14:00:03 +0200 | [diff] [blame] | 359 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 360 | /* Keep track of the reference so we can properly release it later. */ | 
|  | 361 | ref = &vcpu_44x->shadow_refs[victim]; | 
|  | 362 | ref->page = new_page; | 
|  | 363 | ref->gtlb_index = gtlb_index; | 
|  | 364 | ref->writeable = !!(stlbe.word2 & PPC44x_TLB_UW); | 
|  | 365 | ref->tid = stlbe.tid; | 
|  | 366 |  | 
|  | 367 | /* Insert shadow mapping into hardware TLB. */ | 
| Hollis Blanchard | c5fbdff | 2008-12-02 15:51:56 -0600 | [diff] [blame] | 368 | kvmppc_44x_tlbe_set_modified(vcpu_44x, victim); | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 369 | kvmppc_44x_tlbwe(victim, &stlbe); | 
| Marcelo Tosatti | 46f43c6 | 2009-06-18 11:47:27 -0300 | [diff] [blame] | 370 | trace_kvm_stlb_write(victim, stlbe.tid, stlbe.word0, stlbe.word1, | 
|  | 371 | stlbe.word2); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 372 | } | 
|  | 373 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 374 | /* For a particular guest TLB entry, invalidate the corresponding host TLB | 
|  | 375 | * mappings and release the host pages. */ | 
|  | 376 | static void kvmppc_44x_invalidate(struct kvm_vcpu *vcpu, | 
|  | 377 | unsigned int gtlb_index) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 378 | { | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 379 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 380 | int i; | 
|  | 381 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 382 | for (i = 0; i < ARRAY_SIZE(vcpu_44x->shadow_refs); i++) { | 
|  | 383 | struct kvmppc_44x_shadow_ref *ref = &vcpu_44x->shadow_refs[i]; | 
|  | 384 | if (ref->gtlb_index == gtlb_index) | 
|  | 385 | kvmppc_44x_shadow_release(vcpu_44x, i); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 386 | } | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 387 | } | 
|  | 388 |  | 
| Liu Yu | dd9ebf1f | 2011-06-14 18:35:14 -0500 | [diff] [blame] | 389 | void kvmppc_mmu_msr_notify(struct kvm_vcpu *vcpu, u32 old_msr) | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 390 | { | 
| Liu Yu | dd9ebf1f | 2011-06-14 18:35:14 -0500 | [diff] [blame] | 391 | int usermode = vcpu->arch.shared->msr & MSR_PR; | 
|  | 392 |  | 
| Hollis Blanchard | fe4e771 | 2008-11-10 14:57:36 -0600 | [diff] [blame] | 393 | vcpu->arch.shadow_pid = !usermode; | 
|  | 394 | } | 
|  | 395 |  | 
|  | 396 | void kvmppc_set_pid(struct kvm_vcpu *vcpu, u32 new_pid) | 
|  | 397 | { | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 398 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 399 | int i; | 
|  | 400 |  | 
| Hollis Blanchard | fe4e771 | 2008-11-10 14:57:36 -0600 | [diff] [blame] | 401 | if (unlikely(vcpu->arch.pid == new_pid)) | 
|  | 402 | return; | 
| Jerone Young | 31711f2 | 2008-07-14 14:00:03 +0200 | [diff] [blame] | 403 |  | 
| Hollis Blanchard | fe4e771 | 2008-11-10 14:57:36 -0600 | [diff] [blame] | 404 | vcpu->arch.pid = new_pid; | 
|  | 405 |  | 
|  | 406 | /* Guest userspace runs with TID=0 mappings and PID=0, to make sure it | 
|  | 407 | * can't access guest kernel mappings (TID=1). When we switch to a new | 
|  | 408 | * guest PID, which will also use host PID=0, we must discard the old guest | 
|  | 409 | * userspace mappings. */ | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 410 | for (i = 0; i < ARRAY_SIZE(vcpu_44x->shadow_refs); i++) { | 
|  | 411 | struct kvmppc_44x_shadow_ref *ref = &vcpu_44x->shadow_refs[i]; | 
| Hollis Blanchard | fe4e771 | 2008-11-10 14:57:36 -0600 | [diff] [blame] | 412 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 413 | if (ref->tid == 0) | 
|  | 414 | kvmppc_44x_shadow_release(vcpu_44x, i); | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 415 | } | 
| Hollis Blanchard | bbf45ba | 2008-04-16 23:28:09 -0500 | [diff] [blame] | 416 | } | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 417 |  | 
|  | 418 | static int tlbe_is_host_safe(const struct kvm_vcpu *vcpu, | 
| Hollis Blanchard | 0f55dc4 | 2008-11-05 09:36:12 -0600 | [diff] [blame] | 419 | const struct kvmppc_44x_tlbe *tlbe) | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 420 | { | 
|  | 421 | gpa_t gpa; | 
|  | 422 |  | 
|  | 423 | if (!get_tlb_v(tlbe)) | 
|  | 424 | return 0; | 
|  | 425 |  | 
|  | 426 | /* Does it match current guest AS? */ | 
|  | 427 | /* XXX what about IS != DS? */ | 
| Alexander Graf | 666e725 | 2010-07-29 14:47:43 +0200 | [diff] [blame] | 428 | if (get_tlb_ts(tlbe) != !!(vcpu->arch.shared->msr & MSR_IS)) | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 429 | return 0; | 
|  | 430 |  | 
|  | 431 | gpa = get_tlb_raddr(tlbe); | 
|  | 432 | if (!gfn_to_memslot(vcpu->kvm, gpa >> PAGE_SHIFT)) | 
|  | 433 | /* Mapping is not for RAM. */ | 
|  | 434 | return 0; | 
|  | 435 |  | 
|  | 436 | return 1; | 
|  | 437 | } | 
|  | 438 |  | 
| Hollis Blanchard | 75f74f0 | 2008-11-05 09:36:16 -0600 | [diff] [blame] | 439 | int kvmppc_44x_emul_tlbwe(struct kvm_vcpu *vcpu, u8 ra, u8 rs, u8 ws) | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 440 | { | 
| Hollis Blanchard | db93f57 | 2008-11-05 09:36:18 -0600 | [diff] [blame] | 441 | struct kvmppc_vcpu_44x *vcpu_44x = to_44x(vcpu); | 
| Hollis Blanchard | 0f55dc4 | 2008-11-05 09:36:12 -0600 | [diff] [blame] | 442 | struct kvmppc_44x_tlbe *tlbe; | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 443 | unsigned int gtlb_index; | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 444 |  | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 445 | gtlb_index = kvmppc_get_gpr(vcpu, ra); | 
| Roel Kluin | 4f018c5 | 2010-05-09 17:26:47 +0200 | [diff] [blame] | 446 | if (gtlb_index >= KVM44x_GUEST_TLB_SIZE) { | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 447 | printk("%s: index %d\n", __func__, gtlb_index); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 448 | kvmppc_dump_vcpu(vcpu); | 
|  | 449 | return EMULATE_FAIL; | 
|  | 450 | } | 
|  | 451 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 452 | tlbe = &vcpu_44x->guest_tlb[gtlb_index]; | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 453 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 454 | /* Invalidate shadow mappings for the about-to-be-clobbered TLB entry. */ | 
|  | 455 | if (tlbe->word0 & PPC44x_TLB_VALID) | 
|  | 456 | kvmppc_44x_invalidate(vcpu, gtlb_index); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 457 |  | 
|  | 458 | switch (ws) { | 
|  | 459 | case PPC44x_TLB_PAGEID: | 
| Hollis Blanchard | bf5d402 | 2008-11-10 14:57:34 -0600 | [diff] [blame] | 460 | tlbe->tid = get_mmucr_stid(vcpu); | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 461 | tlbe->word0 = kvmppc_get_gpr(vcpu, rs); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 462 | break; | 
|  | 463 |  | 
|  | 464 | case PPC44x_TLB_XLAT: | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 465 | tlbe->word1 = kvmppc_get_gpr(vcpu, rs); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 466 | break; | 
|  | 467 |  | 
|  | 468 | case PPC44x_TLB_ATTRIB: | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 469 | tlbe->word2 = kvmppc_get_gpr(vcpu, rs); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 470 | break; | 
|  | 471 |  | 
|  | 472 | default: | 
|  | 473 | return EMULATE_FAIL; | 
|  | 474 | } | 
|  | 475 |  | 
|  | 476 | if (tlbe_is_host_safe(vcpu, tlbe)) { | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 477 | gva_t eaddr; | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 478 | gpa_t gpaddr; | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 479 | u32 bytes; | 
|  | 480 |  | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 481 | eaddr = get_tlb_eaddr(tlbe); | 
| Hollis Blanchard | 8916861 | 2008-12-02 15:51:53 -0600 | [diff] [blame] | 482 | gpaddr = get_tlb_raddr(tlbe); | 
|  | 483 |  | 
|  | 484 | /* Use the advertised page size to mask effective and real addrs. */ | 
|  | 485 | bytes = get_tlb_bytes(tlbe); | 
|  | 486 | eaddr &= ~(bytes - 1); | 
|  | 487 | gpaddr &= ~(bytes - 1); | 
|  | 488 |  | 
| Hollis Blanchard | 58a9621 | 2009-01-03 16:23:01 -0600 | [diff] [blame] | 489 | kvmppc_mmu_map(vcpu, eaddr, gpaddr, gtlb_index); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 490 | } | 
|  | 491 |  | 
| Marcelo Tosatti | 46f43c6 | 2009-06-18 11:47:27 -0300 | [diff] [blame] | 492 | trace_kvm_gtlb_write(gtlb_index, tlbe->tid, tlbe->word0, tlbe->word1, | 
|  | 493 | tlbe->word2); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 494 |  | 
| Hollis Blanchard | 73e75b4 | 2008-12-02 15:51:57 -0600 | [diff] [blame] | 495 | kvmppc_set_exit_type(vcpu, EMULATED_TLBWE_EXITS); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 496 | return EMULATE_DONE; | 
|  | 497 | } | 
|  | 498 |  | 
| Hollis Blanchard | 75f74f0 | 2008-11-05 09:36:16 -0600 | [diff] [blame] | 499 | int kvmppc_44x_emul_tlbsx(struct kvm_vcpu *vcpu, u8 rt, u8 ra, u8 rb, u8 rc) | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 500 | { | 
|  | 501 | u32 ea; | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 502 | int gtlb_index; | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 503 | unsigned int as = get_mmucr_sts(vcpu); | 
|  | 504 | unsigned int pid = get_mmucr_stid(vcpu); | 
|  | 505 |  | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 506 | ea = kvmppc_get_gpr(vcpu, rb); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 507 | if (ra) | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 508 | ea += kvmppc_get_gpr(vcpu, ra); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 509 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 510 | gtlb_index = kvmppc_44x_tlb_index(vcpu, ea, pid, as); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 511 | if (rc) { | 
| Alexander Graf | 992b5b2 | 2010-01-08 02:58:02 +0100 | [diff] [blame] | 512 | u32 cr = kvmppc_get_cr(vcpu); | 
|  | 513 |  | 
| Hollis Blanchard | 7924bd4 | 2008-12-02 15:51:55 -0600 | [diff] [blame] | 514 | if (gtlb_index < 0) | 
| Alexander Graf | 992b5b2 | 2010-01-08 02:58:02 +0100 | [diff] [blame] | 515 | kvmppc_set_cr(vcpu, cr & ~0x20000000); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 516 | else | 
| Alexander Graf | 992b5b2 | 2010-01-08 02:58:02 +0100 | [diff] [blame] | 517 | kvmppc_set_cr(vcpu, cr | 0x20000000); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 518 | } | 
| Alexander Graf | 8e5b26b | 2010-01-08 02:58:01 +0100 | [diff] [blame] | 519 | kvmppc_set_gpr(vcpu, rt, gtlb_index); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 520 |  | 
| Hollis Blanchard | 73e75b4 | 2008-12-02 15:51:57 -0600 | [diff] [blame] | 521 | kvmppc_set_exit_type(vcpu, EMULATED_TLBSX_EXITS); | 
| Hollis Blanchard | a0d7b9f | 2008-11-05 09:36:11 -0600 | [diff] [blame] | 522 | return EMULATE_DONE; | 
|  | 523 | } |