source: mainline/kernel/generic/src/interrupt/interrupt.c@ fd3a631f

/*
 * 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 genericinterrupt
 * @{
 */
/**
 * @file
 * @brief Interrupt redirector.
 *
 * This file provides means of registering interrupt handlers
 * by kernel functions and calling the handlers when interrupts
 * occur.
 *
 */

#include <interrupt.h>
#include <debug.h>
#include <console/kconsole.h>
#include <console/console.h>
#include <console/cmd.h>
#include <ipc/event.h>
#include <synch/mutex.h>
#include <time/delay.h>
#include <macros.h>
#include <panic.h>
#include <print.h>
#include <symtab.h>
#include <proc/thread.h>
#include <arch/cycle.h>
#include <str.h>

exc_table_t exc_table[IVT_ITEMS];
IRQ_SPINLOCK_INITIALIZE(exctbl_lock);

/** Register exception handler
 *
 * @param n       Exception number.
 * @param name    Description.
 * @param hot     Whether the exception is actually handled
 *                in any meaningful way.
 * @param handler New exception handler.
 *
 * @return Previously registered exception handler.
 *
 */
iroutine_t exc_register(unsigned int n, const char *name, bool hot,
    iroutine_t handler)
{
#if (IVT_ITEMS > 0)
        ASSERT(n < IVT_ITEMS);
#endif
        
        irq_spinlock_lock(&exctbl_lock, true);
        
        iroutine_t old = exc_table[n].handler;
        exc_table[n].handler = handler;
        exc_table[n].name = name;
        exc_table[n].hot = hot;
        exc_table[n].cycles = 0;
        exc_table[n].count = 0;
        
        irq_spinlock_unlock(&exctbl_lock, true);
        
        return old;
}

/** Dispatch exception according to exception table
 *
 * Called directly from the assembler code.
 * CPU is interrupts_disable()'d.
 *
 */
void exc_dispatch(unsigned int n, istate_t *istate)
{
#if (IVT_ITEMS > 0)
        ASSERT(n < IVT_ITEMS);
#endif
        
        /* Account user cycles */
        if (THREAD) {
                irq_spinlock_lock(&THREAD->lock, false);
                thread_update_accounting(true);
                irq_spinlock_unlock(&THREAD->lock, false);
        }
        
        uint64_t begin_cycle = get_cycle();
        
#ifdef CONFIG_UDEBUG
        if (THREAD)
                THREAD->udebug.uspace_state = istate;
#endif
        
        exc_table[n].handler(n + IVT_FIRST, istate);
        
#ifdef CONFIG_UDEBUG
        if (THREAD)
                THREAD->udebug.uspace_state = NULL;
#endif
        
        /* This is a safe place to exit exiting thread */
        if ((THREAD) && (THREAD->interrupted) && (istate_from_uspace(istate)))
                thread_exit();
        
        /* Account exception handling */
        uint64_t end_cycle = get_cycle();
        
        exc_table[n].cycles += end_cycle - begin_cycle;
        exc_table[n].count++;
        
        /* Do not charge THREAD for exception cycles */
        if (THREAD) {
                irq_spinlock_lock(&THREAD->lock, false);
                THREAD->last_cycle = end_cycle;
                irq_spinlock_unlock(&THREAD->lock, false);
        }
}

/** Default 'null' exception handler
 *
 */
static void exc_undef(unsigned int n, istate_t *istate)
{
        fault_if_from_uspace(istate, "Unhandled exception %u.", n);
        panic("Unhandled exception %u.", n);
}

/** Terminate thread and task if exception came from userspace.
 *
 */
void fault_if_from_uspace(istate_t *istate, const char *fmt, ...)
{
        if (!istate_from_uspace(istate))
                return;
        
        printf("Task %s (%" PRIu64 ") killed due to an exception at "
            "program counter %p.\n", TASK->name, TASK->taskid,
            istate_get_pc(istate));
        
        stack_trace_istate(istate);
        
        printf("Kill message: ");
        
        va_list args;
        va_start(args, fmt);
        vprintf(fmt, args);
        va_end(args);
        printf("\n");
        
        /*
         * Userspace can subscribe for FAULT events to take action
         * whenever a thread faults. (E.g. take a dump, run a debugger).
         * The notification is always available, but unless Udebug is enabled,
         * that's all you get.
         */
        if (event_is_subscribed(EVENT_FAULT)) {
                /* Notify the subscriber that a fault occurred. */
                event_notify_3(EVENT_FAULT, LOWER32(TASK->taskid),
                    UPPER32(TASK->taskid), (unative_t) THREAD);
                
#ifdef CONFIG_UDEBUG
                /* Wait for a debugging session. */
                udebug_thread_fault();
#endif
        }
        
        task_kill(TASK->taskid);
        thread_exit();
}

