dlls/kernel32/tests/debugger.c

   1 /*
   2  * Unit tests for the debugger facility
   3  *
   4  * Copyright (c) 2007 Francois Gouget for CodeWeavers
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #include <stdio.h>
  22 #include <assert.h>
  23
  24 #include <windows.h>
  25 #include <winreg.h>
  26 #include "wine/test.h"
  27
  28 #ifndef STATUS_DEBUGGER_INACTIVE
  29 #define STATUS_DEBUGGER_INACTIVE         ((NTSTATUS) 0xC0000354)
  30 #endif
  31
  32 static int    myARGC;
  33 static char** myARGV;
  34
  35 static BOOL (WINAPI *pDebugActiveProcessStop)(DWORD);
  36 static BOOL (WINAPI *pDebugSetProcessKillOnExit)(BOOL);
  37
  38 /* Copied from the process test */
  39 static void get_file_name(char* buf)
  40 {
  41     char path[MAX_PATH];
  42
  43     buf[0] = '\0';
  44     GetTempPathA(sizeof(path), path);
  45     GetTempFileNameA(path, "wt", 0, buf);
  46 }
  47
  48 typedef struct tag_reg_save_value
  49 {
  50     const char *name;
  51     DWORD type;
  52     BYTE *data;
  53     DWORD size;
  54 } reg_save_value;
  55
  56 static DWORD save_value(HKEY hkey, const char *value, reg_save_value *saved)
  57 {
  58     DWORD ret;
  59     saved->name=value;
  60     saved->data=0;
  61     saved->size=0;
  62     ret=RegQueryValueExA(hkey, value, NULL, &saved->type, NULL, &saved->size);
  63     if (ret == ERROR_SUCCESS)
  64     {
  65         saved->data=HeapAlloc(GetProcessHeap(), 0, saved->size);
  66         RegQueryValueExA(hkey, value, NULL, &saved->type, saved->data, &saved->size);
  67     }
  68     return ret;
  69 }
  70
  71 static void restore_value(HKEY hkey, reg_save_value *saved)
  72 {
  73     if (saved->data)
  74     {
  75         RegSetValueExA(hkey, saved->name, 0, saved->type, saved->data, saved->size);
  76         HeapFree(GetProcessHeap(), 0, saved->data);
  77     }
  78     else
  79         RegDeleteValueA(hkey, saved->name);
  80 }
  81
  82 static void get_events(const char* name, HANDLE *start_event, HANDLE *done_event)
  83 {
  84     const char* basename;
  85     char* event_name;
  86
  87     basename=strrchr(name, '\\');
  88     basename=(basename ? basename+1 : name);
  89     event_name=HeapAlloc(GetProcessHeap(), 0, 6+strlen(basename)+1);
  90
  91     sprintf(event_name, "start_%s", basename);
  92     *start_event=CreateEvent(NULL, 0,0, event_name);
  93     sprintf(event_name, "done_%s", basename);
  94     *done_event=CreateEvent(NULL, 0,0, event_name);
  95     HeapFree(GetProcessHeap(), 0, event_name);
  96 }
  97
  98 static void save_blackbox(const char* logfile, void* blackbox, int size)
  99 {
 100     HANDLE hFile;
 101     DWORD written;
 102
 103     hFile=CreateFileA(logfile, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, 0, 0);
 104     if (hFile == INVALID_HANDLE_VALUE)
 105         return;
 106     WriteFile(hFile, blackbox, size, &written, NULL);
 107     CloseHandle(hFile);
 108 }
 109
 110 static int load_blackbox(const char* logfile, void* blackbox, int size)
 111 {
 112     HANDLE hFile;
 113     DWORD read;
 114     BOOL ret;
 115
 116     hFile=CreateFileA(logfile, GENERIC_READ, 0, NULL, OPEN_EXISTING, 0, 0);
 117     if (hFile == INVALID_HANDLE_VALUE)
 118     {
 119         ok(0, "unable to open '%s'\n", logfile);
 120         return 0;
 121     }
 122     ret=ReadFile(hFile, blackbox, size, &read, NULL);
 123     ok(read == size, "wrong size for '%s': read=%d\n", logfile, read);
 124     CloseHandle(hFile);
 125     return 1;
 126 }
 127
 128 typedef struct
 129 {
 130     DWORD pid;
 131 } crash_blackbox_t;
 132
 133 static void doCrash(int argc,  char** argv)
 134 {
 135     char* p;
 136
 137     if (argc >= 4)
 138     {
 139         crash_blackbox_t blackbox;
 140         blackbox.pid=GetCurrentProcessId();
 141         save_blackbox(argv[3], &blackbox, sizeof(blackbox));
 142     }
 143
 144     /* Just crash */
 145     trace("child: crashing...\n");
 146     p=NULL;
 147     *p=0;
 148 }
 149
 150 typedef struct
 151 {
 152     int argc;
 153     DWORD pid;
 154     BOOL debug_rc;
 155     DWORD debug_err;
 156     BOOL attach_rc;
 157     DWORD attach_err;
 158     BOOL nokill_rc;
 159     DWORD nokill_err;
 160     BOOL detach_rc;
 161     DWORD detach_err;
 162 } debugger_blackbox_t;
 163
 164 static void doDebugger(int argc, char** argv)
 165 {
 166     const char* logfile;
 167     debugger_blackbox_t blackbox;
 168     HANDLE start_event = 0, done_event = 0, debug_event;
 169
 170     blackbox.argc=argc;
 171     logfile=(argc >= 4 ? argv[3] : NULL);
 172     blackbox.pid=(argc >= 5 ? atol(argv[4]) : 0);
 173
 174     blackbox.attach_err=0;
 175     if (strstr(myARGV[2], "attach"))
 176     {
 177         blackbox.attach_rc=DebugActiveProcess(blackbox.pid);
 178         if (!blackbox.attach_rc)
 179             blackbox.attach_err=GetLastError();
 180     }
 181     else
 182         blackbox.attach_rc=TRUE;
 183
 184     debug_event=(argc >= 6 ? (HANDLE)(INT_PTR)atol(argv[5]) : NULL);
 185     blackbox.debug_err=0;
 186     if (debug_event && strstr(myARGV[2], "event"))
 187     {
 188         blackbox.debug_rc=SetEvent(debug_event);
 189         if (!blackbox.debug_rc)
 190             blackbox.debug_err=GetLastError();
 191     }
 192     else
 193         blackbox.debug_rc=TRUE;
 194
 195     if (logfile)
 196     {
 197         get_events(logfile, &start_event, &done_event);
 198     }
 199
 200     if (strstr(myARGV[2], "order"))
 201     {
 202         trace("debugger: waiting for the start signal...\n");
 203         WaitForSingleObject(start_event, INFINITE);
 204     }
 205
 206     blackbox.nokill_err=0;
 207     if (strstr(myARGV[2], "nokill"))
 208     {
 209         blackbox.nokill_rc=pDebugSetProcessKillOnExit(FALSE);
 210         if (!blackbox.nokill_rc)
 211             blackbox.nokill_err=GetLastError();
 212     }
 213     else
 214         blackbox.nokill_rc=TRUE;
 215
 216     blackbox.detach_err=0;
 217     if (strstr(myARGV[2], "detach"))
 218     {
 219         blackbox.detach_rc=pDebugActiveProcessStop(blackbox.pid);
 220         if (!blackbox.detach_rc)
 221             blackbox.detach_err=GetLastError();
 222     }
 223     else
 224         blackbox.detach_rc=TRUE;
 225
 226     if (logfile)
 227     {
 228         save_blackbox(logfile, &blackbox, sizeof(blackbox));
 229     }
 230     trace("debugger: done debugging...\n");
 231     SetEvent(done_event);
 232
 233     /* Just exit with a known value */
 234     ExitProcess(0xdeadbeef);
 235 }
 236
 237 static void crash_and_debug(HKEY hkey, const char* argv0, const char* dbgtasks)
 238 {
 239     DWORD ret;
 240     HANDLE start_event, done_event;
 241     char* cmd;
 242     char dbglog[MAX_PATH];
 243     char childlog[MAX_PATH];
 244     PROCESS_INFORMATION info;
 245     STARTUPINFOA startup;
 246     DWORD exit_code;
 247     crash_blackbox_t crash_blackbox;
 248     debugger_blackbox_t dbg_blackbox;
 249
 250     ret=RegSetValueExA(hkey, "auto", 0, REG_SZ, (BYTE*)"1", 2);
 251     ok(ret == ERROR_SUCCESS, "unable to set AeDebug/auto: ret=%d\n", ret);
 252
 253     get_file_name(dbglog);
 254     get_events(dbglog, &start_event, &done_event);
 255     cmd=HeapAlloc(GetProcessHeap(), 0, strlen(argv0)+10+strlen(dbgtasks)+1+strlen(dbglog)+34+1);
 256     sprintf(cmd, "%s debugger %s %s %%ld %%ld", argv0, dbgtasks, dbglog);
 257     ret=RegSetValueExA(hkey, "debugger", 0, REG_SZ, (BYTE*)cmd, strlen(cmd)+1);
 258     ok(ret == ERROR_SUCCESS, "unable to set AeDebug/debugger: ret=%d\n", ret);
 259     HeapFree(GetProcessHeap(), 0, cmd);
 260
 261     get_file_name(childlog);
 262     cmd=HeapAlloc(GetProcessHeap(), 0, strlen(argv0)+16+strlen(dbglog)+1);
 263     sprintf(cmd, "%s debugger crash %s", argv0, childlog);
 264
 265     memset(&startup, 0, sizeof(startup));
 266     startup.cb = sizeof(startup);
 267     startup.dwFlags = STARTF_USESHOWWINDOW;
 268     startup.wShowWindow = SW_SHOWNORMAL;
 269     ret=CreateProcessA(NULL, cmd, NULL, NULL, FALSE, 0, NULL, NULL, &startup, &info);
 270     ok(ret, "CreateProcess: err=%d\n", GetLastError());
 271     HeapFree(GetProcessHeap(), 0, cmd);
 272     CloseHandle(info.hThread);
 273
 274     /* The process exits... */
 275     trace("waiting for child exit...\n");
 276     ok(WaitForSingleObject(info.hProcess, 60000) == WAIT_OBJECT_0, "Timed out waiting for the child to crash\n");
 277     ok(GetExitCodeProcess(info.hProcess, &exit_code), "GetExitCodeProcess failed: err=%d\n", GetLastError());
 278     if (strstr(dbgtasks, "code2"))
 279     {
 280         /* If, after attaching to the debuggee, the debugger exits without
 281          * detaching, then the debuggee gets a special exit code.
 282          */
 283         ok(exit_code == STATUS_DEBUGGER_INACTIVE ||
 284            broken(exit_code == 0xffffffff) || /* Win9x */
 285            broken(exit_code == WAIT_ABANDONED), /* NT4, W2K */
 286            "wrong exit code : %08x\n", exit_code);
 287     }
 288     else
 289         ok(exit_code == STATUS_ACCESS_VIOLATION ||
 290            broken(exit_code == WAIT_ABANDONED) || /* NT4, W2K, W2K3 */
 291            broken(exit_code == 0xffffffff), /* Win9x, WinME */
 292            "wrong exit code : %08x\n", exit_code);
 293     CloseHandle(info.hProcess);
 294
 295     /* ...before the debugger */
 296     if (strstr(dbgtasks, "order"))
 297         ok(SetEvent(start_event), "SetEvent(start_event) failed\n");
 298
 299     trace("waiting for the debugger...\n");
 300     ok(WaitForSingleObject(done_event, 60000) == WAIT_OBJECT_0, "Timed out waiting for the debugger\n");
 301
 302     assert(load_blackbox(childlog, &crash_blackbox, sizeof(crash_blackbox)));
 303     assert(load_blackbox(dbglog, &dbg_blackbox, sizeof(dbg_blackbox)));
 304
 305     ok(dbg_blackbox.argc == 6, "wrong debugger argument count: %d\n", dbg_blackbox.argc);
 306     ok(dbg_blackbox.pid == crash_blackbox.pid, "the child and debugged pids don't match: %d != %d\n", crash_blackbox.pid, dbg_blackbox.pid);
 307     ok(dbg_blackbox.debug_rc, "debugger: SetEvent(debug_event) failed err=%d\n", dbg_blackbox.debug_err);
 308     ok(dbg_blackbox.attach_rc, "DebugActiveProcess(%d) failed err=%d\n", dbg_blackbox.pid, dbg_blackbox.attach_err);
 309     ok(dbg_blackbox.nokill_rc, "DebugSetProcessKillOnExit(FALSE) failed err=%d\n", dbg_blackbox.nokill_err);
 310     ok(dbg_blackbox.detach_rc, "DebugActiveProcessStop(%d) failed err=%d\n", dbg_blackbox.pid, dbg_blackbox.detach_err);
 311
 312     assert(DeleteFileA(dbglog) != 0);
 313     assert(DeleteFileA(childlog) != 0);
 314 }
 315
 316 static void crash_and_winedbg(HKEY hkey, const char* argv0)
 317 {
 318     DWORD ret;
 319     char* cmd;
 320     PROCESS_INFORMATION info;
 321     STARTUPINFOA startup;
 322     DWORD exit_code;
 323
 324     ret=RegSetValueExA(hkey, "auto", 0, REG_SZ, (BYTE*)"1", 2);
 325     ok(ret == ERROR_SUCCESS, "unable to set AeDebug/auto: ret=%d\n", ret);
 326
 327     cmd=HeapAlloc(GetProcessHeap(), 0, strlen(argv0)+15+1);
 328     sprintf(cmd, "%s debugger crash", argv0);
 329
 330     memset(&startup, 0, sizeof(startup));
 331     startup.cb = sizeof(startup);
 332     startup.dwFlags = STARTF_USESHOWWINDOW;
 333     startup.wShowWindow = SW_SHOWNORMAL;
 334     ret=CreateProcessA(NULL, cmd, NULL, NULL, FALSE, 0, NULL, NULL, &startup, &info);
 335     ok(ret, "CreateProcess: err=%d\n", GetLastError());
 336     HeapFree(GetProcessHeap(), 0, cmd);
 337     CloseHandle(info.hThread);
 338
 339     trace("waiting for child exit...\n");
 340     ok(WaitForSingleObject(info.hProcess, 60000) == WAIT_OBJECT_0, "Timed out waiting for the child to crash\n");
 341     ok(GetExitCodeProcess(info.hProcess, &exit_code), "GetExitCodeProcess failed: err=%d\n", GetLastError());
 342     ok(exit_code == STATUS_ACCESS_VIOLATION, "exit code = %08x\n", exit_code);
 343     CloseHandle(info.hProcess);
 344 }
 345
 346 static void test_ExitCode(void)
 347 {
 348     static const char* AeDebug="Software\\Microsoft\\Windows NT\\CurrentVersion\\AeDebug";
 349     static const char* WineDbg="Software\\Wine\\WineDbg";
 350     char test_exe[MAX_PATH];
 351     DWORD ret;
 352     HKEY hkey;
 353     DWORD disposition;
 354     reg_save_value auto_value;
 355     reg_save_value debugger_value;
 356
 357     GetModuleFileNameA(GetModuleHandle(NULL), test_exe, sizeof(test_exe));
 358     if (GetFileAttributes(test_exe) == INVALID_FILE_ATTRIBUTES)
 359         strcat(test_exe, ".so");
 360     if (GetFileAttributesA(test_exe) == INVALID_FILE_ATTRIBUTES)
 361     {
 362         ok(0, "could not find the test executable '%s'\n", test_exe);
 363         return;
 364     }
 365
 366     ret=RegCreateKeyExA(HKEY_LOCAL_MACHINE, AeDebug, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hkey, &disposition);
 367     if (ret == ERROR_SUCCESS)
 368     {
 369         save_value(hkey, "auto", &auto_value);
 370         save_value(hkey, "debugger", &debugger_value);
 371         trace("HKLM\\%s\\debugger is set to '%s'\n", AeDebug, debugger_value.data);
 372     }
 373     else if (ret == ERROR_ACCESS_DENIED)
 374     {
 375         skip("not enough privileges to change the debugger\n");
 376         return;
 377     }
 378     else if (ret != ERROR_FILE_NOT_FOUND)
 379     {
 380         ok(0, "could not open the AeDebug key: %d\n", ret);
 381         return;
 382     }
 383
 384     if (debugger_value.data && debugger_value.type == REG_SZ &&
 385         strstr((char*)debugger_value.data, "winedbg --auto"))
 386     {
 387         HKEY hkeyWinedbg;
 388         ret=RegCreateKeyA(HKEY_CURRENT_USER, WineDbg, &hkeyWinedbg);
 389         if (ret == ERROR_SUCCESS)
 390         {
 391             static DWORD zero;
 392             reg_save_value crash_dlg_value;
 393             save_value(hkeyWinedbg, "ShowCrashDialog", &crash_dlg_value);
 394             RegSetValueExA(hkeyWinedbg, "ShowCrashDialog", 0, REG_DWORD, (BYTE *)&zero, sizeof(DWORD));
 395             crash_and_winedbg(hkey, test_exe);
 396             restore_value(hkeyWinedbg, &crash_dlg_value);
 397             RegCloseKey(hkeyWinedbg);
 398         }
 399         else
 400             ok(0, "Couldn't access WineDbg Key - error %u\n", ret);
 401     }
 402
 403     if (winetest_interactive)
 404         /* Since the debugging process never sets the debug event, it isn't recognized
 405            as a valid debugger and, after the debugger exits, Windows will show a dialog box
 406            asking the user what to do */
 407         crash_and_debug(hkey, test_exe, "dbg,none");
 408     else
 409         skip("\"none\" debugger test needs user interaction\n");
 410     crash_and_debug(hkey, test_exe, "dbg,event,order");
 411     crash_and_debug(hkey, test_exe, "dbg,attach,event,code2");
 412     if (pDebugSetProcessKillOnExit)
 413         crash_and_debug(hkey, test_exe, "dbg,attach,event,nokill");
 414     else
 415         win_skip("DebugSetProcessKillOnExit is not available\n");
 416     if (pDebugActiveProcessStop)
 417         crash_and_debug(hkey, test_exe, "dbg,attach,event,detach");
 418     else
 419         win_skip("DebugActiveProcessStop is not available\n");
 420
 421     if (disposition == REG_CREATED_NEW_KEY)
 422     {
 423         RegCloseKey(hkey);
 424         RegDeleteKeyA(HKEY_LOCAL_MACHINE, AeDebug);
 425     }
 426     else
 427     {
 428         restore_value(hkey, &auto_value);
 429         restore_value(hkey, &debugger_value);
 430         RegCloseKey(hkey);
 431     }
 432 }
 433
 434 START_TEST(debugger)
 435 {
 436     HMODULE hdll;
 437
 438     hdll=GetModuleHandle("kernel32.dll");
 439     pDebugActiveProcessStop=(void*)GetProcAddress(hdll, "DebugActiveProcessStop");
 440     pDebugSetProcessKillOnExit=(void*)GetProcAddress(hdll, "DebugSetProcessKillOnExit");
 441
 442     myARGC=winetest_get_mainargs(&myARGV);
 443     if (myARGC >= 3 && strcmp(myARGV[2], "crash") == 0)
 444     {
 445         doCrash(myARGC, myARGV);
 446     }
 447     else if (myARGC >= 3 && strncmp(myARGV[2], "dbg,", 4) == 0)
 448     {
 449         doDebugger(myARGC, myARGV);
 450     }
 451     else
 452     {
 453         test_ExitCode();
 454     }
 455 }