Subversion Repositories HelenOS

/*

 * Copyright (c) 2005 Ondrej Palkovsky

 * All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

 * are met:

 *

 * - Redistributions of source code must retain the above copyright

 *   notice, this list of conditions and the following disclaimer.

 * - Redistributions in binary form must reproduce the above copyright

 *   notice, this list of conditions and the following disclaimer in the

 *   documentation and/or other materials provided with the distribution.

 * - The name of the author may not be used to endorse or promote products

 *   derived from this software without specific prior written permission.

 *

 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR

 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES

 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.

 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,

 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT

 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF

 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 */

/** @addtogroup mips32debug

 * @{

 */

/** @file

 */

#include <arch/debugger.h>

#include <arch/barrier.h>

#include <memstr.h>

#include <console/kconsole.h>

#include <console/cmd.h>

#include <print.h>

#include <panic.h>

#include <arch.h>

#include <arch/cp0.h>

#include <func.h>

#ifdef CONFIG_SYMTAB

#include <symtab.h>

#endif

bpinfo_t breakpoints[BKPOINTS_MAX];

SPINLOCK_INITIALIZE(bkpoint_lock);

#ifdef CONFIG_KCONSOLE

static int cmd_print_breakpoints(cmd_arg_t *argv);

static cmd_info_t bkpts_info = {

	.name = "bkpts",

	.description = "Print breakpoint table.",

	.func = cmd_print_breakpoints,

	.argc = 0,

};

static int cmd_del_breakpoint(cmd_arg_t *argv);

static cmd_arg_t del_argv = {

	.type = ARG_TYPE_INT

};

static cmd_info_t delbkpt_info = {

	.name = "delbkpt",

	.description = "delbkpt <number> - Delete breakpoint.",

	.func = cmd_del_breakpoint,

	.argc = 1,

	.argv = &del_argv

};

static int cmd_add_breakpoint(cmd_arg_t *argv);

static cmd_arg_t add_argv = {

	.type = ARG_TYPE_INT

};

static cmd_info_t addbkpt_info = {

	.name = "addbkpt",

	.description = "addbkpt <&symbol> - new bkpoint. Break on J/Branch "

	    "insts unsupported.",

	.func = cmd_add_breakpoint,

	.argc = 1,

	.argv = &add_argv

};

static cmd_arg_t adde_argv[] = {

	{ .type = ARG_TYPE_INT },

	{ .type = ARG_TYPE_INT }

};

static cmd_info_t addbkpte_info = {

	.name = "addbkpte",

	.description = "addebkpte <&symbol> <&func> - new bkpoint. Call "

	    "func(or Nothing if 0).",

	.func = cmd_add_breakpoint,

	.argc = 2,

	.argv = adde_argv

};

static struct {

	uint32_t andmask;

	uint32_t value;

} jmpinstr[] = {

	{0xf3ff0000, 0x41000000}, /* BCzF */

	{0xf3ff0000, 0x41020000}, /* BCzFL */

	{0xf3ff0000, 0x41010000}, /* BCzT */

	{0xf3ff0000, 0x41030000}, /* BCzTL */

	{0xfc000000, 0x10000000}, /* BEQ */

	{0xfc000000, 0x50000000}, /* BEQL */

	{0xfc1f0000, 0x04010000}, /* BEQL */

	{0xfc1f0000, 0x04110000}, /* BGEZAL */

	{0xfc1f0000, 0x04130000}, /* BGEZALL */

	{0xfc1f0000, 0x04030000}, /* BGEZL */

	{0xfc1f0000, 0x1c000000}, /* BGTZ */

	{0xfc1f0000, 0x5c000000}, /* BGTZL */

	{0xfc1f0000, 0x18000000}, /* BLEZ */

	{0xfc1f0000, 0x58000000}, /* BLEZL */

	{0xfc1f0000, 0x04000000}, /* BLTZ */

	{0xfc1f0000, 0x04100000}, /* BLTZAL */

	{0xfc1f0000, 0x04120000}, /* BLTZALL */

	{0xfc1f0000, 0x04020000}, /* BLTZL */

	{0xfc000000, 0x14000000}, /* BNE */

	{0xfc000000, 0x54000000}, /* BNEL */

	{0xfc000000, 0x08000000}, /* J */

	{0xfc000000, 0x0c000000}, /* JAL */

	{0xfc1f07ff, 0x00000009}, /* JALR */

	{0, 0} /* EndOfTable */

};

/** Test, if the given instruction is a jump or branch instruction

 *

 * @param instr Instruction code

 * @return true - it is jump instruction, false otherwise

 *

 */

static bool is_jump(unative_t instr)

{

	int i;

	for (i = 0; jmpinstr[i].andmask; i++) {

		if ((instr & jmpinstr[i].andmask) == jmpinstr[i].value)

			return true;

	}

	return false;

}

