Commit fd4363ff authored by Jiri Kosina's avatar Jiri Kosina Committed by H. Peter Anvin
Browse files

x86: Introduce int3 (breakpoint)-based instruction patching 

Introduce a method for run-time instruction patching on a live SMP kernel
based on int3 breakpoint, completely avoiding the need for stop_machine().

The way this is achieved:

	- add a int3 trap to the address that will be patched
	- sync cores
	- update all but the first byte of the patched range
	- sync cores
	- replace the first byte (int3) by the first byte of
	  replacing opcode
	- sync cores

According to

	http://lkml.indiana.edu/hypermail/linux/kernel/1001.1/01530.html



synchronization after replacing "all but first" instructions should not
be necessary (on Intel hardware), as the syncing after the subsequent
patching of the first byte provides enough safety.
But there's not only Intel HW out there, and we'd rather be on a safe
side.

If any CPU instruction execution would collide with the patching,
it'd be trapped by the int3 breakpoint and redirected to the provided
"handler" (which would typically mean just skipping over the patched
region, acting as "nop" has been there, in case we are doing nop -> jump
and jump -> nop transitions).

Ftrace has been using this very technique since 08d636b6 ("ftrace/x86:
Have arch x86_64 use breakpoints instead of stop machine") for ages
already, and jump labels are another obvious potential user of this.

Based on activities of Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
a few years ago.

Reviewed-by: default avatarSteven Rostedt <rostedt@goodmis.org>
Reviewed-by: default avatarMasami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
Signed-off-by: default avatarJiri Kosina <jkosina@suse.cz>
Link: http://lkml.kernel.org/r/alpine.LNX.2.00.1307121102440.29788@pobox.suse.cz


Signed-off-by: default avatarH. Peter Anvin <hpa@linux.intel.com>
parent ad81f054

arch/x86/include/asm/alternative.h

+1 −0
Original line number Diff line number Diff line
@@ -233,6 +233,7 @@ struct text_poke_param { 
};



extern void *text_poke(void *addr, const void *opcode, size_t len);

extern void *text_poke_bp(void *addr, const void *opcode, size_t len, void *handler);

extern void *text_poke_smp(void *addr, const void *opcode, size_t len);

extern void text_poke_smp_batch(struct text_poke_param *params, int n);

arch/x86/kernel/alternative.c

+106 −0
Original line number Diff line number Diff line
@@ -11,6 +11,7 @@ 
#include <linux/memory.h>

#include <linux/stop_machine.h>

#include <linux/slab.h>

#include <linux/kdebug.h>

#include <asm/alternative.h>

#include <asm/sections.h>

#include <asm/pgtable.h>
@@ -596,6 +597,111 @@ void *__kprobes text_poke(void *addr, const void *opcode, size_t len) 
	return addr;

}



static void do_sync_core(void *info)

{

	sync_core();

}



static bool bp_patching_in_progress;

static void *bp_int3_handler, *bp_int3_addr;



static int int3_notify(struct notifier_block *self, unsigned long val, void *data)

{

	struct die_args *args = data;



	/* bp_patching_in_progress */

	smp_rmb();



	if (likely(!bp_patching_in_progress))

		return NOTIFY_DONE;



	/* we are not interested in non-int3 faults and ring > 0 faults */

	if (val != DIE_INT3 || !args->regs || user_mode_vm(args->regs)

			    || args->regs->ip != (unsigned long)bp_int3_addr)

		return NOTIFY_DONE;



	/* set up the specified breakpoint handler */

	args->regs->ip = (unsigned long) bp_int3_handler;



	return NOTIFY_STOP;

}

/**

 * text_poke_bp() -- update instructions on live kernel on SMP

 * @addr:	address to patch

 * @opcode:	opcode of new instruction

 * @len:	length to copy

 * @handler:	address to jump to when the temporary breakpoint is hit

 *

 * Modify multi-byte instruction by using int3 breakpoint on SMP.

 * In contrary to text_poke_smp(), we completely avoid stop_machine() here,

 * and achieve the synchronization using int3 breakpoint.

 *

 * The way it is done:

 *	- add a int3 trap to the address that will be patched

 *	- sync cores

 *	- update all but the first byte of the patched range

 *	- sync cores

 *	- replace the first byte (int3) by the first byte of

 *	  replacing opcode

 *	- sync cores

 *

 * Note: must be called under text_mutex.

 */

void *text_poke_bp(void *addr, const void *opcode, size_t len, void *handler)

{

	unsigned char int3 = 0xcc;



	bp_int3_handler = handler;

	bp_int3_addr = (u8 *)addr + sizeof(int3);

	bp_patching_in_progress = true;

	/*

	 * Corresponding read barrier in int3 notifier for

	 * making sure the in_progress flags is correctly ordered wrt.

	 * patching

	 */

	smp_wmb();



	text_poke(addr, &int3, sizeof(int3));



	on_each_cpu(do_sync_core, NULL, 1);



	if (len - sizeof(int3) > 0) {

		/* patch all but the first byte */

		text_poke((char *)addr + sizeof(int3),

			  (const char *) opcode + sizeof(int3),

			  len - sizeof(int3));

		/*

		 * According to Intel, this core syncing is very likely

		 * not necessary and we'd be safe even without it. But

		 * better safe than sorry (plus there's not only Intel).

		 */

		on_each_cpu(do_sync_core, NULL, 1);

	}



	/* patch the first byte */

	text_poke(addr, opcode, sizeof(int3));



	on_each_cpu(do_sync_core, NULL, 1);



	bp_patching_in_progress = false;

	smp_wmb();



	return addr;

}



/* this one needs to run before anything else handles it as a

 * regular exception */

static struct notifier_block int3_nb = {

	.priority = 0x7fffffff,

	.notifier_call = int3_notify

};



static int __init int3_init(void)

{

	return register_die_notifier(&int3_nb);

}



arch_initcall(int3_init);

/*

 * Cross-modifying kernel text with stop_machine().

 * This code originally comes from immediate value.

kernel/kprobes.c

+1 −1
Original line number Diff line number Diff line
@@ -1709,7 +1709,7 @@ EXPORT_SYMBOL_GPL(unregister_kprobes); 


static struct notifier_block kprobe_exceptions_nb = {

	.notifier_call = kprobe_exceptions_notify,

	.priority = 0x7fffffff /* we need to be notified first */

	.priority = 0x7ffffff0 /* High priority, but not first.  */

};



unsigned long __weak arch_deref_entry_point(void *entry)

CRA Git | Maintained and supported by SUSTech CRA and CCSE