LbrApi.h File Reference

Header for LBR tracing routines for HyperTrace module (Intel Last Branch Record). More...

Go to the source code of this file.

Functions
VOID	HyperTraceLbrExamplePerformTrace ()
	Example of performing LBR trace.
BOOLEAN	HyperTraceLbrDisable (HYPERTRACE_LBR_OPERATION_PACKETS *HyperTraceOperationRequest)
	Disable LBR tracing for HyperTrace.

Detailed Description

Header for LBR tracing routines for HyperTrace module (Intel Last Branch Record).

Author

Hari Mishal (harim.nosp@m.isha.nosp@m.l6@gm.nosp@m.ail..nosp@m.com)

Version

0.18

Date

2025-12-02

Copyright

This project is released under the GNU Public License v3.

Function Documentation

HyperTraceLbrDisable()

BOOLEAN HyperTraceLbrDisable

(

HYPERTRACE_LBR_OPERATION_PACKETS *

HyperTraceOperationRequest

)

Disable LBR tracing for HyperTrace.

Parameters

HyperTraceOperationRequest

Returns

BOOLEAN

{
    //
    // Check if LBR is already disabled or not
    //
    if (!g_LastBranchRecordEnabled)
    {
        HyperTraceLbrSetKernelStatus(HyperTraceOperationRequest, DEBUGGER_ERROR_LBR_ALREADY_DISABLED);
        return FALSE;
    }
 
    //
    // Disabling LBR
    //
    g_LastBranchRecordEnabled = FALSE;
 
    //
    // Broadcast disabling LBR on all cores
    //
    BroadcastDisableLbrOnAllCores();
 
    //
    // Set successful status
    //
    HyperTraceLbrSetKernelStatus(HyperTraceOperationRequest, DEBUGGER_OPERATION_WAS_SUCCESSFUL);
 
    return TRUE;
}

HyperTraceLbrExamplePerformTrace()

VOID HyperTraceLbrExamplePerformTrace

(

)

Example of performing LBR trace.

Returns

VOID

{
    if (LbrStart(LBR_SELECT_WITHOUT_FILTER))
    {
        for (volatile int i = 0; i < 50; i++)
        {
            if (i % 2)
            {
                INT A = i * 2;
                A += 5;
            }
            else
            {
                CpuNop();
                CpuNop();
            }
        }
 
        LogInfo("Dumping LBR Buffer...\n");
 
        LbrStop();
        LbrPrint(); // This will print the collected LBR branches to the log
    }
}