/** Add new breakpoint to table */

int cmd_add_breakpoint(cmd_arg_t *argv)

{

	bpinfo_t *cur = NULL;

	ipl_t ipl;

	int i;

	if (argv->intval & 0x3) {

		printf("Not aligned instruction, forgot to use &symbol?\n");

		return 1;

	}

	ipl = interrupts_disable();

	spinlock_lock(&bkpoint_lock);

	/* Check, that the breakpoints do not conflict */

	for (i = 0; i < BKPOINTS_MAX; i++) {

		if (breakpoints[i].address == (uintptr_t)argv->intval) {

			printf("Duplicate breakpoint %d.\n", i);

			spinlock_unlock(&bkpoint_lock);

			return 0;

		} else if (breakpoints[i].address == (uintptr_t)argv->intval +

		    sizeof(unative_t) || breakpoints[i].address ==

		    (uintptr_t)argv->intval - sizeof(unative_t)) {

			printf("Adjacent breakpoints not supported, conflict "

			    "with %d.\n", i);

			spinlock_unlock(&bkpoint_lock);

			return 0;

		}

	}

	for (i = 0; i < BKPOINTS_MAX; i++)

		if (!breakpoints[i].address) {

			cur = &breakpoints[i];

			break;

		}

	if (!cur) {

		printf("Too many breakpoints.\n");

		spinlock_unlock(&bkpoint_lock);

		interrupts_restore(ipl);

		return 0;

	}

	cur->address = (uintptr_t) argv->intval;

	printf("Adding breakpoint on address: %p\n", argv->intval);

	cur->instruction = ((unative_t *)cur->address)[0];

	cur->nextinstruction = ((unative_t *)cur->address)[1];

	if (argv == &add_argv) {

		cur->flags = 0;

	} else { /* We are add extended */

		cur->flags = BKPOINT_FUNCCALL;

		cur->bkfunc = (void (*)(void *, istate_t *)) argv[1].intval;

	}

	if (is_jump(cur->instruction))

		cur->flags |= BKPOINT_ONESHOT;

	cur->counter = 0;

	/* Set breakpoint */

	*((unative_t *)cur->address) = 0x0d;

	smc_coherence(cur->address);

	spinlock_unlock(&bkpoint_lock);

	interrupts_restore(ipl);

	return 1;

}

/** Remove breakpoint from table */

int cmd_del_breakpoint(cmd_arg_t *argv)

{

	bpinfo_t *cur;

	ipl_t ipl;

	if (argv->intval > BKPOINTS_MAX) {

		printf("Invalid breakpoint number.\n");

		return 0;

	}

	ipl = interrupts_disable();

	spinlock_lock(&bkpoint_lock);

	cur = &breakpoints[argv->intval];

	if (!cur->address) {

		printf("Breakpoint does not exist.\n");

		spinlock_unlock(&bkpoint_lock);

		interrupts_restore(ipl);

		return 0;

	}

	if ((cur->flags & BKPOINT_INPROG) && (cur->flags & BKPOINT_ONESHOT)) {

		printf("Cannot remove one-shot breakpoint in-progress\n");

		spinlock_unlock(&bkpoint_lock);

		interrupts_restore(ipl);

		return 0;

	}

	((uint32_t *)cur->address)[0] = cur->instruction;

	smc_coherence(((uint32_t *)cur->address)[0]);

	((uint32_t *)cur->address)[1] = cur->nextinstruction;

	smc_coherence(((uint32_t *)cur->address)[1]);

	cur->address = NULL;

	spinlock_unlock(&bkpoint_lock);

	interrupts_restore(ipl);

	return 1;

}

/** Print table of active breakpoints */

int cmd_print_breakpoints(cmd_arg_t *argv)

{

	unsigned int i;

	char *symbol;

	printf("#  Count Address    INPROG ONESHOT FUNCCALL In symbol\n");

	printf("-- ----- ---------- ------ ------- -------- ---------\n");

	for (i = 0; i < BKPOINTS_MAX; i++)

		if (breakpoints[i].address) {

#ifdef CONFIG_SYMTAB

			symbol = get_symtab_entry(breakpoints[i].address);

#else

			symbol = "n/a";

#endif

			printf("%-2u %-5d %#10zx %-6s %-7s %-8s %s\n", i,

			    breakpoints[i].counter, breakpoints[i].address,

			    ((breakpoints[i].flags & BKPOINT_INPROG) ? "true" :

			    "false"), ((breakpoints[i].flags & BKPOINT_ONESHOT)

			    ? "true" : "false"), ((breakpoints[i].flags &

			    BKPOINT_FUNCCALL) ? "true" : "false"), symbol);

		}

	return 1;

}

#endif

/** Initialize debugger */

void debugger_init()