#ifdef CONFIG_KCONSOLE

static char flag_buf[MAX_CMDLINE + 1];

/** Print all exceptions
 *
 */
static int cmd_exc_print(cmd_arg_t *argv)
{
        bool excs_all;
        
        if (str_cmp(flag_buf, "-a") == 0)
                excs_all = true;
        else if (str_cmp(flag_buf, "") == 0)
                excs_all = false;
        else {
                printf("Unknown argument \"%s\".\n", flag_buf);
                return 1;
        }
        
#if (IVT_ITEMS > 0)
        unsigned int i;
        unsigned int rows;
        
        irq_spinlock_lock(&exctbl_lock, true);
        
#ifdef __32_BITS__
        printf("[exc   ] [description       ] [count   ] [cycles  ]"
            " [handler ] [symbol\n");
        rows = 1;
#endif
        
#ifdef __64_BITS__
        printf("[exc   ] [description       ] [count   ] [cycles  ]"
            " [handler         ]\n");
        printf("         [symbol\n");
        rows = 2;
#endif
        
        for (i = 0; i < IVT_ITEMS; i++) {
                if ((!excs_all) && (!exc_table[i].hot))
                        continue;
                
                uint64_t count;
                char count_suffix;
                
                order_suffix(exc_table[i].count, &count, &count_suffix);
                
                uint64_t cycles;
                char cycles_suffix;
                
                order_suffix(exc_table[i].cycles, &cycles, &cycles_suffix);
                
                const char *symbol =
                    symtab_fmt_name_lookup((unative_t) exc_table[i].handler);
                
#ifdef __32_BITS__
                printf("%-8u %-20s %9" PRIu64 "%c %9" PRIu64 "%c %10p %s\n",
                    i + IVT_FIRST, exc_table[i].name, count, count_suffix,
                    cycles, cycles_suffix, exc_table[i].handler, symbol);
                
                PAGING(rows, 1, irq_spinlock_unlock(&exctbl_lock, true),
                    irq_spinlock_lock(&exctbl_lock, true));
#endif
                
#ifdef __64_BITS__
                printf("%-8u %-20s %9" PRIu64 "%c %9" PRIu64 "%c %18p\n",
                    i + IVT_FIRST, exc_table[i].name, count, count_suffix,
                    cycles, cycles_suffix, exc_table[i].handler);
                printf("         %s\n", symbol);
                
                PAGING(rows, 2, irq_spinlock_unlock(&exctbl_lock, true),
                    irq_spinlock_lock(&exctbl_lock, true));
#endif
        }
        
        irq_spinlock_unlock(&exctbl_lock, true);
#else /* (IVT_ITEMS > 0) */
        
        printf("No exception table%s.\n", excs_all ? " (showing all exceptions)" : "");
        
#endif /* (IVT_ITEMS > 0) */
        
        return 1;
}

static cmd_arg_t exc_argv = {
        .type = ARG_TYPE_STRING_OPTIONAL,
        .buffer = flag_buf,
        .len = sizeof(flag_buf)
};

static cmd_info_t exc_info = {
        .name = "exc",
        .description = "Print exception table (use -a for all exceptions).",
        .func = cmd_exc_print,
        .help = NULL,
        .argc = 1,
        .argv = &exc_argv
};

#endif /* CONFIG_KCONSOLE */

/** Initialize generic exception handling support
 *
 */
void exc_init(void)
{
        (void) exc_undef;
        
#if (IVT_ITEMS > 0)
        unsigned int i;
        
        for (i = 0; i < IVT_ITEMS; i++)
                exc_register(i, "undef", false, (iroutine_t) exc_undef);
#endif
        
#ifdef CONFIG_KCONSOLE
        cmd_initialize(&exc_info);
        if (!cmd_register(&exc_info))
                printf("Cannot register command %s\n", exc_info.name);
#endif
}

/** @}
 */