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