ReactOS 0.4.15-dev-8102-g108db8f
kddll.h File Reference
#include <ntifs.h>
#include <windbgkd.h>
Include dependency graph for kddll.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define NOEXTAPI
 
#define KDDBGPRINT(...)
 

Enumerations

enum  KDP_STATUS {
  KDP_PACKET_RECEIVED = 0 , KDP_PACKET_TIMEOUT = 1 , KDP_PACKET_RESEND = 2 , KDP_PACKET_RECEIVED = 0 ,
  KDP_PACKET_TIMEOUT = 1 , KDP_PACKET_RESEND = 2
}
 

Functions

VOID NTAPI KdpSendBuffer (IN PVOID Buffer, IN ULONG Size)
 
KDP_STATUS NTAPI KdpReceiveBuffer (OUT PVOID Buffer, IN ULONG Size)
 
KDP_STATUS NTAPI KdpReceivePacketLeader (OUT PULONG PacketLeader)
 
VOID NTAPI KdpSendByte (IN UCHAR Byte)
 
KDP_STATUS NTAPI KdpPollByte (OUT PUCHAR OutByte)
 
KDP_STATUS NTAPI KdpReceiveByte (OUT PUCHAR OutByte)
 
KDP_STATUS NTAPI KdpPollBreakIn (VOID)
 

Macro Definition Documentation

◆ KDDBGPRINT

#define KDDBGPRINT (   ...)

Definition at line 19 of file kddll.h.

◆ NOEXTAPI

#define NOEXTAPI

Definition at line 12 of file kddll.h.

Enumeration Type Documentation

◆ KDP_STATUS

Enumerator
KDP_PACKET_RECEIVED 
KDP_PACKET_TIMEOUT 
KDP_PACKET_RESEND 
KDP_PACKET_RECEIVED 
KDP_PACKET_TIMEOUT 
KDP_PACKET_RESEND 

Definition at line 25 of file kddll.h.

