script-engine.cpp File Reference

Interpret script engine affairs. More...

#include "pch.h"

Functions
UINT64	ScriptEngineEvalSingleExpression (string Expr, PBOOLEAN HasError)
	Get the value from the evaluation of single expression from local debuggee and remote debuggee.

Variables
UINT64	g_ResultOfEvaluatedExpression
	Result of the expression that is evaluated in the debuggee.
UINT32	g_ErrorStateOfResultOfEvaluatedExpression
	Shows the state of the evaluation of expression which whether contains error or not.
BOOLEAN	g_IsSerialConnectedToRemoteDebuggee
	Shows if the debugger was connected to remote debuggee over (A remote guest)

Detailed Description

Interpret script engine affairs.

Author

Sina Karvandi (sina@.nosp@m.hype.nosp@m.rdbg..nosp@m.org)

Version

0.1

Date

2021-09-23

Copyright

This project is released under the GNU Public License v3.

Function Documentation

ScriptEngineEvalSingleExpression()

UINT64 ScriptEngineEvalSingleExpression	(	string	Expr,
		PBOOLEAN	HasError )

Get the value from the evaluation of single expression from local debuggee and remote debuggee.

Parameters

Expr
HasError

Returns

UINT64

{
    PVOID  CodeBuffer;
    UINT64 BufferAddress;
    UINT32 BufferLength;
    UINT32 Pointer;
    UINT64 Result = NULL;
 
    //
    // Prepend and append 'formats(' and ')'
    //
    Expr.insert(0, "formats(");
    Expr.append(");");
 
    //
    // Run script engine handler
    //
    CodeBuffer = ScriptEngineParseWrapper((char *)Expr.c_str(), FALSE);
 
    if (CodeBuffer == NULL)
    {
        //
        // return to show that this item contains an script
        //
        *HasError = TRUE;
        return NULL;
    }
 
    //
    // Print symbols (test)
    //
    // PrintSymbolBufferWrapper(CodeBuffer);
 
    //
    // Set the buffer and length
    //
    BufferAddress = ScriptEngineWrapperGetHead(CodeBuffer);
    BufferLength  = ScriptEngineWrapperGetSize(CodeBuffer);
    Pointer       = ScriptEngineWrapperGetPointer(CodeBuffer);
 
    //
    // Check if it's connected over remote debuggee (in the Debugger Mode)
    //
    if (g_IsSerialConnectedToRemoteDebuggee)
    {
        //
        // Send over serial
        //
 
        //
        // Send it to the remote debuggee
        //
        KdSendScriptPacketToDebuggee(BufferAddress, BufferLength, Pointer, TRUE);
 
        //
        // Check whether there was an error in evaluation or not
        //
        if (g_ErrorStateOfResultOfEvaluatedExpression == DEBUGGER_OPERATION_WAS_SUCCESSFUL)
        {
            //
            // Everything was fine, return the result of the evaluated
            // expression and null the global holders
            //
            Result                                    = g_ResultOfEvaluatedExpression;
            g_ErrorStateOfResultOfEvaluatedExpression = NULL;
            g_ResultOfEvaluatedExpression             = NULL;
            *HasError                                 = FALSE;
        }
        else
        {
            //
            // There was an error evaluating the expression from the kernel (debuggee)
            //
            g_ErrorStateOfResultOfEvaluatedExpression = NULL;
            g_ResultOfEvaluatedExpression             = NULL;
 
            *HasError = TRUE;
            Result    = NULL;
        }
    }
    else
    {
        //
        // It's in vmi-mode,
        // execute it locally with regs set to ZERO
        //
        Result = ScriptEngineEvalUInt64StyleExpressionWrapper(Expr, HasError);
    }
 
    //
    // Remove the buffer of script engine interpreted code
    //
    ScriptEngineWrapperRemoveSymbolBuffer(CodeBuffer);
 
    return Result;
}

Variable Documentation

g_ErrorStateOfResultOfEvaluatedExpression

UINT32 g_ErrorStateOfResultOfEvaluatedExpression

extern

Shows the state of the evaluation of expression which whether contains error or not.

g_IsSerialConnectedToRemoteDebuggee

BOOLEAN g_IsSerialConnectedToRemoteDebuggee

extern

Shows if the debugger was connected to remote debuggee over (A remote guest)

g_ResultOfEvaluatedExpression

UINT64 g_ResultOfEvaluatedExpression

extern

Result of the expression that is evaluated in the debuggee.