smp.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_PROCESSOR_IDENTITY
struct	_HALP_APIC_INFO_TABLE

Typedefs
typedef struct _PROCESSOR_IDENTITY	PROCESSOR_IDENTITY
typedef struct _PROCESSOR_IDENTITY *	PPROCESSOR_IDENTITY
typedef struct _HALP_APIC_INFO_TABLE	HALP_APIC_INFO_TABLE
typedef struct _HALP_APIC_INFO_TABLE *	PHALP_APIC_INFO_TABLE

Functions
VOID	HalpParseApicTables (_In_ PLOADER_PARAMETER_BLOCK LoaderBlock)
VOID	HalpSetupProcessorsTable (_In_ UINT32 NTProcessorNumber)
VOID	HalpPrintApicTables (VOID)
VOID FASTCALL	HalpBroadcastClockIpi (_In_ UCHAR Vector)
VOID	ApicStartApplicationProcessor (_In_ ULONG NTProcessorNumber, _In_ PHYSICAL_ADDRESS StartupLoc)
VOID NTAPI	HalpRequestIpi (_In_ KAFFINITY TargetProcessors)
	Requests an IPI interrupt on the specified processors.
VOID NTAPI	HalpBroadcastIpiSpecifyVector (_In_ UCHAR Vector, _In_ BOOLEAN IncludeSelf)
	Broadcasts an IPI with a specified vector to all processors.
VOID NTAPI	HalRequestIpiSpecifyVector (_In_ KAFFINITY TargetSet, _In_ UCHAR Vector)
	Requests an IPI with a specified vector on the specified processors.

Typedef Documentation

HALP_APIC_INFO_TABLE

typedef struct _HALP_APIC_INFO_TABLE HALP_APIC_INFO_TABLE

PHALP_APIC_INFO_TABLE

typedef struct _HALP_APIC_INFO_TABLE * PHALP_APIC_INFO_TABLE

PPROCESSOR_IDENTITY

typedef struct _PROCESSOR_IDENTITY * PPROCESSOR_IDENTITY

PROCESSOR_IDENTITY

typedef struct _PROCESSOR_IDENTITY PROCESSOR_IDENTITY

Function Documentation

ApicStartApplicationProcessor()

VOID ApicStartApplicationProcessor	(	_In_ ULONG	NTProcessorNumber,
		_In_ PHYSICAL_ADDRESS	StartupLoc
	)

Definition at line 110 of file apicsmp.c.

{
    ASSERT(StartupLoc.HighPart == 0);
    ASSERT((StartupLoc.QuadPart & 0xFFF) == 0);
    ASSERT((StartupLoc.QuadPart & 0xFFF00FFF) == 0);
 
    /* Init IPI */
    ApicRequestGlobalInterrupt(HalpProcessorIdentity[NTProcessorNumber].LapicId, 0,
        APIC_MT_INIT, APIC_TGM_Edge, APIC_DSH_Destination);
 
    /* De-Assert Init IPI */
    ApicRequestGlobalInterrupt(HalpProcessorIdentity[NTProcessorNumber].LapicId, 0,
        APIC_MT_INIT, APIC_TGM_Level, APIC_DSH_Destination);
 
    /* Stall execution for a bit to give APIC time: MPS Spec - B.4 */
    KeStallExecutionProcessor(200);
 
    /* Startup IPI */
    ApicRequestGlobalInterrupt(HalpProcessorIdentity[NTProcessorNumber].LapicId, (StartupLoc.LowPart) >> 12,
        APIC_MT_Startup, APIC_TGM_Edge, APIC_DSH_Destination);
}

Referenced by HalStartNextProcessor().

HalpBroadcastClockIpi()

VOID FASTCALL HalpBroadcastClockIpi

(

_In_ UCHAR

Vector

)

Definition at line 45 of file up.c.

{
    NOTHING;
}

Referenced by HalpClockInterruptHandler().

HalpBroadcastIpiSpecifyVector()

VOID NTAPI HalpBroadcastIpiSpecifyVector	(	_In_ UCHAR	Vector,
		_In_ BOOLEAN	IncludeSelf
	)

Broadcasts an IPI with a specified vector to all processors.

Parameters

Vector	- Specifies the interrupt vector to be delivered.
IncludeSelf	- Specifies whether to include the current processor.

Definition at line 144 of file apicsmp.c.

{
    APIC_DSH DestinationShortHand = IncludeSelf ?
        APIC_DSH_AllIncludingSelf : APIC_DSH_AllExcludingSelf;
 
    /* Request the interrupt targeted at all processors */
    ApicRequestGlobalInterrupt(0, // Ignored
                               Vector,
                               APIC_MT_Fixed,
                               APIC_TGM_Edge,
                               DestinationShortHand);
}

Referenced by HalpBroadcastClockIpi(), and HalRequestIpiSpecifyVector().

HalpParseApicTables()

VOID HalpParseApicTables

(

_In_ PLOADER_PARAMETER_BLOCK

LoaderBlock

)

Definition at line 30 of file madt.c.

