kdprompt.c File Reference

#include <ntoskrnl.h>
#include "kd.h"
#include "kdterminal.h"

Include dependency graph for kdprompt.c:

Go to the source code of this file.

Functions
PCSTR	KdbGetHistoryEntry (_Inout_ PLONG NextIndex, _In_ BOOLEAN Next)
SIZE_T	KdIoReadLine (_Out_ PCHAR Buffer, _In_ SIZE_T Size)
	Reads a line of user input from the terminal.

Function Documentation

KdbGetHistoryEntry()

PCSTR KdbGetHistoryEntry	(	_Inout_ PLONG	NextIndex,
		_In_ BOOLEAN	Next
	)

Definition at line 24 of file kdprompt.c.

{
    /* Dummy function */
    return NULL;
}

Referenced by KdIoReadLine().

KdIoReadLine()

SIZE_T KdIoReadLine	(	_Out_ PCHAR	Buffer,
		_In_ SIZE_T	Size
	)

Reads a line of user input from the terminal.

Parameters

[out]	Buffer	Buffer where to store the input. Trailing newlines are removed.
[in]	Size	Size of Buffer.

Returns

Returns the number of characters stored, not counting the NULL terminator.

Note

Accepts only
newlines, \r is ignored.

Definition at line 51 of file kdprompt.c.

{
    PCHAR Orig = Buffer;
    ULONG ScanCode = 0;
    CHAR Key;
    BOOLEAN EchoOn = !(KdbDebugState & KD_DEBUG_KDNOECHO);
    LONG CmdHistIndex = -1; // Start at end of history.
 
    /* Flush the input buffer */
    KdpFlushTerminalInput();
 
    /* Bail out if the buffer is zero-sized */
    if (Size == 0)
        return 0;
 
    for (;;)
    {
        Key = KdpReadTermKey(&ScanCode);
 
        /* Check for return or newline */
        if ((Key == '\r') || (Key == '\n'))
        {
            *Buffer = ANSI_NULL;
            KdIoPuts("\n");
            return (SIZE_T)(Buffer - Orig);
        }
        else if (Key == KEY_BS || Key == KEY_DEL)
        {
            /* Erase the last character */
            if (Buffer > Orig)
            {
                Buffer--;
                *Buffer = ANSI_NULL;
 
                if (EchoOn)
                    KdIoPrintf("%c %c", KEY_BS, KEY_BS);
                else
                    KdIoPrintf(" %c", KEY_BS);
            }
        }
        else if (ScanCode == KEY_SCAN_UP || ScanCode == KEY_SCAN_DOWN)
        {
            PCSTR CmdHistory = KdbGetHistoryEntry(&CmdHistIndex,
                                                  (ScanCode == KEY_SCAN_DOWN));
            if (CmdHistory)
            {
                SIZE_T i;
 
                /* Erase the whole line */
                while (Buffer > Orig)
                {
                    Buffer--;
                    *Buffer = ANSI_NULL;
 
                    if (EchoOn)
                        KdIoPrintf("%c %c", KEY_BS, KEY_BS);
                    else
                        KdIoPrintf(" %c", KEY_BS);
                }
 
                /* Copy and display the history entry */
                i = min(strlen(CmdHistory), Size - 1);
                memcpy(Orig, CmdHistory, i);
                Orig[i] = ANSI_NULL;
                Buffer = Orig + i;
                KdIoPuts(Orig);
            }
        }
        else
        {
            /* Do not accept characters anymore if the buffer is full */
            if ((SIZE_T)(Buffer - Orig) >= (Size - 1))
                continue;
 
            if (EchoOn)
                KdIoPrintf("%c", Key);
 
            *Buffer = Key;
            Buffer++;
        }
    }
}

Referenced by KdReceivePacket().