MdeModulePkg/Include/Library/DebugAgentLib.h

   1 /** @file
   2   Debug Agent Library provide source-level debug capability.
   3
   4 Copyright (c) 2010, Intel Corporation.  All rights reserved<BR>
   5 This program and the accompanying materials are licensed and made available under
   6 the terms and conditions of the BSD License that accompanies this distribution.
   7 The full text of the license may be found at
   8 http://opensource.org/licenses/bsd-license.php.
   9
  10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 #ifndef __DEBUG_AGENT_LIB_H__
  16 #define __DEBUG_AGENT_LIB_H__
  17
  18 #define DEBUG_AGENT_INIT_PREMEM_SEC      1
  19 #define DEBUG_AGENT_INIT_POSTMEM_SEC     2
  20 #define DEBUG_AGENT_INIT_DXE_CORE        3
  21 #define DEBUG_AGENT_INIT_SMM             4
  22 #define DEBUG_AGENT_INIT_ENTER_SMI       5
  23 #define DEBUG_AGENT_INIT_EXIT_SMI        6
  24 #define DEBUG_AGENT_INIT_S3              7
  25
  26 /**
  27   Initialize debug agent.
  28
  29   This function is used to set up debug enviroment.
  30
  31   @param[in] InitFlag   Init flag is used to decide the initialize process.
  32   @param[in] Context    Context needed according to InitFlag; it was optional.
  33
  34 **/
  35 VOID
  36 EFIAPI
  37 InitializeDebugAgent (
  38   IN UINT32                InitFlag,
  39   IN VOID                  *Context  OPTIONAL
  40   );
  41
  42 /**
  43   Enable/Disable the interrupt of debug timer and return the interrupt state
  44   prior to the operation.
  45
  46   If EnableStatus is TRUE, enable the interrupt of debug timer.
  47   If EnableStatus is FALSE, disable the interrupt of debug timer.
  48
  49   @param[in] EnableStatus    Enable/Disable.
  50
  51   @retval TRUE  Debug timer interrupt were enabled on entry to this call.
  52   @retval FALSE Debug timer interrupt were disabled on entry to this call.
  53
  54 **/
  55 BOOLEAN
  56 EFIAPI
  57 SaveAndSetDebugTimerInterrupt (
  58   IN BOOLEAN                EnableStatus
  59   );
  60
  61 #endif