2 * Unit tests for the debugger facility
4 * Copyright (c) 2007 Francois Gouget for CodeWeavers
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.
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.
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
26 #include "wine/test.h"
28 #ifndef STATUS_DEBUGGER_INACTIVE
29 #define STATUS_DEBUGGER_INACTIVE ((NTSTATUS) 0xC0000354)
35 static BOOL (WINAPI *pCheckRemoteDebuggerPresent)(HANDLE,PBOOL);
36 static BOOL (WINAPI *pDebugActiveProcessStop)(DWORD);
37 static BOOL (WINAPI *pDebugSetProcessKillOnExit)(BOOL);
39 /* Copied from the process test */
40 static void get_file_name(char* buf)
45 GetTempPathA(sizeof(path), path);
46 GetTempFileNameA(path, "wt", 0, buf);
49 typedef struct tag_reg_save_value
57 static DWORD save_value(HKEY hkey, const char *value, reg_save_value *saved)
63 ret=RegQueryValueExA(hkey, value, NULL, &saved->type, NULL, &saved->size);
64 if (ret == ERROR_SUCCESS)
66 saved->data=HeapAlloc(GetProcessHeap(), 0, saved->size);
67 RegQueryValueExA(hkey, value, NULL, &saved->type, saved->data, &saved->size);
72 static void restore_value(HKEY hkey, reg_save_value *saved)
76 RegSetValueExA(hkey, saved->name, 0, saved->type, saved->data, saved->size);
77 HeapFree(GetProcessHeap(), 0, saved->data);
80 RegDeleteValueA(hkey, saved->name);
83 static void get_events(const char* name, HANDLE *start_event, HANDLE *done_event)
88 basename=strrchr(name, '\\');
89 basename=(basename ? basename+1 : name);
90 event_name=HeapAlloc(GetProcessHeap(), 0, 6+strlen(basename)+1);
92 sprintf(event_name, "start_%s", basename);
93 *start_event=CreateEvent(NULL, 0,0, event_name);
94 sprintf(event_name, "done_%s", basename);
95 *done_event=CreateEvent(NULL, 0,0, event_name);
96 HeapFree(GetProcessHeap(), 0, event_name);
99 static void save_blackbox(const char* logfile, void* blackbox, int size)
104 hFile=CreateFileA(logfile, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, 0, 0);
105 if (hFile == INVALID_HANDLE_VALUE)
107 WriteFile(hFile, blackbox, size, &written, NULL);
111 static int load_blackbox(const char* logfile, void* blackbox, int size)
117 hFile=CreateFileA(logfile, GENERIC_READ, 0, NULL, OPEN_EXISTING, 0, 0);
118 if (hFile == INVALID_HANDLE_VALUE)
120 ok(0, "unable to open '%s'\n", logfile);
123 ret=ReadFile(hFile, blackbox, size, &read, NULL);
124 ok(read == size, "wrong size for '%s': read=%d\n", logfile, read);
134 static void doCrash(int argc, char** argv)
140 crash_blackbox_t blackbox;
141 blackbox.pid=GetCurrentProcessId();
142 save_blackbox(argv[3], &blackbox, sizeof(blackbox));
146 trace("child: crashing...\n");
163 } debugger_blackbox_t;
165 static void doDebugger(int argc, char** argv)
168 debugger_blackbox_t blackbox;
169 HANDLE start_event = 0, done_event = 0, debug_event;
172 logfile=(argc >= 4 ? argv[3] : NULL);
173 blackbox.pid=(argc >= 5 ? atol(argv[4]) : 0);
175 blackbox.attach_err=0;
176 if (strstr(myARGV[2], "attach"))
178 blackbox.attach_rc=DebugActiveProcess(blackbox.pid);
179 if (!blackbox.attach_rc)
180 blackbox.attach_err=GetLastError();
183 blackbox.attach_rc=TRUE;
185 debug_event=(argc >= 6 ? (HANDLE)(INT_PTR)atol(argv[5]) : NULL);
186 blackbox.debug_err=0;
187 if (debug_event && strstr(myARGV[2], "event"))
189 blackbox.debug_rc=SetEvent(debug_event);
190 if (!blackbox.debug_rc)
191 blackbox.debug_err=GetLastError();
194 blackbox.debug_rc=TRUE;
198 get_events(logfile, &start_event, &done_event);
201 if (strstr(myARGV[2], "order"))
203 trace("debugger: waiting for the start signal...\n");
204 WaitForSingleObject(start_event, INFINITE);
207 blackbox.nokill_err=0;
208 if (strstr(myARGV[2], "nokill"))
210 blackbox.nokill_rc=pDebugSetProcessKillOnExit(FALSE);
211 if (!blackbox.nokill_rc)
212 blackbox.nokill_err=GetLastError();
215 blackbox.nokill_rc=TRUE;
217 blackbox.detach_err=0;
218 if (strstr(myARGV[2], "detach"))
220 blackbox.detach_rc=pDebugActiveProcessStop(blackbox.pid);
221 if (!blackbox.detach_rc)
222 blackbox.detach_err=GetLastError();
225 blackbox.detach_rc=TRUE;
229 save_blackbox(logfile, &blackbox, sizeof(blackbox));
231 trace("debugger: done debugging...\n");
232 SetEvent(done_event);
234 /* Just exit with a known value */
235 ExitProcess(0xdeadbeef);
238 static void crash_and_debug(HKEY hkey, const char* argv0, const char* dbgtasks)
241 HANDLE start_event, done_event;
243 char dbglog[MAX_PATH];
244 char childlog[MAX_PATH];
245 PROCESS_INFORMATION info;
246 STARTUPINFOA startup;
248 crash_blackbox_t crash_blackbox;
249 debugger_blackbox_t dbg_blackbox;
251 ret=RegSetValueExA(hkey, "auto", 0, REG_SZ, (BYTE*)"1", 2);
252 ok(ret == ERROR_SUCCESS, "unable to set AeDebug/auto: ret=%d\n", ret);
254 get_file_name(dbglog);
255 get_events(dbglog, &start_event, &done_event);
256 cmd=HeapAlloc(GetProcessHeap(), 0, strlen(argv0)+10+strlen(dbgtasks)+1+strlen(dbglog)+34+1);
257 sprintf(cmd, "%s debugger %s %s %%ld %%ld", argv0, dbgtasks, dbglog);
258 ret=RegSetValueExA(hkey, "debugger", 0, REG_SZ, (BYTE*)cmd, strlen(cmd)+1);
259 ok(ret == ERROR_SUCCESS, "unable to set AeDebug/debugger: ret=%d\n", ret);
260 HeapFree(GetProcessHeap(), 0, cmd);
262 get_file_name(childlog);
263 cmd=HeapAlloc(GetProcessHeap(), 0, strlen(argv0)+16+strlen(dbglog)+1);
264 sprintf(cmd, "%s debugger crash %s", argv0, childlog);
266 memset(&startup, 0, sizeof(startup));
267 startup.cb = sizeof(startup);
268 startup.dwFlags = STARTF_USESHOWWINDOW;
269 startup.wShowWindow = SW_SHOWNORMAL;
270 ret=CreateProcessA(NULL, cmd, NULL, NULL, FALSE, 0, NULL, NULL, &startup, &info);
271 ok(ret, "CreateProcess: err=%d\n", GetLastError());
272 HeapFree(GetProcessHeap(), 0, cmd);
273 CloseHandle(info.hThread);
275 /* The process exits... */
276 trace("waiting for child exit...\n");
277 ok(WaitForSingleObject(info.hProcess, 60000) == WAIT_OBJECT_0, "Timed out waiting for the child to crash\n");
278 ok(GetExitCodeProcess(info.hProcess, &exit_code), "GetExitCodeProcess failed: err=%d\n", GetLastError());
279 if (strstr(dbgtasks, "code2"))
281 /* If, after attaching to the debuggee, the debugger exits without
282 * detaching, then the debuggee gets a special exit code.
284 ok(exit_code == STATUS_DEBUGGER_INACTIVE ||
285 broken(exit_code == 0xffffffff) || /* Win9x */
286 broken(exit_code == WAIT_ABANDONED), /* NT4, W2K */
287 "wrong exit code : %08x\n", exit_code);
290 ok(exit_code == STATUS_ACCESS_VIOLATION ||
291 broken(exit_code == WAIT_ABANDONED) || /* NT4, W2K, W2K3 */
292 broken(exit_code == 0xffffffff), /* Win9x, WinME */
293 "wrong exit code : %08x\n", exit_code);
294 CloseHandle(info.hProcess);
296 /* ...before the debugger */
297 if (strstr(dbgtasks, "order"))
298 ok(SetEvent(start_event), "SetEvent(start_event) failed\n");
300 trace("waiting for the debugger...\n");
301 ok(WaitForSingleObject(done_event, 60000) == WAIT_OBJECT_0, "Timed out waiting for the debugger\n");
303 assert(load_blackbox(childlog, &crash_blackbox, sizeof(crash_blackbox)));
304 assert(load_blackbox(dbglog, &dbg_blackbox, sizeof(dbg_blackbox)));
306 ok(dbg_blackbox.argc == 6, "wrong debugger argument count: %d\n", dbg_blackbox.argc);
307 ok(dbg_blackbox.pid == crash_blackbox.pid, "the child and debugged pids don't match: %d != %d\n", crash_blackbox.pid, dbg_blackbox.pid);
308 ok(dbg_blackbox.debug_rc, "debugger: SetEvent(debug_event) failed err=%d\n", dbg_blackbox.debug_err);
309 ok(dbg_blackbox.attach_rc, "DebugActiveProcess(%d) failed err=%d\n", dbg_blackbox.pid, dbg_blackbox.attach_err);
310 ok(dbg_blackbox.nokill_rc, "DebugSetProcessKillOnExit(FALSE) failed err=%d\n", dbg_blackbox.nokill_err);
311 ok(dbg_blackbox.detach_rc, "DebugActiveProcessStop(%d) failed err=%d\n", dbg_blackbox.pid, dbg_blackbox.detach_err);
313 assert(DeleteFileA(dbglog) != 0);
314 assert(DeleteFileA(childlog) != 0);
317 static void crash_and_winedbg(HKEY hkey, const char* argv0)
321 PROCESS_INFORMATION info;
322 STARTUPINFOA startup;
325 ret=RegSetValueExA(hkey, "auto", 0, REG_SZ, (BYTE*)"1", 2);
326 ok(ret == ERROR_SUCCESS, "unable to set AeDebug/auto: ret=%d\n", ret);
328 cmd=HeapAlloc(GetProcessHeap(), 0, strlen(argv0)+15+1);
329 sprintf(cmd, "%s debugger crash", argv0);
331 memset(&startup, 0, sizeof(startup));
332 startup.cb = sizeof(startup);
333 startup.dwFlags = STARTF_USESHOWWINDOW;
334 startup.wShowWindow = SW_SHOWNORMAL;
335 ret=CreateProcessA(NULL, cmd, NULL, NULL, FALSE, 0, NULL, NULL, &startup, &info);
336 ok(ret, "CreateProcess: err=%d\n", GetLastError());
337 HeapFree(GetProcessHeap(), 0, cmd);
338 CloseHandle(info.hThread);
340 trace("waiting for child exit...\n");
341 ok(WaitForSingleObject(info.hProcess, 60000) == WAIT_OBJECT_0, "Timed out waiting for the child to crash\n");
342 ok(GetExitCodeProcess(info.hProcess, &exit_code), "GetExitCodeProcess failed: err=%d\n", GetLastError());
343 ok(exit_code == STATUS_ACCESS_VIOLATION, "exit code = %08x\n", exit_code);
344 CloseHandle(info.hProcess);
347 static void test_ExitCode(void)
349 static const char* AeDebug="Software\\Microsoft\\Windows NT\\CurrentVersion\\AeDebug";
350 static const char* WineDbg="Software\\Wine\\WineDbg";
351 char test_exe[MAX_PATH];
355 reg_save_value auto_value;
356 reg_save_value debugger_value;
358 GetModuleFileNameA(GetModuleHandle(NULL), test_exe, sizeof(test_exe));
359 if (GetFileAttributes(test_exe) == INVALID_FILE_ATTRIBUTES)
360 strcat(test_exe, ".so");
361 if (GetFileAttributesA(test_exe) == INVALID_FILE_ATTRIBUTES)
363 ok(0, "could not find the test executable '%s'\n", test_exe);
367 ret=RegCreateKeyExA(HKEY_LOCAL_MACHINE, AeDebug, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hkey, &disposition);
368 if (ret == ERROR_SUCCESS)
370 save_value(hkey, "auto", &auto_value);
371 save_value(hkey, "debugger", &debugger_value);
372 trace("HKLM\\%s\\debugger is set to '%s'\n", AeDebug, debugger_value.data);
374 else if (ret == ERROR_ACCESS_DENIED)
376 skip("not enough privileges to change the debugger\n");
379 else if (ret != ERROR_FILE_NOT_FOUND)
381 ok(0, "could not open the AeDebug key: %d\n", ret);
385 if (debugger_value.data && debugger_value.type == REG_SZ &&
386 strstr((char*)debugger_value.data, "winedbg --auto"))
389 ret=RegCreateKeyA(HKEY_CURRENT_USER, WineDbg, &hkeyWinedbg);
390 if (ret == ERROR_SUCCESS)
393 reg_save_value crash_dlg_value;
394 save_value(hkeyWinedbg, "ShowCrashDialog", &crash_dlg_value);
395 RegSetValueExA(hkeyWinedbg, "ShowCrashDialog", 0, REG_DWORD, (BYTE *)&zero, sizeof(DWORD));
396 crash_and_winedbg(hkey, test_exe);
397 restore_value(hkeyWinedbg, &crash_dlg_value);
398 RegCloseKey(hkeyWinedbg);
401 ok(0, "Couldn't access WineDbg Key - error %u\n", ret);
404 if (winetest_interactive)
405 /* Since the debugging process never sets the debug event, it isn't recognized
406 as a valid debugger and, after the debugger exits, Windows will show a dialog box
407 asking the user what to do */
408 crash_and_debug(hkey, test_exe, "dbg,none");
410 skip("\"none\" debugger test needs user interaction\n");
411 crash_and_debug(hkey, test_exe, "dbg,event,order");
412 crash_and_debug(hkey, test_exe, "dbg,attach,event,code2");
413 if (pDebugSetProcessKillOnExit)
414 crash_and_debug(hkey, test_exe, "dbg,attach,event,nokill");
416 win_skip("DebugSetProcessKillOnExit is not available\n");
417 if (pDebugActiveProcessStop)
418 crash_and_debug(hkey, test_exe, "dbg,attach,event,detach");
420 win_skip("DebugActiveProcessStop is not available\n");
422 if (disposition == REG_CREATED_NEW_KEY)
425 RegDeleteKeyA(HKEY_LOCAL_MACHINE, AeDebug);
429 restore_value(hkey, &auto_value);
430 restore_value(hkey, &debugger_value);
435 static void test_RemoteDebugger(void)
438 if(!pCheckRemoteDebuggerPresent)
440 win_skip("CheckRemoteDebuggerPresent is not available\n");
444 SetLastError(0xdeadbeef);
445 bret = pCheckRemoteDebuggerPresent(GetCurrentProcess(),&present);
446 ok(bret , "expected CheckRemoteDebuggerPresent to succeed\n");
447 ok(0xdeadbeef == GetLastError(),
448 "expected error to be unchanged, got %d/%x\n",GetLastError(), GetLastError());
451 SetLastError(0xdeadbeef);
452 bret = pCheckRemoteDebuggerPresent(NULL,&present);
453 ok(!bret , "expected CheckRemoteDebuggerPresent to fail\n");
454 ok(present, "expected parameter to be unchanged\n");
455 ok(ERROR_INVALID_PARAMETER == GetLastError(),
456 "expected error ERROR_INVALID_PARAMETER, got %d/%x\n",GetLastError(), GetLastError());
458 SetLastError(0xdeadbeef);
459 bret = pCheckRemoteDebuggerPresent(GetCurrentProcess(),NULL);
460 ok(!bret , "expected CheckRemoteDebuggerPresent to fail\n");
461 ok(ERROR_INVALID_PARAMETER == GetLastError(),
462 "expected error ERROR_INVALID_PARAMETER, got %d/%x\n",GetLastError(), GetLastError());
469 hdll=GetModuleHandle("kernel32.dll");
470 pCheckRemoteDebuggerPresent=(void*)GetProcAddress(hdll, "CheckRemoteDebuggerPresent");
471 pDebugActiveProcessStop=(void*)GetProcAddress(hdll, "DebugActiveProcessStop");
472 pDebugSetProcessKillOnExit=(void*)GetProcAddress(hdll, "DebugSetProcessKillOnExit");
474 myARGC=winetest_get_mainargs(&myARGV);
475 if (myARGC >= 3 && strcmp(myARGV[2], "crash") == 0)
477 doCrash(myARGC, myARGV);
479 else if (myARGC >= 3 && strncmp(myARGV[2], "dbg,", 4) == 0)
481 doDebugger(myARGC, myARGV);
486 test_RemoteDebugger();