2 * QEMU RISC-V PMP (Physical Memory Protection)
4 * Author: Daire McNamara, daire.mcnamara@emdalo.com
5 * Ivan Griffin, ivan.griffin@emdalo.com
7 * This provides a RISC-V Physical Memory Protection implementation
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms and conditions of the GNU General Public License,
11 * version 2 or later, as published by the Free Software Foundation.
13 * This program is distributed in the hope it will be useful, but WITHOUT
14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
18 * You should have received a copy of the GNU General Public License along with
19 * this program. If not, see <http://www.gnu.org/licenses/>.
22 #include "qemu/osdep.h"
24 #include "qapi/error.h"
27 #include "exec/exec-all.h"
28 #include "exec/page-protection.h"
30 static bool pmp_write_cfg(CPURISCVState
*env
, uint32_t addr_index
,
32 static uint8_t pmp_read_cfg(CPURISCVState
*env
, uint32_t addr_index
);
35 * Accessor method to extract address matching type 'a field' from cfg reg
37 static inline uint8_t pmp_get_a_field(uint8_t cfg
)
44 * Check whether a PMP is locked or not.
46 static inline int pmp_is_locked(CPURISCVState
*env
, uint32_t pmp_index
)
48 /* mseccfg.RLB is set */
49 if (MSECCFG_RLB_ISSET(env
)) {
53 if (env
->pmp_state
.pmp
[pmp_index
].cfg_reg
& PMP_LOCK
) {
57 /* Top PMP has no 'next' to check */
58 if ((pmp_index
+ 1u) >= MAX_RISCV_PMPS
) {
66 * Count the number of active rules.
68 uint32_t pmp_get_num_rules(CPURISCVState
*env
)
70 return env
->pmp_state
.num_rules
;
74 * Accessor to get the cfg reg for a specific PMP/HART
76 static inline uint8_t pmp_read_cfg(CPURISCVState
*env
, uint32_t pmp_index
)
78 if (pmp_index
< MAX_RISCV_PMPS
) {
79 return env
->pmp_state
.pmp
[pmp_index
].cfg_reg
;
87 * Accessor to set the cfg reg for a specific PMP/HART
88 * Bounds checks and relevant lock bit.
90 static bool pmp_write_cfg(CPURISCVState
*env
, uint32_t pmp_index
, uint8_t val
)
92 if (pmp_index
< MAX_RISCV_PMPS
) {
95 if (riscv_cpu_cfg(env
)->ext_smepmp
) {
96 /* mseccfg.RLB is set */
97 if (MSECCFG_RLB_ISSET(env
)) {
101 /* mseccfg.MML is not set */
102 if (!MSECCFG_MML_ISSET(env
) && !pmp_is_locked(env
, pmp_index
)) {
106 /* mseccfg.MML is set */
107 if (MSECCFG_MML_ISSET(env
)) {
108 /* not adding execute bit */
109 if ((val
& PMP_LOCK
) != 0 && (val
& PMP_EXEC
) != PMP_EXEC
) {
112 /* shared region and not adding X bit */
113 if ((val
& PMP_LOCK
) != PMP_LOCK
&&
114 (val
& 0x7) != (PMP_WRITE
| PMP_EXEC
)) {
119 if (!pmp_is_locked(env
, pmp_index
)) {
125 qemu_log_mask(LOG_GUEST_ERROR
, "ignoring pmpcfg write - locked\n");
126 } else if (env
->pmp_state
.pmp
[pmp_index
].cfg_reg
!= val
) {
127 /* If !mseccfg.MML then ignore writes with encoding RW=01 */
128 if ((val
& PMP_WRITE
) && !(val
& PMP_READ
) &&
129 !MSECCFG_MML_ISSET(env
)) {
132 env
->pmp_state
.pmp
[pmp_index
].cfg_reg
= val
;
133 pmp_update_rule_addr(env
, pmp_index
);
137 qemu_log_mask(LOG_GUEST_ERROR
,
138 "ignoring pmpcfg write - out of bounds\n");
144 void pmp_unlock_entries(CPURISCVState
*env
)
146 uint32_t pmp_num
= pmp_get_num_rules(env
);
149 for (i
= 0; i
< pmp_num
; i
++) {
150 env
->pmp_state
.pmp
[i
].cfg_reg
&= ~(PMP_LOCK
| PMP_AMATCH
);
154 static void pmp_decode_napot(hwaddr a
, hwaddr
*sa
, hwaddr
*ea
)
157 * aaaa...aaa0 8-byte NAPOT range
158 * aaaa...aa01 16-byte NAPOT range
159 * aaaa...a011 32-byte NAPOT range
161 * aa01...1111 2^XLEN-byte NAPOT range
162 * a011...1111 2^(XLEN+1)-byte NAPOT range
163 * 0111...1111 2^(XLEN+2)-byte NAPOT range
164 * 1111...1111 Reserved
171 void pmp_update_rule_addr(CPURISCVState
*env
, uint32_t pmp_index
)
173 uint8_t this_cfg
= env
->pmp_state
.pmp
[pmp_index
].cfg_reg
;
174 target_ulong this_addr
= env
->pmp_state
.pmp
[pmp_index
].addr_reg
;
175 target_ulong prev_addr
= 0u;
179 if (pmp_index
>= 1u) {
180 prev_addr
= env
->pmp_state
.pmp
[pmp_index
- 1].addr_reg
;
183 switch (pmp_get_a_field(this_cfg
)) {
190 sa
= prev_addr
<< 2; /* shift up from [xx:0] to [xx+2:2] */
191 ea
= (this_addr
<< 2) - 1u;
198 sa
= this_addr
<< 2; /* shift up from [xx:0] to [xx+2:2] */
202 case PMP_AMATCH_NAPOT
:
203 pmp_decode_napot(this_addr
, &sa
, &ea
);
212 env
->pmp_state
.addr
[pmp_index
].sa
= sa
;
213 env
->pmp_state
.addr
[pmp_index
].ea
= ea
;
216 void pmp_update_rule_nums(CPURISCVState
*env
)
220 env
->pmp_state
.num_rules
= 0;
221 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
222 const uint8_t a_field
=
223 pmp_get_a_field(env
->pmp_state
.pmp
[i
].cfg_reg
);
224 if (PMP_AMATCH_OFF
!= a_field
) {
225 env
->pmp_state
.num_rules
++;
230 static int pmp_is_in_range(CPURISCVState
*env
, int pmp_index
, hwaddr addr
)
234 if ((addr
>= env
->pmp_state
.addr
[pmp_index
].sa
) &&
235 (addr
<= env
->pmp_state
.addr
[pmp_index
].ea
)) {
245 * Check if the address has required RWX privs when no PMP entry is matched.
247 static bool pmp_hart_has_privs_default(CPURISCVState
*env
, pmp_priv_t privs
,
248 pmp_priv_t
*allowed_privs
,
253 if (MSECCFG_MMWP_ISSET(env
)) {
255 * The Machine Mode Whitelist Policy (mseccfg.MMWP) is set
256 * so we default to deny all, even for M-mode.
260 } else if (MSECCFG_MML_ISSET(env
)) {
262 * The Machine Mode Lockdown (mseccfg.MML) bit is set
263 * so we can only execute code in M-mode with an applicable
264 * rule. Other modes are disabled.
266 if (mode
== PRV_M
&& !(privs
& PMP_EXEC
)) {
268 *allowed_privs
= PMP_READ
| PMP_WRITE
;
277 if (!riscv_cpu_cfg(env
)->pmp
|| (mode
== PRV_M
)) {
279 * Privileged spec v1.10 states if HW doesn't implement any PMP entry
280 * or no PMP entry matches an M-Mode access, the access succeeds.
283 *allowed_privs
= PMP_READ
| PMP_WRITE
| PMP_EXEC
;
286 * Other modes are not allowed to succeed if they don't * match a rule,
287 * but there are rules. We've checked for no rule earlier in this
303 * Check if the address has required RWX privs to complete desired operation
304 * Return true if a pmp rule match or default match
305 * Return false if no match
307 bool pmp_hart_has_privs(CPURISCVState
*env
, hwaddr addr
,
308 target_ulong size
, pmp_priv_t privs
,
309 pmp_priv_t
*allowed_privs
, target_ulong mode
)
316 /* Short cut if no rules */
317 if (0 == pmp_get_num_rules(env
)) {
318 return pmp_hart_has_privs_default(env
, privs
, allowed_privs
, mode
);
322 if (riscv_cpu_cfg(env
)->mmu
) {
324 * If size is unknown (0), assume that all bytes
325 * from addr to the end of the page will be accessed.
327 pmp_size
= -(addr
| TARGET_PAGE_MASK
);
329 pmp_size
= sizeof(target_ulong
);
336 * 1.10 draft priv spec states there is an implicit order
339 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
340 s
= pmp_is_in_range(env
, i
, addr
);
341 e
= pmp_is_in_range(env
, i
, addr
+ pmp_size
- 1);
343 /* partially inside */
345 qemu_log_mask(LOG_GUEST_ERROR
,
346 "pmp violation - access is partially inside\n");
352 const uint8_t a_field
=
353 pmp_get_a_field(env
->pmp_state
.pmp
[i
].cfg_reg
);
356 * Convert the PMP permissions to match the truth table in the
359 const uint8_t smepmp_operation
=
360 ((env
->pmp_state
.pmp
[i
].cfg_reg
& PMP_LOCK
) >> 4) |
361 ((env
->pmp_state
.pmp
[i
].cfg_reg
& PMP_READ
) << 2) |
362 (env
->pmp_state
.pmp
[i
].cfg_reg
& PMP_WRITE
) |
363 ((env
->pmp_state
.pmp
[i
].cfg_reg
& PMP_EXEC
) >> 2);
365 if (((s
+ e
) == 2) && (PMP_AMATCH_OFF
!= a_field
)) {
367 * If the PMP entry is not off and the address is in range,
370 if (!MSECCFG_MML_ISSET(env
)) {
372 * If mseccfg.MML Bit is not set, do pmp priv check
373 * This will always apply to regular PMP.
375 *allowed_privs
= PMP_READ
| PMP_WRITE
| PMP_EXEC
;
376 if ((mode
!= PRV_M
) || pmp_is_locked(env
, i
)) {
377 *allowed_privs
&= env
->pmp_state
.pmp
[i
].cfg_reg
;
381 * If mseccfg.MML Bit set, do the enhanced pmp priv check
384 switch (smepmp_operation
) {
397 *allowed_privs
= PMP_READ
| PMP_WRITE
;
401 *allowed_privs
= PMP_EXEC
;
405 *allowed_privs
= PMP_READ
| PMP_EXEC
;
409 *allowed_privs
= PMP_READ
;
412 g_assert_not_reached();
415 switch (smepmp_operation
) {
427 *allowed_privs
= PMP_EXEC
;
432 *allowed_privs
= PMP_READ
;
436 *allowed_privs
= PMP_READ
| PMP_WRITE
;
439 *allowed_privs
= PMP_READ
| PMP_EXEC
;
442 *allowed_privs
= PMP_READ
| PMP_WRITE
| PMP_EXEC
;
445 g_assert_not_reached();
451 * If matching address range was found, the protection bits
452 * defined with PMP must be used. We shouldn't fallback on
453 * finding default privileges.
455 return (privs
& *allowed_privs
) == privs
;
459 /* No rule matched */
460 return pmp_hart_has_privs_default(env
, privs
, allowed_privs
, mode
);
464 * Handle a write to a pmpcfg CSR
466 void pmpcfg_csr_write(CPURISCVState
*env
, uint32_t reg_index
,
471 int pmpcfg_nums
= 2 << riscv_cpu_mxl(env
);
472 bool modified
= false;
474 trace_pmpcfg_csr_write(env
->mhartid
, reg_index
, val
);
476 for (i
= 0; i
< pmpcfg_nums
; i
++) {
477 cfg_val
= (val
>> 8 * i
) & 0xff;
478 modified
|= pmp_write_cfg(env
, (reg_index
* 4) + i
, cfg_val
);
481 /* If PMP permission of any addr has been changed, flush TLB pages. */
483 pmp_update_rule_nums(env
);
484 tlb_flush(env_cpu(env
));
490 * Handle a read from a pmpcfg CSR
492 target_ulong
pmpcfg_csr_read(CPURISCVState
*env
, uint32_t reg_index
)
495 target_ulong cfg_val
= 0;
496 target_ulong val
= 0;
497 int pmpcfg_nums
= 2 << riscv_cpu_mxl(env
);
499 for (i
= 0; i
< pmpcfg_nums
; i
++) {
500 val
= pmp_read_cfg(env
, (reg_index
* 4) + i
);
501 cfg_val
|= (val
<< (i
* 8));
503 trace_pmpcfg_csr_read(env
->mhartid
, reg_index
, cfg_val
);
510 * Handle a write to a pmpaddr CSR
512 void pmpaddr_csr_write(CPURISCVState
*env
, uint32_t addr_index
,
515 trace_pmpaddr_csr_write(env
->mhartid
, addr_index
, val
);
516 bool is_next_cfg_tor
= false;
518 if (addr_index
< MAX_RISCV_PMPS
) {
520 * In TOR mode, need to check the lock bit of the next pmp
521 * (if there is a next).
523 if (addr_index
+ 1 < MAX_RISCV_PMPS
) {
524 uint8_t pmp_cfg
= env
->pmp_state
.pmp
[addr_index
+ 1].cfg_reg
;
525 is_next_cfg_tor
= PMP_AMATCH_TOR
== pmp_get_a_field(pmp_cfg
);
527 if (pmp_cfg
& PMP_LOCK
&& is_next_cfg_tor
) {
528 qemu_log_mask(LOG_GUEST_ERROR
,
529 "ignoring pmpaddr write - pmpcfg + 1 locked\n");
534 if (!pmp_is_locked(env
, addr_index
)) {
535 if (env
->pmp_state
.pmp
[addr_index
].addr_reg
!= val
) {
536 env
->pmp_state
.pmp
[addr_index
].addr_reg
= val
;
537 pmp_update_rule_addr(env
, addr_index
);
538 if (is_next_cfg_tor
) {
539 pmp_update_rule_addr(env
, addr_index
+ 1);
541 tlb_flush(env_cpu(env
));
544 qemu_log_mask(LOG_GUEST_ERROR
,
545 "ignoring pmpaddr write - locked\n");
548 qemu_log_mask(LOG_GUEST_ERROR
,
549 "ignoring pmpaddr write - out of bounds\n");
555 * Handle a read from a pmpaddr CSR
557 target_ulong
pmpaddr_csr_read(CPURISCVState
*env
, uint32_t addr_index
)
559 target_ulong val
= 0;
561 if (addr_index
< MAX_RISCV_PMPS
) {
562 val
= env
->pmp_state
.pmp
[addr_index
].addr_reg
;
563 trace_pmpaddr_csr_read(env
->mhartid
, addr_index
, val
);
565 qemu_log_mask(LOG_GUEST_ERROR
,
566 "ignoring pmpaddr read - out of bounds\n");
573 * Handle a write to a mseccfg CSR
575 void mseccfg_csr_write(CPURISCVState
*env
, target_ulong val
)
579 trace_mseccfg_csr_write(env
->mhartid
, val
);
581 /* RLB cannot be enabled if it's already 0 and if any regions are locked */
582 if (!MSECCFG_RLB_ISSET(env
)) {
583 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
584 if (pmp_is_locked(env
, i
)) {
591 if (riscv_cpu_cfg(env
)->ext_smepmp
) {
593 val
|= (env
->mseccfg
& (MSECCFG_MMWP
| MSECCFG_MML
));
594 if ((val
^ env
->mseccfg
) & (MSECCFG_MMWP
| MSECCFG_MML
)) {
595 tlb_flush(env_cpu(env
));
598 val
&= ~(MSECCFG_MMWP
| MSECCFG_MML
| MSECCFG_RLB
);
605 * Handle a read from a mseccfg CSR
607 target_ulong
mseccfg_csr_read(CPURISCVState
*env
)
609 trace_mseccfg_csr_read(env
->mhartid
, env
->mseccfg
);
614 * Calculate the TLB size.
615 * It's possible that PMP regions only cover partial of the TLB page, and
616 * this may split the page into regions with different permissions.
617 * For example if PMP0 is (0x80000008~0x8000000F, R) and PMP1 is (0x80000000
618 * ~0x80000FFF, RWX), then region 0x80000008~0x8000000F has R permission, and
619 * the other regions in this page have RWX permissions.
620 * A write access to 0x80000000 will match PMP1. However we cannot cache the
621 * translation result in the TLB since this will make the write access to
622 * 0x80000008 bypass the check of PMP0.
623 * To avoid this we return a size of 1 (which means no caching) if the PMP
624 * region only covers partial of the TLB page.
626 target_ulong
pmp_get_tlb_size(CPURISCVState
*env
, hwaddr addr
)
630 hwaddr tlb_sa
= addr
& ~(TARGET_PAGE_SIZE
- 1);
631 hwaddr tlb_ea
= tlb_sa
+ TARGET_PAGE_SIZE
- 1;
635 * If PMP is not supported or there are no PMP rules, the TLB page will not
636 * be split into regions with different permissions by PMP so we set the
637 * size to TARGET_PAGE_SIZE.
639 if (!riscv_cpu_cfg(env
)->pmp
|| !pmp_get_num_rules(env
)) {
640 return TARGET_PAGE_SIZE
;
643 for (i
= 0; i
< MAX_RISCV_PMPS
; i
++) {
644 if (pmp_get_a_field(env
->pmp_state
.pmp
[i
].cfg_reg
) == PMP_AMATCH_OFF
) {
648 pmp_sa
= env
->pmp_state
.addr
[i
].sa
;
649 pmp_ea
= env
->pmp_state
.addr
[i
].ea
;
652 * Only the first PMP entry that covers (whole or partial of) the TLB
653 * page really matters:
654 * If it covers the whole TLB page, set the size to TARGET_PAGE_SIZE,
655 * since the following PMP entries have lower priority and will not
656 * affect the permissions of the page.
657 * If it only covers partial of the TLB page, set the size to 1 since
658 * the allowed permissions of the region may be different from other
659 * region of the page.
661 if (pmp_sa
<= tlb_sa
&& pmp_ea
>= tlb_ea
) {
662 return TARGET_PAGE_SIZE
;
663 } else if ((pmp_sa
>= tlb_sa
&& pmp_sa
<= tlb_ea
) ||
664 (pmp_ea
>= tlb_sa
&& pmp_ea
<= tlb_ea
)) {
670 * If no PMP entry matches the TLB page, the TLB page will also not be
671 * split into regions with different permissions by PMP so we set the size
672 * to TARGET_PAGE_SIZE.
674 return TARGET_PAGE_SIZE
;
678 * Convert PMP privilege to TLB page privilege.
680 int pmp_priv_to_page_prot(pmp_priv_t pmp_priv
)
684 if (pmp_priv
& PMP_READ
) {
687 if (pmp_priv
& PMP_WRITE
) {
690 if (pmp_priv
& PMP_EXEC
) {