Changeset 2849

Timestamp:

Nov 2, 2006, 3:05:16 AM (19 years ago)

Author:

bird

Message:

Debug info query.

Location:

trunk/kLdr

Files:

• kLdr.h (modified) (6 diffs)
• kLdrMod.c (modified) (3 diffs)

trunk/kLdr/kLdr.h

@@ -281 +281 @@
 /** @defgroup grp_kLdrMod   kLdrMod - The executable image intepreter
  * @{ */
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 /**
@@ -433 +460 @@
 } KLDRARCH;
 
+
 /**
  * CPU models.
@@ -607 +635 @@
  *
  * @returns 0 if enumeration should continue.
- * @returns non-zero if the enumeration should stop. This status code is the returned by kLdrModEnumSymbols().
+ * @returns non-zero if the enumeration should stop. This status code e returned by kLdrModEnumSymbols().
  *
  * @param   pMod        The module which symbols are being enumerated.s
@@ -622 +650 @@
 /** Pointer to a symbol enumerator callback. */
 typedef FNKLDRMODENUMSYMS *PFNKLDRMODENUMSYMS;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 int     kLdrModOpen(const char *pszFilename, PPKLDRMOD ppMod);
@@ -637 +685 @@
 int     kLdrModGetStackInfo(PKLDRMOD pMod, void *pvBits, KLDRADDR BaseAddress, PKLDRSTACKINFO pStackInfo);
 int     kLdrModQueryMainEntrypoint(PKLDRMOD pMod, void *pvBits, KLDRADDR BaseAddress, PKLDRADDR pMainEPAddress);
-size_t  kLdrModSize(PKLDRMOD pMod);
+/** Pointer to a debug info enumberator callback. */
+typedef FNKLDRENUMDBG *PFNKLDRENUMDBG;
+int     kLdrModEnumDbgInfo(PKLDRMOD pMod, void *pvBits, PFNKLDRENUMDBG pfnCallback, void *pvUser);
+int     kLdrModHasDbgInfo(PKLDRMOD pMod, void *pvBits);
 
 /** @name Operations On The Internally Managed Mapping
@@ -654 +705 @@
 /** @name Operations On The Externally Managed Mappings
  * @{ */
+
 int     kLdrModGetBits(PKLDRMOD pMod, void *pvBits, KLDRADDR BaseAddress, PFNKLDRMODGETIMPORT pfnGetImport, void *pvUser);
 int     kLdrModRelocateBits(PKLDRMOD pMod, void *pvBits, KLDRADDR NewBaseAddress, KLDRADDR OldBaseAddress,
                             PFNKLDRMODGETIMPORT pfnGetImport, void *pvUser);
 /** @} */
+
 
 /** @} */

trunk/kLdr/kLdrMod.c

@@ -308 +308 @@
 
 /**
- * Get the size of the mapped module.
- *
- * @returns The size of the mapped module (in bytes).
- * @param   pMod            The module.
- */
-size_t  kLdrModSize(PKLDRMOD pMod)
+ * Enumerate the debug info formats contained in the executable image.
+ *
+ * @returns 0 on success, non-zero OS or kLdr status code on failure, or non-zero callback status.
+ * @param   pMod            The module.
+ * @param   pvBits          Optional pointer to bits returned by kLdrModGetBits().
+ *                          This can be used by some module interpreters to reduce memory consumption.
+ * @param   pfnCallback     The callback function.
+ * @param   pvUser          The user argument.
+ * @see pg_kDbg for the debug info reader.
+ */
+int     kLdrModEnumDbgInfo(PKLDRMOD pMod, void *pvBits, PFNKLDRENUMDBG pfnCallback, void *pvUser)
 {
     return 0;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 }
 
@@ -445 +465 @@
  */
 int     kLdrModCallThread(PKLDRMOD pMod, unsigned fAttachingOrDetaching)
+
+
+
+
+
+
+
+
+
+
+
+
 {
     return 0;
@@ -488 +520 @@
 }
 
-
-