debug.c File Reference

#include <freeldr.h>
#include <debug.h>

Include dependency graph for debug.c:

Go to the source code of this file.

Functions
VOID	DebugInit (_In_ PCSTR DebugString)
ULONG	DbgPrint (PCCH Format,...)
VOID	DbgPrint2 (ULONG Mask, ULONG Level, const char *File, ULONG Line, char *Format,...)
VOID	DebugDumpBuffer (ULONG Mask, PVOID Buffer, ULONG Length)
VOID	DbgParseDebugChannels (PCHAR Value)
ULONG	MsgBoxPrint (const char *Format,...)
DECLSPEC_NORETURN VOID NTAPI	KeBugCheckEx (IN ULONG BugCheckCode, IN ULONG_PTR BugCheckParameter1, IN ULONG_PTR BugCheckParameter2, IN ULONG_PTR BugCheckParameter3, IN ULONG_PTR BugCheckParameter4)
VOID NTAPI	RtlAssert (IN PVOID FailedAssertion, IN PVOID FileName, IN ULONG LineNumber, IN PCHAR Message OPTIONAL)

Variables
char *	BugCodeStrings []
ULONG_PTR	BugCheckInfo [5]

Function Documentation

DbgParseDebugChannels()

VOID DbgParseDebugChannels

(

PCHAR

Value

)

Definition at line 445 of file debug.c.

{
    UNREFERENCED_PARAMETER(Value);
}

DbgPrint()

ULONG DbgPrint	(	PCCH	Format,
			...
	)

Definition at line 419 of file debug.c.

{
    UNREFERENCED_PARAMETER(Format);
    return 0;
}

DbgPrint2()

VOID DbgPrint2	(	ULONG	Mask,
		ULONG	Level,
		const char *	File,
		ULONG	Line,
		char *	Format,
			...
	)

Definition at line 426 of file debug.c.

{
    UNREFERENCED_PARAMETER(Mask);
    UNREFERENCED_PARAMETER(Level);
    UNREFERENCED_PARAMETER(File);
    UNREFERENCED_PARAMETER(Line);
    UNREFERENCED_PARAMETER(Format);
}

DebugDumpBuffer()

VOID DebugDumpBuffer	(	ULONG	Mask,
		PVOID	Buffer,
		ULONG	Length
	)

Definition at line 436 of file debug.c.

{
    UNREFERENCED_PARAMETER(Mask);
    UNREFERENCED_PARAMETER(Buffer);
    UNREFERENCED_PARAMETER(Length);
}

DebugInit()

VOID DebugInit

(

_In_ PCSTR

DebugString

)

Definition at line 412 of file debug.c.

{
    UNREFERENCED_PARAMETER(DebugString);
}

KeBugCheckEx()

DECLSPEC_NORETURN VOID NTAPI KeBugCheckEx	(	IN ULONG	BugCheckCode,
		IN ULONG_PTR	BugCheckParameter1,
		IN ULONG_PTR	BugCheckParameter2,
		IN ULONG_PTR	BugCheckParameter3,
		IN ULONG_PTR	BugCheckParameter4
	)

Definition at line 485 of file debug.c.

{
    char Buffer[70];
 
    sprintf(Buffer,
            "*** STOP: 0x%08lX (0x%p,0x%p,0x%p,0x%p)",
            BugCheckCode,
            (PVOID)BugCheckParameter1,
            (PVOID)BugCheckParameter2,
            (PVOID)BugCheckParameter3,
            (PVOID)BugCheckParameter4);
 
    UiMessageBoxCritical(Buffer);
    ASSERT(FALSE);
    for (;;);
}