{
    ULONG_PTR TableEnd;
    ULONG ValidProcessorCount;
 
    /* We only support legacy APIC for now, this will be updated in the future */
    HalpApicInfoTable.ApicMode = 0x10;
    MadtTable = HalAcpiGetTable(LoaderBlock, 'CIPA');
 
    AcpiHeader = (ACPI_SUBTABLE_HEADER*)MadtTable;
    AcpiHeader->Length = sizeof(ACPI_TABLE_MADT);
    TableEnd = (ULONG_PTR)MadtTable + MadtTable->Header.Length;
 
    HalpApicInfoTable.ProcessorCount = 0;
    HalpProcessorIdentity = HalpStaticProcessorIdentity;
 
    AcpiHeader = (ACPI_SUBTABLE_HEADER*)MadtTable;
    AcpiHeader->Length = sizeof(ACPI_TABLE_MADT);
    TableEnd = (ULONG_PTR)MadtTable + MadtTable->Header.Length;
 
    while ((ULONG_PTR)AcpiHeader <= TableEnd)
    {
        LocalApic = (ACPI_MADT_LOCAL_APIC*)AcpiHeader;
 
        if (LocalApic->Header.Type == ACPI_MADT_TYPE_LOCAL_APIC &&
            LocalApic->Header.Length == sizeof(ACPI_MADT_LOCAL_APIC))
        {
            ValidProcessorCount = HalpApicInfoTable.ProcessorCount;
 
            HalpProcessorIdentity[ValidProcessorCount].LapicId = LocalApic->Id;
            HalpProcessorIdentity[ValidProcessorCount].ProcessorId = LocalApic->ProcessorId;
 
            HalpApicInfoTable.ProcessorCount++;
 
            AcpiHeader = (ACPI_SUBTABLE_HEADER*)((ULONG_PTR)AcpiHeader + AcpiHeader->Length);
        }
        else
        {
            /* End the parsing early if we don't use the currently selected table */
            AcpiHeader = (ACPI_SUBTABLE_HEADER*)((ULONG_PTR)AcpiHeader + 1);
        }
    }
}

Referenced by HalpInitProcessor().

HalpPrintApicTables()

VOID HalpPrintApicTables

(

VOID

)

Definition at line 76 of file madt.c.

{ 
    UINT32 i;
 
    DPRINT1("HAL has detected a physical processor count of: %d\n", HalpApicInfoTable.ProcessorCount);
    for (i = 0; i < HalpApicInfoTable.ProcessorCount; i++)
    {
        DPRINT1("Information about the following processor is for processors number: %d\n"
                "   The BSPCheck is set to: %X\n"
                "   The LapicID is set to: %X\n",
                i, HalpProcessorIdentity[i].BSPCheck, HalpProcessorIdentity[i].LapicId);
    }
}

Referenced by HalpInitPhase0().

HalpRequestIpi()

VOID NTAPI HalpRequestIpi

(

_In_ KAFFINITY

TargetSet

)

Requests an IPI interrupt on the specified processors.

Parameters

TargetSet

- Specifies the set of processors to send the IPI to.

Definition at line 223 of file apicsmp.c.

{
    /* Request the IPI vector */
    HalRequestIpiSpecifyVector(TargetSet, APIC_IPI_VECTOR);
}

Referenced by HalRequestIpi().

HalpSetupProcessorsTable()

VOID HalpSetupProcessorsTable

(

_In_ UINT32

NTProcessorNumber

)

Definition at line 37 of file up.c.

{
    NOTHING;
}

Referenced by HalpInitProcessor().

HalRequestIpiSpecifyVector()

VOID NTAPI HalRequestIpiSpecifyVector	(	_In_ KAFFINITY	TargetSet,
		_In_ UCHAR	Vector
	)

Requests an IPI with a specified vector on the specified processors.

Parameters

TargetSet	- Specifies the set of processors to send the IPI to.
Vector	- Specifies the interrupt vector to be delivered.

Remarks

This function is exported on Windows 10.

Definition at line 169 of file apicsmp.c.

{
    KAFFINITY ActiveProcessors = HalpActiveProcessors;
    KAFFINITY RemainingSet, SetMember;
    ULONG ProcessorIndex;
    ULONG LApicId;
 
    /* Sanitize the target set */
    TargetSet &= ActiveProcessors;
 
    /* Check if all processors are requested */
    if (TargetSet == ActiveProcessors)
    {
        /* Send an IPI to all processors, including this processor */
        HalpBroadcastIpiSpecifyVector(Vector, TRUE);
        return;
    }
 
    /* Check if all processors except the current one are requested */
    if (TargetSet == (ActiveProcessors & ~KeGetCurrentPrcb()->SetMember))
    {
        /* Send an IPI to all processors, excluding this processor */
        HalpBroadcastIpiSpecifyVector(Vector, FALSE);
        return;
    }
 
    /* Loop while we have more processors */
    RemainingSet = TargetSet;
    while (RemainingSet != 0)
    {
        NT_VERIFY(BitScanForwardAffinity(&ProcessorIndex, RemainingSet) != 0);
        ASSERT(ProcessorIndex < KeNumberProcessors);
        SetMember = AFFINITY_MASK(ProcessorIndex);
        RemainingSet &= ~SetMember;
 
        /* Send the interrupt to the target processor */
        LApicId = HalpProcessorIdentity[ProcessorIndex].LapicId;
        ApicRequestGlobalInterrupt(LApicId,
                                   Vector,
                                   APIC_MT_Fixed,
                                   APIC_TGM_Edge,
                                   APIC_DSH_Destination);
    }
}

Referenced by HalpRequestIpi().