{

	int i;

	for (i = 0; i < BKPOINTS_MAX; i++)

		breakpoints[i].address = NULL;

#ifdef CONFIG_KCONSOLE

	cmd_initialize(&bkpts_info);

	if (!cmd_register(&bkpts_info))

		printf("Cannot register command %s\n", bkpts_info.name);

	cmd_initialize(&delbkpt_info);

	if (!cmd_register(&delbkpt_info))

		printf("Cannot register command %s\n", delbkpt_info.name);

	cmd_initialize(&addbkpt_info);

	if (!cmd_register(&addbkpt_info))

		printf("Cannot register command %s\n", addbkpt_info.name);

	cmd_initialize(&addbkpte_info);

	if (!cmd_register(&addbkpte_info))

		printf("Cannot register command %s\n", addbkpte_info.name);

#endif

}

/** Handle breakpoint

 *

 * Find breakpoint in breakpoint table. 

 * If found, call kconsole, set break on next instruction and reexecute.

 * If we are on "next instruction", set it back on the first and reexecute.

 * If breakpoint not found in breakpoint table, call kconsole and start

 * next instruction.

 */

void debugger_bpoint(istate_t *istate)

{

	bpinfo_t *cur = NULL;

	uintptr_t fireaddr = istate->epc;

	int i;

	/* test branch delay slot */

	if (cp0_cause_read() & 0x80000000)

		panic("Breakpoint in branch delay slot not supported.");

	spinlock_lock(&bkpoint_lock);

	for (i = 0; i < BKPOINTS_MAX; i++) {

		/* Normal breakpoint */

		if (fireaddr == breakpoints[i].address &&

		    !(breakpoints[i].flags & BKPOINT_REINST)) {

			cur = &breakpoints[i];

			break;

		}

		/* Reinst only breakpoint */

		if ((breakpoints[i].flags & BKPOINT_REINST) &&

		    (fireaddr == breakpoints[i].address + sizeof(unative_t))) {

			cur = &breakpoints[i];

			break;

		}

	}

	if (cur) {

		if (cur->flags & BKPOINT_REINST) {

			/* Set breakpoint on first instruction */

			((uint32_t *)cur->address)[0] = 0x0d;

			smc_coherence(((uint32_t *)cur->address)[0]);

			/* Return back the second */

			((uint32_t *)cur->address)[1] = cur->nextinstruction;

			smc_coherence(((uint32_t *)cur->address)[1]);

			cur->flags &= ~BKPOINT_REINST;

			spinlock_unlock(&bkpoint_lock);

			return;

		} 

		if (cur->flags & BKPOINT_INPROG)

			printf("Warning: breakpoint recursion\n");

		if (!(cur->flags & BKPOINT_FUNCCALL)) {

#ifdef CONFIG_SYMTAB

			printf("***Breakpoint %d: %p in %s.\n", i, fireaddr,

			    get_symtab_entry(istate->epc));

#else

			printf("***Breakpoint %d: %p.\n", i, fireaddr);

#endif

		}

		/* Return first instruction back */

		((uint32_t *)cur->address)[0] = cur->instruction;

		smc_coherence(cur->address);

		if (! (cur->flags & BKPOINT_ONESHOT)) {

			/* Set Breakpoint on next instruction */

			((uint32_t *)cur->address)[1] = 0x0d;

			cur->flags |= BKPOINT_REINST;

		} 

		cur->flags |= BKPOINT_INPROG;

	} else {

#ifdef CONFIG_SYMTAB

		printf("***Breakpoint %p in %s.\n", fireaddr,

		       get_symtab_entry(fireaddr));

#else

		printf("***Breakpoint %p.\n", fireaddr);	

#endif

		/* Move on to next instruction */

		istate->epc += 4;

	}

	if (cur)

		cur->counter++;

	if (cur && (cur->flags & BKPOINT_FUNCCALL)) {

		/* Allow zero bkfunc, just for counting */

		if (cur->bkfunc)

			cur->bkfunc(cur, istate);

	} else {

#ifdef CONFIG_KCONSOLE

		/* This disables all other processors - we are not SMP,

		 * actually this gets us to cpu_halt, if scheduler() is run

		 * - we generally do not want scheduler to be run from debug,

		 *   so this is a good idea

		 */	

		atomic_set(&haltstate, 1);

		spinlock_unlock(&bkpoint_lock);

		kconsole("debug", "Debug console ready.\n", false);

		spinlock_lock(&bkpoint_lock);

		atomic_set(&haltstate, 0);

#endif

	}

	if (cur && cur->address == fireaddr && (cur->flags & BKPOINT_INPROG)) {

		/* Remove one-shot breakpoint */

		if ((cur->flags & BKPOINT_ONESHOT))

			cur->address = NULL;

		/* Remove in-progress flag */

		cur->flags &= ~BKPOINT_INPROG;

	} 

	spinlock_unlock(&bkpoint_lock);

}

/** @}

 */