gdb_send.c File Reference

#include "kdgdb.h"

Include dependency graph for gdb_send.c:

Go to the source code of this file.

Functions
static char *	exception_code_to_gdb (NTSTATUS code, char *out)
void	start_gdb_packet (void)
void	send_gdb_partial_packet (_In_ const CHAR *Buffer)
KDSTATUS	finish_gdb_packet (void)
KDSTATUS	send_gdb_packet (_In_ const CHAR *Buffer)
ULONG	send_gdb_partial_binary (_In_ const VOID *Buffer, _In_ size_t Length)
void	send_gdb_partial_memory (_In_ const VOID *Buffer, _In_ size_t Length)
KDSTATUS	send_gdb_memory (_In_ const VOID *Buffer, _In_ size_t Length)
KDSTATUS	gdb_send_debug_io (_In_ PSTRING String, _In_ BOOLEAN WithPrefix)
KDSTATUS	gdb_send_exception ()
void	send_gdb_ntstatus (_In_ NTSTATUS Status)

Variables
const char	hex_chars [] = "0123456789abcdef"
static CHAR	currentChecksum = 0

Function Documentation

exception_code_to_gdb()

static char * exception_code_to_gdb ( NTSTATUS  code, char *  out  )

static

Definition at line 17 of file gdb_send.c.

{
    unsigned char SigVal;
 
    switch (code)
    {
    case STATUS_INTEGER_DIVIDE_BY_ZERO:
        SigVal = 8; /* divide by zero */
        break;
    case STATUS_SINGLE_STEP:
    case STATUS_BREAKPOINT:
        SigVal = 5; /* breakpoint */
        break;
    case STATUS_INTEGER_OVERFLOW:
    case STATUS_ARRAY_BOUNDS_EXCEEDED:
        SigVal = 16; /* bound instruction */
        break;
    case STATUS_ILLEGAL_INSTRUCTION:
        SigVal = 4; /* Invalid opcode */
        break;
    case STATUS_STACK_OVERFLOW:
    case STATUS_DATATYPE_MISALIGNMENT:
    case STATUS_ACCESS_VIOLATION:
        SigVal = 11; /* access violation */
        break;
    default:
        SigVal = 7; /* "software generated" */
    }
    *out++ = hex_chars[(SigVal >> 4) & 0xf];
    *out++ = hex_chars[SigVal & 0xf];
    return out;
}

Referenced by gdb_send_exception(), and send_gdb_ntstatus().

finish_gdb_packet()

KDSTATUS finish_gdb_packet

(

void

)

Definition at line 74 of file gdb_send.c.

{
    UCHAR ack;
    KDSTATUS Status;
 
    /* Send finish byte and append checksum */
    KdpSendByte('#');
    KdpSendByte(hex_chars[(currentChecksum >> 4) & 0xf]);
    KdpSendByte(hex_chars[currentChecksum & 0xf]);
 
    /* Wait for acknowledgement */
    Status = KdpReceiveByte(&ack);
 
    if (Status != KdPacketReceived)
    {
        KD_DEBUGGER_NOT_PRESENT = TRUE;
        return Status;
    }
 
    if (ack != '+')
        return KdPacketNeedsResend;
 
    return KdPacketReceived;
}

Referenced by gdb_send_debug_io(), gdb_send_register(), gdb_send_registers(), handle_gdb_query(), send_gdb_memory(), and send_gdb_packet().

gdb_send_debug_io()

KDSTATUS gdb_send_debug_io	(	_In_ PSTRING	String,
		_In_ BOOLEAN	WithPrefix
	)

Definition at line 168 of file gdb_send.c.

{
    CHAR gdb_out[3];
    CHAR* ptr = String->Buffer;
    USHORT Length = String->Length;
 
    gdb_out[2] = '\0';
 
    start_gdb_packet();
 
    if (WithPrefix)
    {
        send_gdb_partial_packet("O");
    }
 
    /* Send the data */
    while (Length--)
    {
        gdb_out[0] = hex_chars[(*ptr >> 4) & 0xf];
        gdb_out[1] = hex_chars[*ptr++ & 0xf];
        send_gdb_partial_packet(gdb_out);
    }
 
    return finish_gdb_packet();
}

Referenced by handle_gdb_query(), and send_kd_debug_io().

gdb_send_exception()

KDSTATUS gdb_send_exception

(

void

)

Definition at line 197 of file gdb_send.c.

{
    char gdb_out[1024];
    char* ptr = gdb_out;
    PETHREAD Thread = (PETHREAD)(ULONG_PTR)CurrentStateChange.Thread;
 
    /* Report to GDB */
    *ptr++ = 'T';
 
    if (CurrentStateChange.NewState == DbgKdExceptionStateChange)
    {
        EXCEPTION_RECORD64* ExceptionRecord = &CurrentStateChange.u.Exception.ExceptionRecord;
        ptr = exception_code_to_gdb(ExceptionRecord->ExceptionCode, ptr);
    }
    else
        ptr += sprintf(ptr, "05");
 
    if (CurrentStateChange.NewState == DbgKdLoadSymbolsStateChange)
        ptr += sprintf(ptr, "library:");
 
#if MONOPROCESS
    ptr += sprintf(ptr, "thread:%" PRIxPTR ";",
        handle_to_gdb_tid(PsGetThreadId(Thread)));
#else
    ptr += sprintf(ptr, "thread:p%" PRIxPTR ".%" PRIxPTR ";",
        handle_to_gdb_pid(PsGetThreadProcessId(Thread)),
        handle_to_gdb_tid(PsGetThreadId(Thread)));
#endif
 
    ptr += sprintf(ptr, "core:%x;", CurrentStateChange.Processor);
    return send_gdb_packet(gdb_out);
}

