Callstack.h File Reference

Kernel headers for callstacks. More...

Go to the source code of this file.

Functions
BOOLEAN	CallstackWalkthroughStack (PDEBUGGER_SINGLE_CALLSTACK_FRAME AddressToSaveFrames, UINT32 *FrameCount, UINT64 StackBaseAddress, UINT32 Size, BOOLEAN Is32Bit)
	Walkthrough the stack.

Detailed Description

Kernel headers for callstacks.

Author

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

Version

0.1

Date

2022-03-05

Copyright

This project is released under the GNU Public License v3.

Function Documentation

CallstackWalkthroughStack()

BOOLEAN CallstackWalkthroughStack	(	PDEBUGGER_SINGLE_CALLSTACK_FRAME	AddressToSaveFrames,
		UINT32 *	FrameCount,
		UINT64	StackBaseAddress,
		UINT32	Size,
		BOOLEAN	Is32Bit )

Walkthrough the stack.

Parameters

AddressToSaveFrames
FrameCount
StackBaseAddress
Size
Is32Bit

Returns

BOOLEAN

{
    UINT32 FrameIndex          = 0;
    UINT16 AddressMode         = 0;
    UINT64 Value               = (UINT64)NULL;
    UINT64 CurrentStackAddress = (UINT64)NULL;
 
    if (Size == 0)
    {
        return FALSE;
    }
 
    if (Is32Bit)
    {
        //
        // 32-bit interpretation
        //
        AddressMode = sizeof(UINT32);
        FrameIndex  = Size / AddressMode;
    }
    else
    {
        //
        // 64-bit interpretation
        //
        AddressMode = sizeof(UINT64);
        FrameIndex  = Size / AddressMode;
    }
 
    //
    // Walkthrough the stack
    //
    for (SIZE_T i = 0; i < FrameIndex; i++)
    {
        //
        // Compute the current stack position address
        //
        CurrentStackAddress = StackBaseAddress + (i * AddressMode);
        *FrameCount         = FrameIndex;
 
        if (!CheckAccessValidityAndSafety(CurrentStackAddress, AddressMode))
        {
            AddressToSaveFrames[i].IsStackAddressValid = FALSE;
 
            //
            // Stack is no longer valid or available to access from here
            //
            if (FrameIndex == 0)
            {
                //
                // Stack is invalid
                //
                return FALSE;
            }
            else
            {
                //
                // Stack is invalid, but there are frames that are still valid
                //
                return TRUE;
            }
        }
 
        //
        // Stack address is valid
        //
        AddressToSaveFrames[i].IsStackAddressValid = TRUE;
 
        //
        // Read the 4 or 8 byte from the target stack
        //
        MemoryMapperReadMemorySafeOnTargetProcess(CurrentStackAddress, &Value, AddressMode);
 
        //
        // Set the value
        //
        AddressToSaveFrames[i].Value = Value;
 
        //
        // This implementation has a problem, if the target jump is between two page were the second
        // page is not available, it fails to set it as the valid address,
        // We should check it for this page attribute (check boundary) but for now, i'm lazy enough
        // to let it unimplemented
        //
        // Check if value is a valid address
        //
        if (CheckAccessValidityAndSafety(Value, MAXIMUM_CALL_INSTR_SIZE))
        {
            //
            // It's a valid address
            //
            AddressToSaveFrames[i].IsValidAddress = TRUE;
 
            //
            // Check if the target page has NX bit (executable page)
            //
            AddressToSaveFrames[i].IsExecutable = MemoryMapperCheckIfPageIsNxBitSetOnTargetProcess((PVOID)Value);
 
            //
            // Read the memory at the target address
            //
            MemoryMapperReadMemorySafeOnTargetProcess(Value - MAXIMUM_CALL_INSTR_SIZE,
                                                      AddressToSaveFrames[i].InstructionBytesOnRip,
                                                      MAXIMUM_CALL_INSTR_SIZE);
        }
    }
 
    //
    // Stack walk is finished
    //
    return TRUE;
}