ArmPkg/Library/DebugPeCoffExtraActionLib/DebugPeCoffExtraActionLib.c

   1 /**@file
   2
   3 Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>
   4 Portions copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>
   5 Portions copyright (c) 2011 - 2012, ARM Ltd. All rights reserved.<BR>
   6
   7 SPDX-License-Identifier: BSD-2-Clause-Patent
   8
   9 **/
  10
  11 #include <PiDxe.h>
  12 #include <Library/PeCoffLib.h>
  13
  14 #include <Library/BaseLib.h>
  15 #include <Library/DebugLib.h>
  16 #include <Library/BaseMemoryLib.h>
  17 #include <Library/PeCoffExtraActionLib.h>
  18 #include <Library/PrintLib.h>
  19
  20 /**
  21   If the build is done on cygwin the paths are cygpaths.
  22   /cygdrive/c/tmp.txt vs c:\tmp.txt so we need to convert
  23   them to work with RVD commands
  24
  25   @param  Name  Path to convert if needed
  26
  27 **/
  28 CHAR8 *
  29 DeCygwinPathIfNeeded (
  30   IN  CHAR8  *Name,
  31   IN  CHAR8  *Temp,
  32   IN  UINTN  Size
  33   )
  34 {
  35   CHAR8  *Ptr;
  36   UINTN  Index;
  37   UINTN  Index2;
  38
  39   Ptr = AsciiStrStr (Name, "/cygdrive/");
  40   if (Ptr == NULL) {
  41     return Name;
  42   }
  43
  44   for (Index = 9, Index2 = 0; (Index < (Size + 9)) && (Ptr[Index] != '\0'); Index++, Index2++) {
  45     Temp[Index2] = Ptr[Index];
  46     if (Temp[Index2] == '/') {
  47       Temp[Index2] = '\\';
  48     }
  49
  50     if (Index2 == 1) {
  51       Temp[Index2 - 1] = Ptr[Index];
  52       Temp[Index2]     = ':';
  53     }
  54   }
  55
  56   return Temp;
  57 }
  58
  59 /**
  60   Performs additional actions after a PE/COFF image has been loaded and relocated.
  61
  62   If ImageContext is NULL, then ASSERT().
  63
  64   @param  ImageContext  Pointer to the image context structure that describes the
  65                         PE/COFF image that has already been loaded and relocated.
  66
  67 **/
  68 VOID
  69 EFIAPI
  70 PeCoffLoaderRelocateImageExtraAction (
  71   IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
  72   )
  73 {
  74  #if !defined (MDEPKG_NDEBUG)
  75   CHAR8  Temp[512];
  76  #endif
  77
  78   if (ImageContext->PdbPointer) {
  79  #ifdef __CC_ARM
  80     // Print out the command for the DS-5 to load symbols for this image
  81     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "add-symbol-file %a 0x%p\n", DeCygwinPathIfNeeded (ImageContext->PdbPointer, Temp, sizeof (Temp)), (UINTN)(ImageContext->ImageAddress + ImageContext->SizeOfHeaders)));
  82  #elif __GNUC__
  83     // This may not work correctly if you generate PE/COFF directly as then the Offset would not be required
  84     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "add-symbol-file %a 0x%p\n", DeCygwinPathIfNeeded (ImageContext->PdbPointer, Temp, sizeof (Temp)), (UINTN)(ImageContext->ImageAddress + ImageContext->SizeOfHeaders)));
  85  #else
  86     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "Loading driver at 0x%11p EntryPoint=0x%11p\n", (VOID *)(UINTN)ImageContext->ImageAddress, FUNCTION_ENTRY_POINT (ImageContext->EntryPoint)));
  87  #endif
  88   } else {
  89     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "Loading driver at 0x%11p EntryPoint=0x%11p\n", (VOID *)(UINTN)ImageContext->ImageAddress, FUNCTION_ENTRY_POINT (ImageContext->EntryPoint)));
  90   }
  91 }
  92
  93 /**
  94   Performs additional actions just before a PE/COFF image is unloaded.  Any resources
  95   that were allocated by PeCoffLoaderRelocateImageExtraAction() must be freed.
  96
  97   If ImageContext is NULL, then ASSERT().
  98
  99   @param  ImageContext  Pointer to the image context structure that describes the
 100                         PE/COFF image that is being unloaded.
 101
 102 **/
 103 VOID
 104 EFIAPI
 105 PeCoffLoaderUnloadImageExtraAction (
 106   IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
 107   )
 108 {
 109  #if !defined (MDEPKG_NDEBUG)
 110   CHAR8  Temp[512];
 111  #endif
 112
 113   if (ImageContext->PdbPointer) {
 114  #ifdef __CC_ARM
 115     // Print out the command for the RVD debugger to load symbols for this image
 116     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "unload symbols_only %a\n", DeCygwinPathIfNeeded (ImageContext->PdbPointer, Temp, sizeof (Temp))));
 117  #elif __GNUC__
 118     // This may not work correctly if you generate PE/COFF directly as then the Offset would not be required
 119     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "remove-symbol-file %a 0x%08x\n", DeCygwinPathIfNeeded (ImageContext->PdbPointer, Temp, sizeof (Temp)), (UINTN)(ImageContext->ImageAddress + ImageContext->SizeOfHeaders)));
 120  #else
 121     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "Unloading %a\n", ImageContext->PdbPointer));
 122  #endif
 123   } else {
 124     DEBUG ((DEBUG_LOAD | DEBUG_INFO, "Unloading driver at 0x%11p\n", (VOID *)(UINTN)ImageContext->ImageAddress));
 125   }
 126 }