Referenced by gdb_receive_and_interpret_packet(), and send_kd_state_change().

send_gdb_memory()

KDSTATUS send_gdb_memory	(	_In_ const VOID *	Buffer,
		_In_ size_t	Length
	)

Definition at line 158 of file gdb_send.c.

{
    start_gdb_packet();
    send_gdb_partial_memory(Buffer, Length);
    return finish_gdb_packet();
}

Referenced by gdb_send_register(), handle_gdb_query(), and ReadMemorySendHandler().

send_gdb_ntstatus()

void send_gdb_ntstatus

(

_In_ NTSTATUS

Status

)

Definition at line 231 of file gdb_send.c.

{
    /* Just build a EXX packet and send it */
    char gdb_out[4];
    gdb_out[0] = 'E';
    exception_code_to_gdb(Status, &gdb_out[1]);
    gdb_out[3] = '\0';
    send_gdb_packet(gdb_out);
}

Referenced by ReadMemorySendHandler(), WriteBreakPointSendHandler(), and WriteMemorySendHandler().

send_gdb_packet()

KDSTATUS send_gdb_packet

(

_In_ const CHAR *

Buffer

)

Definition at line 100 of file gdb_send.c.

{
    start_gdb_packet();
    send_gdb_partial_packet(Buffer);
    return finish_gdb_packet();
}

Referenced by gdb_receive_and_interpret_packet(), gdb_send_exception(), gdb_send_register(), handle_gdb_c(), handle_gdb_insert_breakpoint(), handle_gdb_query(), handle_gdb_read_mem(), handle_gdb_remove_breakpoint(), handle_gdb_set_thread(), handle_gdb_thread_alive(), handle_gdb_v(), handle_gdb_write_mem(), RestoreBreakPointSendHandler(), send_gdb_ntstatus(), WriteBreakPointSendHandler(), and WriteMemorySendHandler().

send_gdb_partial_binary()

ULONG send_gdb_partial_binary	(	_In_ const VOID *	Buffer,
		_In_ size_t	Length
	)

Definition at line 108 of file gdb_send.c.

{
    const UCHAR* ptr = Buffer;
    ULONG Sent = Length;
 
    while(Length--)
    {
        UCHAR Byte = *ptr++;
 
        switch (Byte)
        {
            case 0x7d:
            case 0x23:
            case 0x24:
            case 0x2a:
                currentChecksum += 0x7d;
                KdpSendByte(0x7d);
                Byte ^= 0x20;
                Sent++;
            /* Fall-through */
            default:
                currentChecksum += Byte;
                KdpSendByte(Byte);
        }
    }
 
    return Sent;
}

Referenced by handle_gdb_query().

send_gdb_partial_memory()

void send_gdb_partial_memory	(	_In_ const VOID *	Buffer,
		_In_ size_t	Length
	)

Definition at line 140 of file gdb_send.c.

{
    const UCHAR* ptr = Buffer;
    CHAR gdb_out[3];
 
    gdb_out[2] = '\0';
 
    while(Length--)
    {
        gdb_out[0] = hex_chars[(*ptr >> 4) & 0xf];
        gdb_out[1] = hex_chars[*ptr++ & 0xf];
        send_gdb_partial_packet(gdb_out);
    }
}

Referenced by send_gdb_memory().

send_gdb_partial_packet()

void send_gdb_partial_packet

(

_In_ const CHAR *

Buffer

)

Definition at line 60 of file gdb_send.c.

{
    const CHAR* ptr = Buffer;
 
    /* Update check sum and send */
    while (*ptr)
    {
        currentChecksum += *ptr;
        KdpSendByte(*ptr++);
    }
}

Referenced by gdb_send_debug_io(), gdb_send_register(), gdb_send_registers(), handle_gdb_query(), send_gdb_packet(), and send_gdb_partial_memory().

start_gdb_packet()

void start_gdb_packet

(

void

)

Definition at line 52 of file gdb_send.c.

{
    /* Start the start byte and begin checksum calculation */
    KdpSendByte('$');
    currentChecksum = 0;
}

Referenced by gdb_send_debug_io(), gdb_send_register(), gdb_send_registers(), handle_gdb_query(), send_gdb_memory(), and send_gdb_packet().

Variable Documentation

currentChecksum

CHAR currentChecksum = 0

static

Definition at line 12 of file gdb_send.c.

Referenced by finish_gdb_packet(), send_gdb_partial_binary(), send_gdb_partial_packet(), and start_gdb_packet().

hex_chars

const char hex_chars[] = "0123456789abcdef"

Definition at line 11 of file gdb_send.c.

Referenced by exception_code_to_gdb(), finish_gdb_packet(), gdb_send_debug_io(), gdb_send_registers(), and send_gdb_partial_memory().