scheduler/debugger.c

   1 /*
   2  * Win32 debugger functions
   3  *
   4  * Copyright (C) 1999 Alexandre Julliard
   5  */
   6
   7 #include "process.h"
   8 #include "thread.h"
   9 #include "server/request.h"
  10 #include "server.h"
  11 #include "debugtools.h"
  12
  13
  14 /**********************************************************************
  15  *           DEBUG_SendEvent
  16  *
  17  * Internal helper to send a debug event request to the server.
  18  */
  19 static DWORD DEBUG_SendEvent( int code, void *data, int size )
  20 {
  21     struct send_debug_event_request req;
  22     struct send_debug_event_reply reply;
  23
  24     req.code = code;
  25     CLIENT_SendRequest( REQ_SEND_DEBUG_EVENT, -1, 2, &req, sizeof(req), data, size );
  26     if (CLIENT_WaitSimpleReply( &reply, sizeof(reply), NULL )) return 0;
  27     return reply.status;
  28 }
  29
  30
  31 /**********************************************************************
  32  *           DEBUG_SendExceptionEvent
  33  *
  34  * Send an EXCEPTION_DEBUG_EVENT event to the current process debugger.
  35  */
  36 DWORD DEBUG_SendExceptionEvent( EXCEPTION_RECORD *rec, BOOL first_chance )
  37 {
  38     struct debug_event_exception event;
  39     int i;
  40
  41     event.code      = rec->ExceptionCode;
  42     event.flags     = rec->ExceptionFlags;
  43     event.record    = rec->ExceptionRecord;
  44     event.addr      = rec->ExceptionAddress;
  45     event.nb_params = rec->NumberParameters;
  46     for (i = 0; i < event.nb_params; i++) event.params[i] = rec->ExceptionInformation[i];
  47     event.first_chance = first_chance;
  48     return DEBUG_SendEvent( EXCEPTION_DEBUG_EVENT, &event, sizeof(event) );
  49 }
  50
  51
  52 /**********************************************************************
  53  *           DEBUG_SendCreateProcessEvent
  54  *
  55  * Send an CREATE_PROCESS_DEBUG_EVENT event to the current process debugger.
  56  * Must be called from the context of the new process.
  57  */
  58 DWORD DEBUG_SendCreateProcessEvent( HFILE file, HMODULE module, void *entry )
  59 {
  60     struct debug_event_create_process event;
  61
  62     event.file       = file;
  63     event.process    = 0; /* will be filled by server */
  64     event.thread     = 0; /* will be filled by server */
  65     event.base       = (void *)module;
  66     event.dbg_offset = 0; /* FIXME */
  67     event.dbg_size   = 0; /* FIXME */
  68     event.teb        = NtCurrentTeb();
  69     event.start      = entry;
  70     event.name       = 0; /* FIXME */
  71     event.unicode    = 0; /* FIXME */
  72     return DEBUG_SendEvent( CREATE_PROCESS_DEBUG_EVENT, &event, sizeof(event) );
  73 }
  74
  75
  76 /**********************************************************************
  77  *           DEBUG_SendCreateThreadEvent
  78  *
  79  * Send an CREATE_THREAD_DEBUG_EVENT event to the current process debugger.
  80  * Must be called from the context of the new thread.
  81  */
  82 DWORD DEBUG_SendCreateThreadEvent( void *entry )
  83 {
  84     struct debug_event_create_thread event;
  85
  86     event.handle = 0; /* will be filled by server */
  87     event.teb    = NtCurrentTeb();
  88     event.start  = entry;
  89     return DEBUG_SendEvent( CREATE_THREAD_DEBUG_EVENT, &event, sizeof(event) );
  90 }
  91
  92
  93 /**********************************************************************
  94  *           DEBUG_SendLoadDLLEvent
  95  *
  96  * Send an LOAD_DLL_DEBUG_EVENT event to the current process debugger.
  97  */
  98 DWORD DEBUG_SendLoadDLLEvent( HFILE file, HMODULE module, LPSTR name )
  99 {
 100     struct debug_event_load_dll event;
 101
 102     event.handle     = file;
 103     event.base       = (void *)module;
 104     event.dbg_offset = 0;  /* FIXME */
 105     event.dbg_size   = 0;  /* FIXME */
 106     event.name       = name;
 107     event.unicode    = 0;
 108     return DEBUG_SendEvent( LOAD_DLL_DEBUG_EVENT, &event, sizeof(event) );
 109 }
 110
 111
 112 /**********************************************************************
 113  *           DEBUG_SendUnloadDLLEvent
 114  *
 115  * Send an UNLOAD_DLL_DEBUG_EVENT event to the current process debugger.
 116  */
 117 DWORD DEBUG_SendUnloadDLLEvent( HMODULE module )
 118 {
 119     struct debug_event_unload_dll event;
 120
 121     event.base = (void *)module;
 122     return DEBUG_SendEvent( UNLOAD_DLL_DEBUG_EVENT, &event, sizeof(event) );
 123 }
 124
 125
 126 /******************************************************************************
 127  *           WaitForDebugEvent   (KERNEL32.720)
 128  *
 129  * Waits for a debugging event to occur in a process being debugged
 130  *
 131  * PARAMS
 132  *    event   [I] Address of structure for event information
 133  *    timeout [I] Number of milliseconds to wait for event
 134  *
 135  * RETURNS STD
 136  */
 137 BOOL WINAPI WaitForDebugEvent( LPDEBUG_EVENT event, DWORD timeout )
 138 {
 139     /* size of the event data */
 140     static const int event_sizes[] =
 141     {
 142         0,
 143         sizeof(struct debug_event_exception),       /* EXCEPTION_DEBUG_EVENT */
 144         sizeof(struct debug_event_create_thread),   /* CREATE_THREAD_DEBUG_EVENT */
 145         sizeof(struct debug_event_create_process),  /* CREATE_PROCESS_DEBUG_EVENT */
 146         sizeof(struct debug_event_exit),            /* EXIT_THREAD_DEBUG_EVENT */
 147         sizeof(struct debug_event_exit),            /* EXIT_PROCESS_DEBUG_EVENT */
 148         sizeof(struct debug_event_load_dll),        /* LOAD_DLL_DEBUG_EVENT */
 149         sizeof(struct debug_event_unload_dll),      /* UNLOAD_DLL_DEBUG_EVENT */
 150         sizeof(struct debug_event_output_string),   /* OUTPUT_DEBUG_STRING_EVENT */
 151         sizeof(struct debug_event_rip_info)         /* RIP_EVENT */
 152     };
 153
 154     struct wait_debug_event_request req;
 155     struct wait_debug_event_reply reply;
 156     union debug_event_data data;
 157     int i, len;
 158
 159     req.timeout = timeout;
 160     CLIENT_SendRequest( REQ_WAIT_DEBUG_EVENT, -1, 1, &req, sizeof(req) );
 161     if (CLIENT_WaitReply( &len, NULL, 2, &reply, sizeof(reply),
 162                           &data, sizeof(data) )) return FALSE;
 163     if ((reply.code < 0) || (reply.code > RIP_EVENT))
 164         CLIENT_ProtocolError( "WaitForDebugEvent: bad code %d\n", reply.code );
 165     if (len != sizeof(reply) + event_sizes[reply.code])
 166         CLIENT_ProtocolError( "WaitForDebugEvent: bad len %d for code %d\n", len, reply.code );
 167
 168     event->dwDebugEventCode = reply.code;
 169     event->dwProcessId      = (DWORD)reply.pid;
 170     event->dwThreadId       = (DWORD)reply.tid;
 171     switch(reply.code)
 172     {
 173     case EXCEPTION_DEBUG_EVENT:
 174         event->u.Exception.ExceptionRecord.ExceptionCode    = data.exception.code;
 175         event->u.Exception.ExceptionRecord.ExceptionFlags   = data.exception.flags;
 176         event->u.Exception.ExceptionRecord.ExceptionRecord  = data.exception.record;
 177         event->u.Exception.ExceptionRecord.ExceptionAddress = data.exception.addr;
 178         event->u.Exception.ExceptionRecord.NumberParameters = data.exception.nb_params;
 179         for (i = 0; i < data.exception.nb_params; i++)
 180             event->u.Exception.ExceptionRecord.ExceptionInformation[i] = data.exception.params[i];
 181         event->u.Exception.dwFirstChance = data.exception.first_chance;
 182         break;
 183     case CREATE_THREAD_DEBUG_EVENT:
 184         event->u.CreateThread.hThread           = data.create_thread.handle;
 185         event->u.CreateThread.lpThreadLocalBase = data.create_thread.teb;
 186         event->u.CreateThread.lpStartAddress    = data.create_thread.start;
 187         break;
 188     case CREATE_PROCESS_DEBUG_EVENT:
 189         event->u.CreateProcessInfo.hFile                 = data.create_process.file;
 190         event->u.CreateProcessInfo.hProcess              = data.create_process.process;
 191         event->u.CreateProcessInfo.hThread               = data.create_process.thread;
 192         event->u.CreateProcessInfo.lpBaseOfImage         = data.create_process.base;
 193         event->u.CreateProcessInfo.dwDebugInfoFileOffset = data.create_process.dbg_offset;
 194         event->u.CreateProcessInfo.nDebugInfoSize        = data.create_process.dbg_size;
 195         event->u.CreateProcessInfo.lpThreadLocalBase     = data.create_process.teb;
 196         event->u.CreateProcessInfo.lpStartAddress        = data.create_process.start;
 197         event->u.CreateProcessInfo.lpImageName           = data.create_process.name;
 198         event->u.CreateProcessInfo.fUnicode              = data.create_process.unicode;
 199         if (data.create_process.file == -1) event->u.CreateProcessInfo.hFile = 0;
 200         break;
 201     case EXIT_THREAD_DEBUG_EVENT:
 202         event->u.ExitThread.dwExitCode = data.exit.exit_code;
 203         break;
 204     case EXIT_PROCESS_DEBUG_EVENT:
 205         event->u.ExitProcess.dwExitCode = data.exit.exit_code;
 206         break;
 207     case LOAD_DLL_DEBUG_EVENT:
 208         event->u.LoadDll.hFile                 = data.load_dll.handle;
 209         event->u.LoadDll.lpBaseOfDll           = data.load_dll.base;
 210         event->u.LoadDll.dwDebugInfoFileOffset = data.load_dll.dbg_offset;
 211         event->u.LoadDll.nDebugInfoSize        = data.load_dll.dbg_size;
 212         event->u.LoadDll.lpImageName           = data.load_dll.name;
 213         event->u.LoadDll.fUnicode              = data.load_dll.unicode;
 214         if (data.load_dll.handle == -1) event->u.LoadDll.hFile = 0;
 215         break;
 216     case UNLOAD_DLL_DEBUG_EVENT:
 217         event->u.UnloadDll.lpBaseOfDll = data.unload_dll.base;
 218         break;
 219     case OUTPUT_DEBUG_STRING_EVENT:
 220         event->u.DebugString.lpDebugStringData  = data.output_string.string;
 221         event->u.DebugString.fUnicode           = data.output_string.unicode;
 222         event->u.DebugString.nDebugStringLength = data.output_string.length;
 223         break;
 224     case RIP_EVENT:
 225         event->u.RipInfo.dwError = data.rip_info.error;
 226         event->u.RipInfo.dwType  = data.rip_info.type;
 227         break;
 228     }
 229     return TRUE;
 230 }
 231
 232
 233 /**********************************************************************
 234  *           ContinueDebugEvent   (KERNEL32.146)
 235  */
 236 BOOL WINAPI ContinueDebugEvent( DWORD pid, DWORD tid, DWORD status )
 237 {
 238     struct continue_debug_event_request req;
 239
 240     req.pid    = (void *)pid;
 241     req.tid    = (void *)tid;
 242     req.status = status;
 243     CLIENT_SendRequest( REQ_CONTINUE_DEBUG_EVENT, -1, 1, &req, sizeof(req) );
 244     return !CLIENT_WaitReply( NULL, NULL, 0 );
 245 }
 246
 247
 248 /**********************************************************************
 249  *           DebugActiveProcess   (KERNEL32.180)
 250  */
 251 BOOL WINAPI DebugActiveProcess( DWORD pid )
 252 {
 253     struct debug_process_request req;
 254     req.pid = (void *)pid;
 255     CLIENT_SendRequest( REQ_DEBUG_PROCESS, -1, 1, &req, sizeof(req) );
 256     return !CLIENT_WaitReply( NULL, NULL, 0 );
 257 }
 258
 259
 260 /***********************************************************************
 261  *           OutputDebugStringA   (KERNEL32.548)
 262  */
 263 void WINAPI OutputDebugStringA( LPCSTR str )
 264 {
 265     if (PROCESS_Current()->flags & PDB32_DEBUGGED)
 266     {
 267         struct debug_event_output_string event;
 268         event.string  = (void *)str;
 269         event.unicode = 0;
 270         event.length  = strlen(str) + 1;
 271         DEBUG_SendEvent( OUTPUT_DEBUG_STRING_EVENT, &event, sizeof(event) );
 272     }
 273     else DPRINTF("OutputDebugStringA: %s\n", debugstr_a(str) );
 274 }
 275
 276
 277 /***********************************************************************
 278  *           OutputDebugStringW   (KERNEL32.549)
 279  */
 280 void WINAPI OutputDebugStringW( LPCWSTR str )
 281 {
 282     if (PROCESS_Current()->flags & PDB32_DEBUGGED)
 283     {
 284         struct debug_event_output_string event;
 285         event.string  = (void *)str;
 286         event.unicode = 1;
 287         event.length  = (lstrlenW(str) + 1) * sizeof(WCHAR);
 288         DEBUG_SendEvent( OUTPUT_DEBUG_STRING_EVENT, &event, sizeof(event) );
 289     }
 290     else DPRINTF("OutputDebugStringW: %s\n", debugstr_w(str) );
 291 }
 292
 293
 294 /***********************************************************************
 295  *           OutputDebugString16   (KERNEL.115)
 296  */
 297 void WINAPI OutputDebugString16( LPCSTR str )
 298 {
 299     OutputDebugStringA( str );
 300 }