439 lines
13 KiB
C
439 lines
13 KiB
C
/*
|
|
* Win32 debugger functions
|
|
*
|
|
* Copyright (C) 1999 Alexandre Julliard
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
#include "winerror.h"
|
|
#include "wine/winbase16.h"
|
|
#include "wine/server.h"
|
|
#include "kernel_private.h"
|
|
#include "wine/debug.h"
|
|
|
|
WINE_DEFAULT_DEBUG_CHANNEL(debugstr);
|
|
|
|
|
|
/******************************************************************************
|
|
* WaitForDebugEvent (KERNEL32.@)
|
|
*
|
|
* Waits for a debugging event to occur in a process being debugged before
|
|
* filling out the debug event structure.
|
|
*
|
|
* PARAMS
|
|
* event [O] Address of structure for event information.
|
|
* timeout [I] Number of milliseconds to wait for event.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* Returns true if a debug event occurred and false if the call timed out.
|
|
*/
|
|
BOOL WINAPI WaitForDebugEvent(
|
|
LPDEBUG_EVENT event,
|
|
DWORD timeout)
|
|
{
|
|
BOOL ret;
|
|
DWORD i, res;
|
|
|
|
for (;;)
|
|
{
|
|
HANDLE wait = 0;
|
|
debug_event_t data;
|
|
SERVER_START_REQ( wait_debug_event )
|
|
{
|
|
req->get_handle = (timeout != 0);
|
|
wine_server_set_reply( req, &data, sizeof(data) );
|
|
if (!(ret = !wine_server_call_err( req ))) goto done;
|
|
|
|
if (!wine_server_reply_size(reply)) /* timeout */
|
|
{
|
|
wait = wine_server_ptr_handle( reply->wait );
|
|
ret = FALSE;
|
|
goto done;
|
|
}
|
|
event->dwDebugEventCode = data.code;
|
|
event->dwProcessId = (DWORD)reply->pid;
|
|
event->dwThreadId = (DWORD)reply->tid;
|
|
switch(data.code)
|
|
{
|
|
case EXCEPTION_DEBUG_EVENT:
|
|
event->u.Exception.dwFirstChance = data.exception.first;
|
|
event->u.Exception.ExceptionRecord.ExceptionCode = data.exception.exc_code;
|
|
event->u.Exception.ExceptionRecord.ExceptionFlags = data.exception.flags;
|
|
event->u.Exception.ExceptionRecord.ExceptionRecord = wine_server_get_ptr( data.exception.record );
|
|
event->u.Exception.ExceptionRecord.ExceptionAddress = wine_server_get_ptr( data.exception.address );
|
|
event->u.Exception.ExceptionRecord.NumberParameters = data.exception.nb_params;
|
|
for (i = 0; i < data.exception.nb_params; i++)
|
|
event->u.Exception.ExceptionRecord.ExceptionInformation[i] = data.exception.params[i];
|
|
break;
|
|
case CREATE_THREAD_DEBUG_EVENT:
|
|
event->u.CreateThread.hThread = wine_server_ptr_handle( data.create_thread.handle );
|
|
event->u.CreateThread.lpThreadLocalBase = wine_server_get_ptr( data.create_thread.teb );
|
|
event->u.CreateThread.lpStartAddress = wine_server_get_ptr( data.create_thread.start );
|
|
break;
|
|
case CREATE_PROCESS_DEBUG_EVENT:
|
|
event->u.CreateProcessInfo.hFile = wine_server_ptr_handle( data.create_process.file );
|
|
event->u.CreateProcessInfo.hProcess = wine_server_ptr_handle( data.create_process.process );
|
|
event->u.CreateProcessInfo.hThread = wine_server_ptr_handle( data.create_process.thread );
|
|
event->u.CreateProcessInfo.lpBaseOfImage = wine_server_get_ptr( data.create_process.base );
|
|
event->u.CreateProcessInfo.dwDebugInfoFileOffset = data.create_process.dbg_offset;
|
|
event->u.CreateProcessInfo.nDebugInfoSize = data.create_process.dbg_size;
|
|
event->u.CreateProcessInfo.lpThreadLocalBase = wine_server_get_ptr( data.create_process.teb );
|
|
event->u.CreateProcessInfo.lpStartAddress = wine_server_get_ptr( data.create_process.start );
|
|
event->u.CreateProcessInfo.lpImageName = wine_server_get_ptr( data.create_process.name );
|
|
event->u.CreateProcessInfo.fUnicode = data.create_process.unicode;
|
|
break;
|
|
case EXIT_THREAD_DEBUG_EVENT:
|
|
event->u.ExitThread.dwExitCode = data.exit.exit_code;
|
|
break;
|
|
case EXIT_PROCESS_DEBUG_EVENT:
|
|
event->u.ExitProcess.dwExitCode = data.exit.exit_code;
|
|
break;
|
|
case LOAD_DLL_DEBUG_EVENT:
|
|
event->u.LoadDll.hFile = wine_server_ptr_handle( data.load_dll.handle );
|
|
event->u.LoadDll.lpBaseOfDll = wine_server_get_ptr( data.load_dll.base );
|
|
event->u.LoadDll.dwDebugInfoFileOffset = data.load_dll.dbg_offset;
|
|
event->u.LoadDll.nDebugInfoSize = data.load_dll.dbg_size;
|
|
event->u.LoadDll.lpImageName = wine_server_get_ptr( data.load_dll.name );
|
|
event->u.LoadDll.fUnicode = data.load_dll.unicode;
|
|
break;
|
|
case UNLOAD_DLL_DEBUG_EVENT:
|
|
event->u.UnloadDll.lpBaseOfDll = wine_server_get_ptr( data.unload_dll.base );
|
|
break;
|
|
case OUTPUT_DEBUG_STRING_EVENT:
|
|
event->u.DebugString.lpDebugStringData = wine_server_get_ptr( data.output_string.string );
|
|
event->u.DebugString.fUnicode = data.output_string.unicode;
|
|
event->u.DebugString.nDebugStringLength = data.output_string.length;
|
|
break;
|
|
case RIP_EVENT:
|
|
event->u.RipInfo.dwError = data.rip_info.error;
|
|
event->u.RipInfo.dwType = data.rip_info.type;
|
|
break;
|
|
}
|
|
done:
|
|
/* nothing */ ;
|
|
}
|
|
SERVER_END_REQ;
|
|
if (ret) return TRUE;
|
|
if (!wait) break;
|
|
res = WaitForSingleObject( wait, timeout );
|
|
CloseHandle( wait );
|
|
if (res != STATUS_WAIT_0) break;
|
|
}
|
|
SetLastError( ERROR_SEM_TIMEOUT );
|
|
return FALSE;
|
|
}
|
|
|
|
|
|
/**********************************************************************
|
|
* ContinueDebugEvent (KERNEL32.@)
|
|
*
|
|
* Enables a thread that previously produced a debug event to continue.
|
|
*
|
|
* PARAMS
|
|
* pid [I] The id of the process to continue.
|
|
* tid [I] The id of the thread to continue.
|
|
* status [I] The rule to apply to unhandled exeptions.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* True if the debugger is listed as the processes owner and the process
|
|
* and thread are valid.
|
|
*/
|
|
BOOL WINAPI ContinueDebugEvent(
|
|
DWORD pid,
|
|
DWORD tid,
|
|
DWORD status)
|
|
{
|
|
BOOL ret;
|
|
SERVER_START_REQ( continue_debug_event )
|
|
{
|
|
req->pid = pid;
|
|
req->tid = tid;
|
|
req->status = status;
|
|
ret = !wine_server_call_err( req );
|
|
}
|
|
SERVER_END_REQ;
|
|
return ret;
|
|
}
|
|
|
|
|
|
/**********************************************************************
|
|
* DebugActiveProcess (KERNEL32.@)
|
|
*
|
|
* Attempts to attach the debugger to a process.
|
|
*
|
|
* PARAMS
|
|
* pid [I] The process to be debugged.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* True if the debugger was attached to process.
|
|
*/
|
|
BOOL WINAPI DebugActiveProcess( DWORD pid )
|
|
{
|
|
BOOL ret;
|
|
SERVER_START_REQ( debug_process )
|
|
{
|
|
req->pid = pid;
|
|
req->attach = 1;
|
|
ret = !wine_server_call_err( req );
|
|
}
|
|
SERVER_END_REQ;
|
|
return ret;
|
|
}
|
|
|
|
/**********************************************************************
|
|
* DebugActiveProcessStop (KERNEL32.@)
|
|
*
|
|
* Attempts to detach the debugger from a process.
|
|
*
|
|
* PARAMS
|
|
* pid [I] The process to be detached.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* True if the debugger was detached from the process.
|
|
*/
|
|
BOOL WINAPI DebugActiveProcessStop( DWORD pid )
|
|
{
|
|
BOOL ret;
|
|
SERVER_START_REQ( debug_process )
|
|
{
|
|
req->pid = pid;
|
|
req->attach = 0;
|
|
ret = !wine_server_call_err( req );
|
|
}
|
|
SERVER_END_REQ;
|
|
return ret;
|
|
}
|
|
|
|
|
|
/***********************************************************************
|
|
* OutputDebugStringA (KERNEL32.@)
|
|
*
|
|
* Output by an application of an ascii string to a debugger (if attached)
|
|
* and program log.
|
|
*
|
|
* PARAMS
|
|
* str [I] The message to be logged and given to the debugger.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* Nothing.
|
|
*/
|
|
void WINAPI OutputDebugStringA( LPCSTR str )
|
|
{
|
|
SERVER_START_REQ( output_debug_string )
|
|
{
|
|
req->string = wine_server_client_ptr( str );
|
|
req->unicode = 0;
|
|
req->length = strlen(str) + 1;
|
|
wine_server_call( req );
|
|
}
|
|
SERVER_END_REQ;
|
|
WARN("%s\n", str);
|
|
}
|
|
|
|
|
|
/***********************************************************************
|
|
* OutputDebugStringW (KERNEL32.@)
|
|
*
|
|
* Output by an application of a unicode string to a debugger (if attached)
|
|
* and program log.
|
|
*
|
|
* PARAMS
|
|
* str [I] The message to be logged and given to the debugger.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* Nothing.
|
|
*/
|
|
void WINAPI OutputDebugStringW( LPCWSTR str )
|
|
{
|
|
SERVER_START_REQ( output_debug_string )
|
|
{
|
|
req->string = wine_server_client_ptr( str );
|
|
req->unicode = 1;
|
|
req->length = (lstrlenW(str) + 1) * sizeof(WCHAR);
|
|
wine_server_call( req );
|
|
}
|
|
SERVER_END_REQ;
|
|
WARN("%s\n", debugstr_w(str));
|
|
}
|
|
|
|
|
|
/***********************************************************************
|
|
* OutputDebugString (KERNEL.115)
|
|
*
|
|
* Output by a 16 bit application of an ascii string to a debugger (if attached)
|
|
* and program log.
|
|
*
|
|
* PARAMS
|
|
* str [I] The message to be logged and given to the debugger.
|
|
*
|
|
* RETURNS
|
|
*/
|
|
void WINAPI OutputDebugString16( LPCSTR str )
|
|
{
|
|
OutputDebugStringA( str );
|
|
}
|
|
|
|
|
|
/***********************************************************************
|
|
* DebugBreak (KERNEL32.@)
|
|
*
|
|
* Raises an exception so that a debugger (if attached)
|
|
* can take some action.
|
|
*
|
|
* PARAMS
|
|
*
|
|
* RETURNS
|
|
*/
|
|
void WINAPI DebugBreak(void)
|
|
{
|
|
DbgBreakPoint();
|
|
}
|
|
|
|
/***********************************************************************
|
|
* DebugBreakProcess (KERNEL32.@)
|
|
*
|
|
* Raises an exception so that a debugger (if attached)
|
|
* can take some action. Same as DebugBreak, but applies to any process.
|
|
*
|
|
* PARAMS
|
|
* hProc [I] Process to break into.
|
|
*
|
|
* RETURNS
|
|
*
|
|
* True if successful.
|
|
*/
|
|
BOOL WINAPI DebugBreakProcess(HANDLE hProc)
|
|
{
|
|
BOOL ret, self;
|
|
|
|
TRACE("(%p)\n", hProc);
|
|
|
|
SERVER_START_REQ( debug_break )
|
|
{
|
|
req->handle = wine_server_obj_handle( hProc );
|
|
ret = !wine_server_call_err( req );
|
|
self = ret && reply->self;
|
|
}
|
|
SERVER_END_REQ;
|
|
if (self) DbgBreakPoint();
|
|
return ret;
|
|
}
|
|
|
|
|
|
/***********************************************************************
|
|
* DebugBreak (KERNEL.203)
|
|
*
|
|
* Raises an exception in a 16 bit application so that a debugger (if attached)
|
|
* can take some action.
|
|
*
|
|
* PARAMS
|
|
*
|
|
* RETURNS
|
|
*
|
|
* BUGS
|
|
*
|
|
* Only 386 compatible processors implemented.
|
|
*/
|
|
void WINAPI DebugBreak16(
|
|
CONTEXT86 *context) /* [in/out] A pointer to the 386 compatible processor state. */
|
|
{
|
|
#ifdef __i386__
|
|
EXCEPTION_RECORD rec;
|
|
|
|
rec.ExceptionCode = EXCEPTION_BREAKPOINT;
|
|
rec.ExceptionFlags = 0;
|
|
rec.ExceptionRecord = NULL;
|
|
rec.ExceptionAddress = (LPVOID)context->Eip;
|
|
rec.NumberParameters = 0;
|
|
NtRaiseException( &rec, context, TRUE );
|
|
#endif /* defined(__i386__) */
|
|
}
|
|
|
|
|
|
/***********************************************************************
|
|
* IsDebuggerPresent (KERNEL32.@)
|
|
*
|
|
* Allows a process to determine if there is a debugger attached.
|
|
*
|
|
* PARAMS
|
|
*
|
|
* RETURNS
|
|
*
|
|
* True if there is a debugger attached.
|
|
*/
|
|
BOOL WINAPI IsDebuggerPresent(void)
|
|
{
|
|
return NtCurrentTeb()->Peb->BeingDebugged;
|
|
}
|
|
|
|
/***********************************************************************
|
|
* CheckRemoteDebuggerPresent (KERNEL32.@)
|
|
*
|
|
* Allows a process to determine if there is a remote debugger
|
|
* attached.
|
|
*
|
|
* PARAMS
|
|
*
|
|
* RETURNS
|
|
*
|
|
* TRUE because it is a stub.
|
|
*/
|
|
BOOL WINAPI CheckRemoteDebuggerPresent(HANDLE process, PBOOL DebuggerPresent)
|
|
{
|
|
if(!process || !DebuggerPresent)
|
|
{
|
|
SetLastError(ERROR_INVALID_PARAMETER);
|
|
return FALSE;
|
|
}
|
|
FIXME("(%p)->(%p): Stub!\n", process, DebuggerPresent);
|
|
*DebuggerPresent = FALSE;
|
|
return TRUE;
|
|
}
|
|
|
|
/***********************************************************************
|
|
* DebugSetProcessKillOnExit (KERNEL32.@)
|
|
*
|
|
* Let a debugger decide whether a debuggee will be killed upon debugger
|
|
* termination.
|
|
*
|
|
* PARAMS
|
|
* kill [I] If set to true then kill the process on exit.
|
|
*
|
|
* RETURNS
|
|
* True if successful, false otherwise.
|
|
*/
|
|
BOOL WINAPI DebugSetProcessKillOnExit(BOOL kill)
|
|
{
|
|
BOOL ret = FALSE;
|
|
|
|
SERVER_START_REQ( set_debugger_kill_on_exit )
|
|
{
|
|
req->kill_on_exit = kill;
|
|
ret = !wine_server_call_err( req );
|
|
}
|
|
SERVER_END_REQ;
|
|
return ret;
|
|
}
|