You've already forked slimbootloader
mirror of
https://github.com/Dasharo/slimbootloader.git
synced 2026-03-06 15:26:20 -08:00
Mike Crowe
990e3e81e6
Convert the line endings stored for all text files in the repository to LF. The majority previously used DOS-style CRLF line endings. Add a .gitattributes file to enforce this and treat certain extensions as never being text files. Update PatchCheck.py to insist on LF line endings rather than CRLF. However, its other checks fail on this commit due to lots of pre-existing complaints that it only notices because the line endings have changed. Silicon/QemuSocPkg/FspBin/Patches/0001-Build-QEMU-FSP-2.0-binaries.patch needs to be treated as binary since it contains a mixture of line endings. This change has implications depending on the client platform you are using the repository from: * Windows The usual configuration for Git on Windows means that text files will be checked out to the work tree with DOS-style CRLF line endings. If that's not the case then you can configure Git to do so for the entire machine with: git config --global core.autocrlf true or for just the repository with: git config core.autocrlf true Line endings will be normalised to LF when they are committed to the repository. If you commit a text file with only LF line endings then it will be converted to CRLF line endings in your work tree. * Linux, MacOS and other Unices The usual configuration for Git on such platforms is to check files out of the repository with LF line endings. This is probably the right thing for you. In the unlikely even that you are using Git on Unix but editing or compiling on Windows for some reason then you may need to tweak your configuration to force the use of CRLF line endings as described above. * General For more information see https://docs.github.com/en/get-started/getting-started-with-git/configuring-git-to-handle-line-endings . Fixes: https://github.com/slimbootloader/slimbootloader/issues/1400 Signed-off-by: Mike Crowe <mac@mcrowe.com>
155 lines
4.5 KiB
C
155 lines
4.5 KiB
C
/** @file
|
|
Debug Agent Library provide source-level debug capability.
|
|
|
|
Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __DEBUG_AGENT_LIB_H__
|
|
#define __DEBUG_AGENT_LIB_H__
|
|
|
|
#include <Uefi/UefiBaseType.h>
|
|
#include <Library/BaseLib.h>
|
|
|
|
#define DEBUG_AGENT_INIT_PREMEM_SEC 1
|
|
#define DEBUG_AGENT_INIT_POSTMEM_SEC 2
|
|
#define DEBUG_AGENT_INIT_DXE_CORE 3
|
|
#define DEBUG_AGENT_INIT_SMM 4
|
|
#define DEBUG_AGENT_INIT_ENTER_SMI 5
|
|
#define DEBUG_AGENT_INIT_EXIT_SMI 6
|
|
#define DEBUG_AGENT_INIT_S3 7
|
|
#define DEBUG_AGENT_INIT_DXE_AP 8
|
|
#define DEBUG_AGENT_INIT_PEI 9
|
|
#define DEBUG_AGENT_INIT_DXE_LOAD 10
|
|
#define DEBUG_AGENT_INIT_DXE_UNLOAD 11
|
|
#define DEBUG_AGENT_INIT_THUNK_PEI_IA32TOX64 12
|
|
|
|
/**
|
|
Caller provided function to be invoked at the end of InitializeDebugAgent().
|
|
|
|
Refer to the description for InitializeDebugAgent() for more details.
|
|
|
|
@param[in] Context The first input parameter of InitializeDebugAgent().
|
|
|
|
**/
|
|
typedef
|
|
VOID
|
|
(EFIAPI * DEBUG_AGENT_CONTINUE)(
|
|
IN VOID *Context
|
|
);
|
|
|
|
//
|
|
// Context for PE_COFF_LOADER_IMAGE_CONTEXT
|
|
//
|
|
typedef struct {
|
|
PHYSICAL_ADDRESS ImageAddress;
|
|
CHAR8 *PdbPointer;
|
|
} PE_COFF_LOADER_IMAGE_CONTEXT;
|
|
|
|
/**
|
|
Performs additional actions after a PE/COFF image has been loaded and relocated.
|
|
|
|
If ImageContext is NULL, then ASSERT().
|
|
|
|
@param ImageContext Pointer to the image context structure that describes the
|
|
PE/COFF image that has already been loaded and relocated.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
PeCoffLoaderRelocateImageExtraAction (
|
|
IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext
|
|
);
|
|
|
|
/**
|
|
Performs additional actions just before a PE/COFF image is unloaded. Any resources
|
|
that were allocated by PeCoffLoaderRelocateImageExtraAction() must be freed.
|
|
|
|
If ImageContext is NULL, then ASSERT().
|
|
|
|
@param ImageContext Pointer to the image context structure that describes the
|
|
PE/COFF image that is being unloaded.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
PeCoffLoaderUnloadImageExtraAction (
|
|
IN OUT PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext
|
|
);
|
|
|
|
/**
|
|
Find and report image info to HOST.
|
|
|
|
@param ImageBase Pointer to the current image base.
|
|
|
|
**/
|
|
VOID
|
|
PeCoffFindAndReportImageInfo (
|
|
IN UINT32 ImageBase
|
|
);
|
|
|
|
/**
|
|
Update IDT entries for DebugAgent whenever IDT base is re-configured
|
|
|
|
@param[in] IdtDescriptor IDT descriptor which needs to be updated
|
|
@param[in] Function Continue function called by debug agent library
|
|
|
|
**/
|
|
VOID
|
|
UpdateDebugAgentIdt (
|
|
IN IA32_DESCRIPTOR *IdtDescriptor,
|
|
IN DEBUG_AGENT_CONTINUE Function
|
|
);
|
|
|
|
/**
|
|
Initialize debug agent.
|
|
|
|
This function is used to set up debug environment to support source level debugging.
|
|
If certain Debug Agent Library instance has to save some private data in the stack,
|
|
this function must work on the mode that doesn't return to the caller, then
|
|
the caller needs to wrap up all rest of logic after InitializeDebugAgent() into one
|
|
function and pass it into InitializeDebugAgent(). InitializeDebugAgent() is
|
|
responsible to invoke the passing-in function at the end of InitializeDebugAgent().
|
|
|
|
If the parameter Function is not NULL, Debug Agent Library instance will invoke it by
|
|
passing in the Context to be its parameter.
|
|
|
|
If Function() is NULL, Debug Agent Library instance will return after setup debug
|
|
environment.
|
|
|
|
@param[in] InitFlag Init flag is used to decide the initialize process.
|
|
@param[in] Context Context needed according to InitFlag; it was optional.
|
|
@param[in] Function Continue function called by debug agent library; it was
|
|
optional.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
InitializeDebugAgent (
|
|
IN UINT32 InitFlag,
|
|
IN VOID *Context, OPTIONAL
|
|
IN DEBUG_AGENT_CONTINUE Function OPTIONAL
|
|
);
|
|
|
|
/**
|
|
Enable/Disable the interrupt of debug timer and return the interrupt state
|
|
prior to the operation.
|
|
|
|
If EnableStatus is TRUE, enable the interrupt of debug timer.
|
|
If EnableStatus is FALSE, disable the interrupt of debug timer.
|
|
|
|
@param[in] EnableStatus Enable/Disable.
|
|
|
|
@retval TRUE Debug timer interrupt were enabled on entry to this call.
|
|
@retval FALSE Debug timer interrupt were disabled on entry to this call.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
SaveAndSetDebugTimerInterrupt (
|
|
IN BOOLEAN EnableStatus
|
|
);
|
|
|
|
#endif
|