init.c

Go to the documentation of this file.

/*++

Copyright (c) 1998-2001 Klaus P. Gerlicher

Module Name:

    init.c

Abstract:

    initialisation and cleanup of debugger kernel module

Environment:

    Kernel mode only

Author:

    Klaus P. Gerlicher

Revision History:

    25-Jan-1999:    created
    15-Nov-2000:    general cleanup of source files

Copyright notice:

  This file may be distributed under the terms of the GNU Public License.

--*/

// INCLUDES
#include "remods.h"
#include "precomp.h"

// GLOBALS
ULONG ulDoInitialBreak=1;
char szBootParams[1024]="";
char tempInit[256];

PDIRECTORY_OBJECT *pNameSpaceRoot = NULL;
PDEBUG_MODULE pdebug_module_tail = NULL;
PDEBUG_MODULE pdebug_module_head = NULL;
PMADDRESS_SPACE mm_init_mm;
extern LIST_ENTRY *pModuleListHead;

ULONG KeyboardIRQL;

extern void NewInt31Handler(void);
//*************************************************************************
// InitPICE()
//
//*************************************************************************
BOOLEAN InitPICE(void)
{
    ULONG ulHandleScancode=0,ulHandleKbdEvent=0;
    ARGS Args;
    KIRQL Dirql;
    KAFFINITY Affinity;
    ULONG ulAddr;

    ENTER_FUNC();

    DPRINT((0,"InitPICE(): trace step 0.5\n"));
    KeyboardIRQL = HalGetInterruptVector(Internal,
                     0,
                     0,
                     KEYBOARD_IRQ,
                     &Dirql,
                     &Affinity);
    DPRINT((0,"KeyboardIRQL: %x\n", KeyboardIRQL));

    DPRINT((0,"InitPICE(): trace step 1\n"));
    // enable monochrome passthrough on BX type chipset
    EnablePassThrough();

    DPRINT((0,"InitPICE(): trace step 2\n"));
    // now load all symbol files described in /etc/pice.conf
    if(!LoadSymbolsFromConfig(FALSE))
    {
        DPRINT((0,"InitPICE: LoadSymbolsFromConfig() failed\n"));
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 3\n"));
    // init the output console
    // this might be one of the following depending setup
    // a) monochrome card
    // b) serial terminal (TODO)
    if(!ConsoleInit())
    {
        DPRINT((0,"InitPICE: ConsoleInit() failed\n"));
        UnloadSymbols();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 4\n"));
    // print the initial screen template
    PrintTemplate();
/*
    DPRINT((0,"InitPICE(): trace step 5\n"));
    // ask the user if he wants to abort the debugger load
    if(!CheckLoadAbort())
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (abort by user)\n");
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }
*/

    DPRINT((0,"InitPICE(): trace step 6\n"));
    // load the file /boot/System.map.
    // !!! It must be consistent with the current kernel at all cost!!!
    if(!LoadExports())
    {
        Print(OUTPUT_WINDOW,"pICE: failed to load exports\n");
        Print(OUTPUT_WINDOW,"press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 7\n"));
    ScanExports("_KernelAddressSpace", &ulAddr);
    my_init_mm = (PMADDRESS_SPACE) ulAddr;
    DPRINT((0,"init_mm %x @ %x\n",&my_init_mm,my_init_mm));
    if(!my_init_mm)
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (initial memory map not found)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        DbgPrint("pICE: ABORT (initial memory map not found)\n");
        DbgPrint("pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 7.1\n"));
    ScanExports("_ModuleListHead",&ulAddr);
    pModuleListHead = (LIST_ENTRY*)ulAddr;
    DPRINT((0,"pModuleListHead @ %X\n",pModuleListHead));
    if(!pModuleListHead)
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (pModuleListHead not found)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 7.2\n"));
    ScanExports("_PsProcessListHead",&ulAddr);
    pPsProcessListHead = (LIST_ENTRY*)ulAddr;
    DPRINT((0,"pPsProcessListHead @ %X\n",pPsProcessListHead));
    if(!pPsProcessListHead)
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (PsProcessListHead not found)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 8\n"));
    // end of the kernel
    /*
    ScanExports("_end",(PULONG)&kernel_end);
    if(!kernel_end)
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (kernel size is unknown)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadExports();
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }
    */

    DPRINT((0,"InitPICE(): trace step 9\n"));

    // the loaded module list
    ScanExports("_NameSpaceRoot", &ulAddr);
    pNameSpaceRoot = (PDIRECTORY_OBJECT *)ulAddr;
    DPRINT((0,"pNameSpaceRoot @ %X\n",pNameSpaceRoot));
    if(!pNameSpaceRoot)
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (couldn't retreive name space root)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadExports();
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 10\n"));
    // setup a linked list for use in module parsing routines.
    if(!InitModuleList(&pdebug_module_head, 100))
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (couldn't initialize kernel module list)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        FreeModuleList( pdebug_module_head );
        while(!GetKeyPolled());
        UnloadExports();
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }
    pdebug_module_tail = pdebug_module_head;

    DPRINT((0,"InitPICE(): trace step 11\n"));
    // do a sanity check on exports
    if(!SanityCheckExports())
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (exports are conflicting with kernel symbols)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadExports();
        UnloadSymbols();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 12\n"));


    DPRINT((0,"InitPICE(): trace step 13\n"));
    // patch the keyboard driver

    if(!PatchKeyboardDriver())
    {
        Print(OUTPUT_WINDOW,"pICE: ABORT (couldn't patch keyboard driver)\n");
        Print(OUTPUT_WINDOW,"pICE: press any key to continue...\n");
        while(!GetKeyPolled());
        UnloadSymbols();
        UnloadExports();
        ConsoleShutdown();
        LEAVE_FUNC();
        return FALSE;
    }

    DPRINT((0,"InitPICE(): trace step 14\n"));
    // partial init of shadow registers
    CurrentCS = GLOBAL_CODE_SEGMENT;
    CurrentEIP = (ULONG)RealIsr;

    CurrentDS = CurrentSS = GLOBAL_DATA_SEGMENT;
    __asm__("\n\t \
            mov %%esp,%%eax\n\t \
            mov %%eax,_CurrentESP\n\t \
            ":::"eax");


    // display version and symbol information
    Ver(NULL);

    // disable HW breakpoints
    __asm__("\n\t \
        xorl %%eax,%%eax\n\t \
        mov %%eax,%%dr6\n\t \
        mov %%eax,%%dr7\n\t \
        mov %%dr0,%%eax\n\t \
        mov %%dr1,%%eax\n\t \
        mov %%dr2,%%eax\n\t \
        mov %%dr3,%%eax"
        :::"eax"
        );

    DPRINT((0,"InitPICE(): trace step 15\n"));
    TakeIdtSnapshot();

    DPRINT((0,"InitPICE(): trace step 16\n"));
    // install all hooks
    InstallTraceHook();
    InstallGlobalKeyboardHook();
    InstallSyscallHook();
    InstallInt3Hook();
    InstallDblFltHook();
    InstallGPFaultHook();
    InstallIntEHook();
    InstallPrintkHook();

    DPRINT((0,"InitPICE(): trace step 16\n"));
    if(ulDoInitialBreak)
    {
        DPRINT((0,"about to do initial break...\n"));

        // simulate an initial break
        __asm__("\n\t \
            pushfl\n\t \
            pushl %cs\n\t \
            pushl $initialreturnpoint\n\t \
            pushl $" STR(REASON_CTRLF) "\n\t \
            jmp NewInt31Handler\n\t \
initialreturnpoint:");
    }
    else
    {
        // display register contents
        DisplayRegs();

        // display data window
        Args.Value[0]=CurrentDS;
        Args.Value[1]=CurrentEIP;
        Args.Count=2;
        DisplayMemory(&Args);

        // disassembly from current address
        Args.Value[0]=CurrentCS;
        Args.Value[1]=CurrentEIP;
        Args.Count=2;
        Unassemble(&Args);
    }

    DPRINT((0,"InitPICE(): trace step 17\n"));
    InitPiceRunningTimer();

    LEAVE_FUNC();
    return TRUE;
}

//*************************************************************************
// CleanUpPICE()
//
//*************************************************************************
void CleanUpPICE(void)
{
    DPRINT((0,"CleanUpPICE(): trace step 1\n"));
    RemovePiceRunningTimer();

    DPRINT((0,"CleanUpPICE(): trace step 2\n"));
    // de-install all hooks
    DeInstallGlobalKeyboardHook();
    DeInstallSyscallHook();
    DeInstallInt3Hook();
    DeInstallPrintkHook();
    DeInstallDblFltHook();
    DeInstallGPFaultHook();
    DeInstallIntEHook();
    DeInstallTraceHook();

    DPRINT((0,"CleanUpPICE(): trace step 3\n"));
    RestoreIdt();

    DPRINT((0,"CleanUpPICE(): trace step 4\n"));
    UnloadExports(); // don't use ScanExports() after this
    UnloadSymbols();

    DPRINT((0,"CleanUpPICE(): trace step 5\n"));
    // restore patch of keyboard driver
    RestoreKeyboardDriver();

    DPRINT((0,"CleanUpPICE(): trace step 6\n"));
    Print(OUTPUT_WINDOW,"pICE: shutting down...\n");

    DPRINT((0,"CleanUpPICE(): trace step 7\n"));
    // cleanup the console
    ConsoleShutdown();
}