1 // SPDX-License-Identifier: GPL-2.0-only
3 * arch/arm/probes/decode.c
5 * Copyright (C) 2011 Jon Medhurst <tixy@yxit.co.uk>.
7 * Some contents moved here from arch/arm/include/asm/kprobes-arm.c which is
8 * Copyright (C) 2006, 2007 Motorola Inc.
11 #include <linux/kernel.h>
12 #include <linux/types.h>
13 #include <asm/system_info.h>
14 #include <asm/ptrace.h>
15 #include <linux/bug.h>
20 #ifndef find_str_pc_offset
23 * For STR and STM instructions, an ARM core may choose to use either
24 * a +8 or a +12 displacement from the current instruction's address.
25 * Whichever value is chosen for a given core, it must be the same for
26 * both instructions and may not change. This function measures it.
31 void __init
find_str_pc_offset(void)
33 int addr
, scratch
, ret
;
36 "sub %[ret], pc, #4 \n\t"
37 "str pc, %[addr] \n\t"
38 "ldr %[scr], %[addr] \n\t"
39 "sub %[ret], %[scr], %[ret] \n\t"
40 : [ret
] "=r" (ret
), [scr
] "=r" (scratch
), [addr
] "+m" (addr
));
45 #endif /* !find_str_pc_offset */
48 #ifndef test_load_write_pc_interworking
50 bool load_write_pc_interworks
;
52 void __init
test_load_write_pc_interworking(void)
54 int arch
= cpu_architecture();
55 BUG_ON(arch
== CPU_ARCH_UNKNOWN
);
56 load_write_pc_interworks
= arch
>= CPU_ARCH_ARMv5T
;
59 #endif /* !test_load_write_pc_interworking */
62 #ifndef test_alu_write_pc_interworking
64 bool alu_write_pc_interworks
;
66 void __init
test_alu_write_pc_interworking(void)
68 int arch
= cpu_architecture();
69 BUG_ON(arch
== CPU_ARCH_UNKNOWN
);
70 alu_write_pc_interworks
= arch
>= CPU_ARCH_ARMv7
;
73 #endif /* !test_alu_write_pc_interworking */
76 void __init
arm_probes_decode_init(void)
79 test_load_write_pc_interworking();
80 test_alu_write_pc_interworking();
84 static unsigned long __kprobes
__check_eq(unsigned long cpsr
)
86 return cpsr
& PSR_Z_BIT
;
89 static unsigned long __kprobes
__check_ne(unsigned long cpsr
)
91 return (~cpsr
) & PSR_Z_BIT
;
94 static unsigned long __kprobes
__check_cs(unsigned long cpsr
)
96 return cpsr
& PSR_C_BIT
;
99 static unsigned long __kprobes
__check_cc(unsigned long cpsr
)
101 return (~cpsr
) & PSR_C_BIT
;
104 static unsigned long __kprobes
__check_mi(unsigned long cpsr
)
106 return cpsr
& PSR_N_BIT
;
109 static unsigned long __kprobes
__check_pl(unsigned long cpsr
)
111 return (~cpsr
) & PSR_N_BIT
;
114 static unsigned long __kprobes
__check_vs(unsigned long cpsr
)
116 return cpsr
& PSR_V_BIT
;
119 static unsigned long __kprobes
__check_vc(unsigned long cpsr
)
121 return (~cpsr
) & PSR_V_BIT
;
124 static unsigned long __kprobes
__check_hi(unsigned long cpsr
)
126 cpsr
&= ~(cpsr
>> 1); /* PSR_C_BIT &= ~PSR_Z_BIT */
127 return cpsr
& PSR_C_BIT
;
130 static unsigned long __kprobes
__check_ls(unsigned long cpsr
)
132 cpsr
&= ~(cpsr
>> 1); /* PSR_C_BIT &= ~PSR_Z_BIT */
133 return (~cpsr
) & PSR_C_BIT
;
136 static unsigned long __kprobes
__check_ge(unsigned long cpsr
)
138 cpsr
^= (cpsr
<< 3); /* PSR_N_BIT ^= PSR_V_BIT */
139 return (~cpsr
) & PSR_N_BIT
;
142 static unsigned long __kprobes
__check_lt(unsigned long cpsr
)
144 cpsr
^= (cpsr
<< 3); /* PSR_N_BIT ^= PSR_V_BIT */
145 return cpsr
& PSR_N_BIT
;
148 static unsigned long __kprobes
__check_gt(unsigned long cpsr
)
150 unsigned long temp
= cpsr
^ (cpsr
<< 3); /* PSR_N_BIT ^= PSR_V_BIT */
151 temp
|= (cpsr
<< 1); /* PSR_N_BIT |= PSR_Z_BIT */
152 return (~temp
) & PSR_N_BIT
;
155 static unsigned long __kprobes
__check_le(unsigned long cpsr
)
157 unsigned long temp
= cpsr
^ (cpsr
<< 3); /* PSR_N_BIT ^= PSR_V_BIT */
158 temp
|= (cpsr
<< 1); /* PSR_N_BIT |= PSR_Z_BIT */
159 return temp
& PSR_N_BIT
;
162 static unsigned long __kprobes
__check_al(unsigned long cpsr
)
167 probes_check_cc
* const probes_condition_checks
[16] = {
168 &__check_eq
, &__check_ne
, &__check_cs
, &__check_cc
,
169 &__check_mi
, &__check_pl
, &__check_vs
, &__check_vc
,
170 &__check_hi
, &__check_ls
, &__check_ge
, &__check_lt
,
171 &__check_gt
, &__check_le
, &__check_al
, &__check_al
175 void __kprobes
probes_simulate_nop(probes_opcode_t opcode
,
176 struct arch_probes_insn
*asi
,
177 struct pt_regs
*regs
)
181 void __kprobes
probes_emulate_none(probes_opcode_t opcode
,
182 struct arch_probes_insn
*asi
,
183 struct pt_regs
*regs
)
189 * Prepare an instruction slot to receive an instruction for emulating.
190 * This is done by placing a subroutine return after the location where the
191 * instruction will be placed. We also modify ARM instructions to be
192 * unconditional as the condition code will already be checked before any
193 * emulation handler is called.
195 static probes_opcode_t __kprobes
196 prepare_emulated_insn(probes_opcode_t insn
, struct arch_probes_insn
*asi
,
199 #ifdef CONFIG_THUMB2_KERNEL
201 u16
*thumb_insn
= (u16
*)asi
->insn
;
203 thumb_insn
[1] = __opcode_to_mem_thumb16(0x4770);
204 thumb_insn
[2] = __opcode_to_mem_thumb16(0x4770);
207 asi
->insn
[1] = __opcode_to_mem_arm(0xe12fff1e); /* ARM bx lr */
209 asi
->insn
[1] = __opcode_to_mem_arm(0xe1a0f00e); /* mov pc, lr */
211 /* Make an ARM instruction unconditional */
212 if (insn
< 0xe0000000)
213 insn
= (insn
| 0xe0000000) & ~0x10000000;
218 * Write a (probably modified) instruction into the slot previously prepared by
219 * prepare_emulated_insn
221 static void __kprobes
222 set_emulated_insn(probes_opcode_t insn
, struct arch_probes_insn
*asi
,
225 #ifdef CONFIG_THUMB2_KERNEL
227 u16
*ip
= (u16
*)asi
->insn
;
228 if (is_wide_instruction(insn
))
229 *ip
++ = __opcode_to_mem_thumb16(insn
>> 16);
230 *ip
++ = __opcode_to_mem_thumb16(insn
);
234 asi
->insn
[0] = __opcode_to_mem_arm(insn
);
238 * When we modify the register numbers encoded in an instruction to be emulated,
239 * the new values come from this define. For ARM and 32-bit Thumb instructions
242 * bit position 16 12 8 4 0
243 * ---------------+---+---+---+---+---+
244 * register r2 r0 r1 -- r3
246 #define INSN_NEW_BITS 0x00020103
248 /* Each nibble has same value as that at INSN_NEW_BITS bit 16 */
249 #define INSN_SAMEAS16_BITS 0x22222222
252 * Validate and modify each of the registers encoded in an instruction.
254 * Each nibble in regs contains a value from enum decode_reg_type. For each
255 * non-zero value, the corresponding nibble in pinsn is validated and modified
256 * according to the type.
258 static bool __kprobes
decode_regs(probes_opcode_t
*pinsn
, u32 regs
, bool modify
)
260 probes_opcode_t insn
= *pinsn
;
261 probes_opcode_t mask
= 0xf; /* Start at least significant nibble */
263 for (; regs
!= 0; regs
>>= 4, mask
<<= 4) {
265 probes_opcode_t new_bits
= INSN_NEW_BITS
;
267 switch (regs
& 0xf) {
270 /* Nibble not a register, skip to next */
274 /* Any register is allowed */
277 case REG_TYPE_SAMEAS16
:
278 /* Replace register with same as at bit position 16 */
279 new_bits
= INSN_SAMEAS16_BITS
;
283 /* Only allow SP (R13) */
284 if ((insn
^ 0xdddddddd) & mask
)
289 /* Only allow PC (R15) */
290 if ((insn
^ 0xffffffff) & mask
)
295 /* Reject SP (R13) */
296 if (((insn
^ 0xdddddddd) & mask
) == 0)
300 case REG_TYPE_NOSPPC
:
301 case REG_TYPE_NOSPPCX
:
302 /* Reject SP and PC (R13 and R15) */
303 if (((insn
^ 0xdddddddd) & 0xdddddddd & mask
) == 0)
307 case REG_TYPE_NOPCWB
:
308 if (!is_writeback(insn
))
309 break; /* No writeback, so any register is OK */
313 /* Reject PC (R15) */
314 if (((insn
^ 0xffffffff) & mask
) == 0)
319 /* Replace value of nibble with new register number... */
321 insn
|= new_bits
& mask
;
333 static const int decode_struct_sizes
[NUM_DECODE_TYPES
] = {
334 [DECODE_TYPE_TABLE
] = sizeof(struct decode_table
),
335 [DECODE_TYPE_CUSTOM
] = sizeof(struct decode_custom
),
336 [DECODE_TYPE_SIMULATE
] = sizeof(struct decode_simulate
),
337 [DECODE_TYPE_EMULATE
] = sizeof(struct decode_emulate
),
338 [DECODE_TYPE_OR
] = sizeof(struct decode_or
),
339 [DECODE_TYPE_REJECT
] = sizeof(struct decode_reject
)
342 static int run_checkers(const struct decode_checker
*checkers
[],
343 int action
, probes_opcode_t insn
,
344 struct arch_probes_insn
*asi
,
345 const struct decode_header
*h
)
347 const struct decode_checker
**p
;
355 probes_check_t
*checker_func
= (*p
)[action
].checker
;
359 retval
= checker_func(insn
, asi
, h
);
360 if (retval
== INSN_REJECTED
)
368 * probes_decode_insn operates on data tables in order to decode an ARM
369 * architecture instruction onto which a kprobe has been placed.
371 * These instruction decoding tables are a concatenation of entries each
372 * of which consist of one of the following structs:
381 * Each of these starts with a struct decode_header which has the following
388 * The least significant DECODE_TYPE_BITS of type_regs contains a value
389 * from enum decode_type, this indicates which of the decode_* structs
390 * the entry contains. The value DECODE_TYPE_END indicates the end of the
393 * When the table is parsed, each entry is checked in turn to see if it
394 * matches the instruction to be decoded using the test:
396 * (insn & mask) == value
398 * If no match is found before the end of the table is reached then decoding
399 * fails with INSN_REJECTED.
401 * When a match is found, decode_regs() is called to validate and modify each
402 * of the registers encoded in the instruction; the data it uses to do this
403 * is (type_regs >> DECODE_TYPE_BITS). A validation failure will cause decoding
404 * to fail with INSN_REJECTED.
406 * Once the instruction has passed the above tests, further processing
407 * depends on the type of the table entry's decode struct.
411 probes_decode_insn(probes_opcode_t insn
, struct arch_probes_insn
*asi
,
412 const union decode_item
*table
, bool thumb
,
413 bool emulate
, const union decode_action
*actions
,
414 const struct decode_checker
*checkers
[])
416 const struct decode_header
*h
= (struct decode_header
*)table
;
417 const struct decode_header
*next
;
418 bool matched
= false;
420 * @insn can be modified by decode_regs. Save its original
421 * value for checkers.
423 probes_opcode_t origin_insn
= insn
;
426 * stack_space is initialized to 0 here. Checker functions
427 * should update is value if they find this is a stack store
428 * instruction: positive value means bytes of stack usage,
429 * negitive value means unable to determine stack usage
430 * statically. For instruction doesn't store to stack, checker
431 * do nothing with it.
433 asi
->stack_space
= 0;
436 * Similarly to stack_space, register_usage_flags is filled by
437 * checkers. Its default value is set to ~0, which is 'all
438 * registers are used', to prevent any potential optimization.
440 asi
->register_usage_flags
= ~0UL;
443 insn
= prepare_emulated_insn(insn
, asi
, thumb
);
446 enum decode_type type
= h
->type_regs
.bits
& DECODE_TYPE_MASK
;
447 u32 regs
= h
->type_regs
.bits
>> DECODE_TYPE_BITS
;
449 if (type
== DECODE_TYPE_END
)
450 return INSN_REJECTED
;
452 next
= (struct decode_header
*)
453 ((uintptr_t)h
+ decode_struct_sizes
[type
]);
455 if (!matched
&& (insn
& h
->mask
.bits
) != h
->value
.bits
)
458 if (!decode_regs(&insn
, regs
, emulate
))
459 return INSN_REJECTED
;
463 case DECODE_TYPE_TABLE
: {
464 struct decode_table
*d
= (struct decode_table
*)h
;
465 next
= (struct decode_header
*)d
->table
.table
;
469 case DECODE_TYPE_CUSTOM
: {
471 struct decode_custom
*d
= (struct decode_custom
*)h
;
472 int action
= d
->decoder
.action
;
474 err
= run_checkers(checkers
, action
, origin_insn
, asi
, h
);
475 if (err
== INSN_REJECTED
)
476 return INSN_REJECTED
;
477 return actions
[action
].decoder(insn
, asi
, h
);
480 case DECODE_TYPE_SIMULATE
: {
482 struct decode_simulate
*d
= (struct decode_simulate
*)h
;
483 int action
= d
->handler
.action
;
485 err
= run_checkers(checkers
, action
, origin_insn
, asi
, h
);
486 if (err
== INSN_REJECTED
)
487 return INSN_REJECTED
;
488 asi
->insn_handler
= actions
[action
].handler
;
489 return INSN_GOOD_NO_SLOT
;
492 case DECODE_TYPE_EMULATE
: {
494 struct decode_emulate
*d
= (struct decode_emulate
*)h
;
495 int action
= d
->handler
.action
;
497 err
= run_checkers(checkers
, action
, origin_insn
, asi
, h
);
498 if (err
== INSN_REJECTED
)
499 return INSN_REJECTED
;
502 return actions
[action
].decoder(insn
, asi
, h
);
504 asi
->insn_handler
= actions
[action
].handler
;
505 set_emulated_insn(insn
, asi
, thumb
);
513 case DECODE_TYPE_REJECT
:
515 return INSN_REJECTED
;