Referenced by _Acquires_nonreentrant_lock_(), _Function_class_(), _IRQL_requires_max_(), _IRQL_requires_min_(), _Releases_nonreentrant_lock_(), ClasspReleaseQueue(), CmGetSystemControlValues(), CmGetSystemDriverList(), CmInitSystem1(), CmpHiveRootSecurityDescriptor(), CmpInitializeCache(), CmpInitializeHiveList(), CmpInitializeSystemHive(), CmpSecurityMethod(), CmpValueToData(), CODE_SEG(), DceCreateDisplayDC(), DoCrashCommand(), ExAllocatePoolWithTag(), ExFreePoolWithTag(), ExpCheckPoolAllocation(), ExpCheckPoolHeader(), ExpCheckPoolIrqlLevel(), ExpCheckPoolLinks(), ExpCreateSystemRootLink(), ExpInitializeExecutive(), ExpInitializeWorkerThreads(), ExpInitNls(), ExpLoadInitialProcess(), ExpSystemErrorHandler(), ExpWorkerThreadEntryPoint(), ExQueueWorkItem(), ExReleaseResourceForThreadLite(), ExReturnPoolQuota(), ExSetResourceOwnerPointer(), FsRtlWorkerThread(), HalInitSystem(), HaliReadMPConfigTable(), HalpAcpiTableCacheInit(), HalpAllocateArray(), HalpCopyBufferMap(), HalpReportResourceUsage(), InitializePool(), IoAssignResources(), IoCancelFileOpen(), IoCancelIrp(), IofCallDriver(), IofCompleteRequest(), IoInvalidateDeviceRelations(), IoInvalidateDeviceState(), IopInitializePlugPlayServices(), IopMarkBootPartition(), IopMountVolume(), IopParseDevice(), IopStartRamdisk(), IoReportTargetDeviceChange(), IoReportTargetDeviceChangeAsynchronous(), IoSynchronousInvalidateDeviceRelations(), KeAcquireInStackQueuedSpinLockAtDpcLevel(), KeAcquireSpinLockAtDpcLevel(), KeAttachProcess(), KefAcquireSpinLockAtDpcLevel(), KefReleaseSpinLockFromDpcLevel(), KeRaiseIrqlToSynchLevel(), KeReleaseInStackQueuedSpinLockFromDpcLevel(), KeReleaseSpinLockFromDpcLevel(), KeRemoveQueue(), KeRestoreFloatingPointState(), KeRundownThread(), KeStackAttachProcess(), KeTryToAcquireSpinLockAtDpcLevel(), KiDeliverApc(), KiDispatchException(), KiEspToTrapFrame(), KiExitSystemCallDebugChecks(), KiInitializeKernel(), KiInitMachineDependent(), KiSwapContextExit(), KiSwapContextResume(), KiSystemService(), KiUserModeCallout(), KiVerifyCpuFeatures(), MiDecrementReferenceCount(), MiDecrementShareCount(), MiDeletePte(), MiFreeContiguousMemory(), MiInitializePfn(), MiInitializePfnAndMakePteValid(), MiInitializeSessionIds(), MiInsertPageInList(), MiMakeSystemAddressValid(), MiMakeSystemAddressValidPfn(), MiMapPfnDatabase(), MiniResetComplete(), MiRemoveFromSystemSpace(), MiSpecialPoolCheckPattern(), MmAccessFaultSectionView(), MmAllocateSpecialPool(), MmArmAccessFault(), MmArmInitSystem(), MmCommitSessionMappedView(), MmCreatePageFileMapping(), MmDeletePageFileMapping(), MmDeterminePoolType(), MmFreePagesFromMdl(), MmFreeSpecialPool(), MmMapLockedPagesSpecifyCache(), MmMapLockedPagesWithReservedMapping(), MmPageOutPhysicalAddress(), MmUnmapReservedMapping(), MmZeroPageThread(), MupDereferenceVcb(), Mx::MxBugCheckEx(), MxGetNextPage(), NdisIPnPStartDevice(), NdisMAllocateSharedMemory(), NtUserInitialize(), ObpCloseHandle(), ObpCloseHandleTableEntry(), PciAddDevice(), Phase1InitializationDiscard(), PiInitializeDevNode(), PopShutdownSystem(), PoShutdownBugCheck(), PsInitSystem(), PsLocateSystemDll(), PspCatchCriticalBreak(), PspExitThread(), PspInitializeSystemDll(), PspReturnProcessQuotaSpecifiedPool(), PspUnhandledExceptionInSystemThread(), RxAssert(), SeDefaultObjectMethod(), SeInitSystem(), USBPORT_FindUrbInIrpTable(), USBPORT_InsertIrpInTable(), USBPORT_SplitBulkInterruptTransfer(), USBPORT_SplitTransfer(), USBPORT_Unload(), UserInitialize(), vfatInitFcb(), and xHalTranslateBusAddress().

MsgBoxPrint()

ULONG MsgBoxPrint	(	const char *	Format,
			...
	)

Definition at line 453 of file debug.c.

{
    va_list ap;
    CHAR Buffer[512];
    ULONG Length;
 
    va_start(ap, Format);
 
    /* Construct a string */
    Length = _vsnprintf(Buffer, 512, Format, ap);
 
    /* Check if we went past the buffer */
    if (Length == MAXULONG)
    {
        /* Terminate it if we went over-board */
        Buffer[sizeof(Buffer) - 1] = '\n';
 
        /* Put maximum */
        Length = sizeof(Buffer);
    }
 
    /* Show it as a message box */
    UiMessageBox(Buffer);
 
    /* Cleanup and exit */
    va_end(ap);
    return 0;
}

RtlAssert()

VOID NTAPI RtlAssert	(	IN PVOID	FailedAssertion,
		IN PVOID	FileName,
		IN ULONG	LineNumber,
		IN PCHAR Message	OPTIONAL
	)

Definition at line 509 of file debug.c.

{
    PCSTR Format;
 
    if (Message)
    {
        Format = "Assertion \'%s\' failed at %s line %lu: %s\n";
 
        DbgPrint(Format,
                 (PCHAR)FailedAssertion,
                 (PCHAR)FileName,
                 LineNumber,
                 Message);
 
        FrLdrBugCheckWithMessage(
                 ASSERT_FAILURE, FileName, LineNumber,
                 Format,
                 (PCHAR)FailedAssertion,
                 (PCHAR)FileName,
                 LineNumber,
                 Message);
    }
    else
    {
        Format = "Assertion \'%s\' failed at %s line %lu\n";
 
        DbgPrint(Format,
                 (PCHAR)FailedAssertion,
                 (PCHAR)FileName,
                 LineNumber);
 
        FrLdrBugCheckWithMessage(
                 ASSERT_FAILURE, FileName, LineNumber,
                 Format,
                 (PCHAR)FailedAssertion,
                 (PCHAR)FileName,
                 LineNumber);
    }
 
    DbgBreakPoint();
}

Referenced by USBPORT_AssertFailure().

Variable Documentation

BugCheckInfo

ULONG_PTR BugCheckInfo[5]

Definition at line 566 of file debug.c.

Referenced by FrLdrBugCheckEx().

BugCodeStrings

char* BugCodeStrings[]

Initial value:

=
{
    "TEST_BUGCHECK",
    "MISSING_HARDWARE_REQUIREMENTS",
    "FREELDR_IMAGE_CORRUPTION",
    "MEMORY_INIT_FAILURE",
    "ASSERT_FAILURE",
 
 
 
}

Definition at line 554 of file debug.c.

Referenced by FrLdrBugCheckEx(), and FrLdrBugCheckWithMessage().