26{
KDP_STATUS
Definition: kddll.h:26
@ KDP_PACKET_TIMEOUT
Definition: kddll.h:28
@ KDP_PACKET_RESEND
Definition: kddll.h:29
@ KDP_PACKET_RECEIVED
Definition: kddll.h:27

Function Documentation

◆ KdpPollBreakIn()

KDP_STATUS NTAPI KdpPollBreakIn ( VOID  )

Definition at line 343 of file kdcom.c.

344{
345 KDP_STATUS KdStatus;
346 UCHAR Byte;
347
348 KdStatus = KdpPollByte(&Byte);
349 if ((KdStatus == KDP_PACKET_RECEIVED) && (Byte == BREAKIN_PACKET_BYTE))
350 {
351 return KDP_PACKET_RECEIVED;
352 }
353 return KDP_PACKET_TIMEOUT;
354}
unsigned char Byte
Definition: zlib.h:37
KDP_STATUS NTAPI KdpPollByte(OUT PUCHAR OutByte)
Definition: kdcom.c:299
#define BREAKIN_PACKET_BYTE
Definition: windbgkd.h:31
unsigned char UCHAR
Definition: xmlstorage.h:181

◆ KdpPollByte()

KDP_STATUS NTAPI KdpPollByte ( OUT PUCHAR  OutByte)

Definition at line 299 of file kdcom.c.

300{
302
303 /* Poll the byte */
304 Status = CpGetByte(&KdComPort, OutByte, FALSE, FALSE);
305 switch (Status)
306 {
307 case CP_GET_SUCCESS:
308 return KDP_PACKET_RECEIVED;
309
310 case CP_GET_NODATA:
311 return KDP_PACKET_TIMEOUT;
312
313 case CP_GET_ERROR:
314 default:
315 return KDP_PACKET_RESEND;
316 }
317}
#define CP_GET_SUCCESS
Definition: cportlib.h:18
USHORT NTAPI CpGetByte(IN PCPPORT Port, OUT PUCHAR Byte, IN BOOLEAN Wait, IN BOOLEAN Poll)
Definition: cport.c:253
#define CP_GET_NODATA
Definition: cportlib.h:19
#define CP_GET_ERROR
Definition: cportlib.h:20
#define FALSE
Definition: types.h:117
Status
Definition: gdiplustypes.h:25
CPPORT KdComPort
Definition: kdcom.c:52
unsigned short USHORT
Definition: pedump.c:61

◆ KdpReceiveBuffer()

KDP_STATUS NTAPI KdpReceiveBuffer ( OUT PVOID  Buffer,
IN ULONG  Size 
)

Definition at line 43 of file kdserial.c.

46{
47 PUCHAR ByteBuffer = Buffer;
48 UCHAR Byte;
50
51 while (Size-- > 0)
52 {
53 /* Try to get a byte from the port */
56 return Status;
57
58 *ByteBuffer++ = Byte;
59 }
60
62}
Definition: bufpool.h:45
KDP_STATUS NTAPI KdpReceiveByte(OUT PUCHAR OutByte)
Definition: kdcom.c:321
unsigned char * PUCHAR
Definition: typedefs.h:53
_Must_inspect_result_ _In_ WDFDEVICE _In_ PWDF_DEVICE_PROPERTY_DATA _In_ DEVPROPTYPE _In_ ULONG Size
Definition: wdfdevice.h:4533

Referenced by KdReceivePacket().

◆ KdpReceiveByte()

KDP_STATUS NTAPI KdpReceiveByte ( OUT PUCHAR  OutByte)

Definition at line 321 of file kdcom.c.

322{
324
325 /* Get the byte */
326 Status = CpGetByte(&KdComPort, OutByte, TRUE, FALSE);
327 switch (Status)
328 {
329 case CP_GET_SUCCESS:
330 return KDP_PACKET_RECEIVED;
331
332 case CP_GET_NODATA:
333 return KDP_PACKET_TIMEOUT;
334
335 case CP_GET_ERROR:
336 default:
337 return KDP_PACKET_RESEND;
338 }
339}
#define TRUE
Definition: types.h:120

Referenced by finish_gdb_packet(), gdb_receive_packet(), KdpReceiveBuffer(), and KdpReceivePacketLeader().

◆ KdpReceivePacketLeader()

KDP_STATUS NTAPI KdpReceivePacketLeader ( OUT PULONG  PacketLeader)

Definition at line 75 of file kdserial.c.

77{
78 UCHAR Index = 0, Byte, Buffer[4];
79 KDP_STATUS KdStatus;
80
81 /* Set first character to 0 */
82 Buffer[0] = 0;
83
84 do
85 {
86 /* Receive a single byte */
87 KdStatus = KdpReceiveByte(&Byte);
88
89 /* Check for timeout */
90 if (KdStatus == KDP_PACKET_TIMEOUT)
91 {
92 /* Check if we already got a breakin byte */
94 {
95 return KDP_PACKET_RESEND;
96 }
97
98 /* Report timeout */
99 return KDP_PACKET_TIMEOUT;
100 }
101
102 /* Check if we received a byte */
103 if (KdStatus == KDP_PACKET_RECEIVED)
104 {
105 /* Check if this is a valid packet leader byte */
106 if (Byte == PACKET_LEADER_BYTE ||
108 {
109 /* Check if we match the first byte */
110 if (Byte != Buffer[0])
111 {
112 /* No, this is the new byte 0! */
113 Index = 0;
114 }
115
116 /* Store the byte in the buffer */
117 Buffer[Index] = Byte;
118
119 /* Continue with next byte */
120 Index++;
121 continue;
122 }
123
124 /* Check for breakin byte */
126 {
127 KDDBGPRINT("BREAKIN_PACKET_BYTE\n");
128 Index = 0;
129 Buffer[0] = Byte;
130 continue;
131 }
132 }
133
134 /* Restart */
135 Index = 0;
136 Buffer[0] = 0;
137 }
138 while (Index < 4);
139
140 /* Enable the debugger */
142 SharedUserData->KdDebuggerEnabled |= 0x00000002;
143
144 /* Return the received packet leader */
145 *PacketLeader = *(PULONG)Buffer;
146
147 return KDP_PACKET_RECEIVED;
148}
#define KDDBGPRINT(...)
Definition: kddll.h:19
#define SharedUserData
uint32_t * PULONG
Definition: typedefs.h:59
_In_ WDFCOLLECTION _In_ ULONG Index
#define CONTROL_PACKET_LEADER_BYTE
Definition: windbgkd.h:35
#define PACKET_LEADER_BYTE
Definition: windbgkd.h:33
#define KD_DEBUGGER_NOT_PRESENT
Definition: kdfuncs.h:133

Referenced by KdReceivePacket().

◆ KdpSendBuffer()

VOID NTAPI KdpSendBuffer ( IN PVOID  Buffer,
IN ULONG  Size 
)

Definition at line 21 of file kdserial.c.

24{
25 PUCHAR ByteBuffer = Buffer;
26
27 while (Size-- > 0)
28 {
29 KdpSendByte(*ByteBuffer++);
30 }
31}
VOID NTAPI KdpSendByte(IN UCHAR Byte)
Definition: kdcom.c:291

Referenced by KdpSendControlPacket(), and KdSendPacket().

◆ KdpSendByte()

VOID NTAPI KdpSendByte ( IN UCHAR  Byte)

Definition at line 291 of file kdcom.c.

292{
293 /* Send the byte */
295}
VOID NTAPI CpPutByte(IN PCPPORT Port, IN UCHAR Byte)
Definition: cport.c:303

Referenced by finish_gdb_packet(), gdb_receive_packet(), KdpPollBreakIn(), KdpSendBuffer(), KdSendPacket(), send_gdb_partial_binary(), send_gdb_partial_packet(), and start_gdb_packet().