Changeset 2861 for trunk/kLdr/kLdrRdr.c

Timestamp:

Nov 10, 2006, 4:04:42 AM (19 years ago)

Author:

bird

Message:

Put the PE module interpreter thru the wringer and learnt how much the window file mapping API sucks.

File:

• trunk/kLdr/kLdrRdr.c (modified) (1 diff)

trunk/kLdr/kLdrRdr.c

@@ -223 +223 @@
 
 /**
- * Prepares a memory region to map file sections into.
- *
- * @returns 0 on success, OS specific error code on failure.
- * @param   pRdr        The file provider instance.
- * @param   ppv         If fFixed is set, *ppv contains the memory location which
- *                      the region should be based at. If fFixed is clear the OS
- *                      is free to choose the location.
- *                      On successful return *ppv contains address of the prepared
- *                      memory region.
- * @param   cb          The size of the memory region to prepare.
- * @param   fFixed      When set *ppv will contain the desired region address.
- *
- */
-int kLdrRdrPrepare(PKLDRRDR pRdr, void **ppv, size_t cb, unsigned fFixed)
-{
-    KLDRRDR_VALIDATE(pRdr);
-    return pRdr->pOps->pfnPrepare(pRdr, ppv, cb, fFixed);
-}
-
-
-/**
- * Maps a section of the file into the memory region reserved by pfnPrepare.
- *
- * @returns 0 on success, OS specific error code on failure.
- * @param   pRdr        The file provider instance.
- * @param   pv          The address in the prepared region.
- * @param   cb          The size of the memory mapping.
- * @param   enmProt     The desired memory protection.
- * @param   offFile     The start of the raw file bytes.
- * @param   cbFile      The number of raw file bytes. This must be less or equal to cb.
- */
-int kLdrRdrMap(PKLDRRDR pRdr, void *pv, size_t cb, KLDRPROT enmProt, off_t offFile, size_t cbFile)
-{
-    KLDRRDR_VALIDATE(pRdr);
-    return pRdr->pOps->pfnMap(pRdr, pv, cb, enmProt, offFile, cbFile);
-}
-
-
-/**
- * Reloads dirty pages in mapped section.
- *
- * @returns 0 on success, OS specific error code on failure.
- * @param   pRdr        The file provider instance.
- * @param   pv          The address in the prepared region.
- * @param   cb          The size of the memory mapping.
- * @param   enmProt     The desired memory protection.
- * @param   offFile     The start of the raw file bytes.
- * @param   cbFile      The number of raw file bytes. This must be less or equal to cb.
- */
-int kLdrRdrRefreshMap(PKLDRRDR pRdr, void *pv, size_t cb, KLDRPROT enmProt, off_t offFile, size_t cbFile)
-{
-    KLDRRDR_VALIDATE(pRdr);
-    return pRdr->pOps->pfnRefreshMap(pRdr, pv, cb, enmProt, offFile, cbFile);
-}
-
-
-/**
- * Changes the page protection of a section mapped using pfnMap.
- *
- * This is typically used for applying fixups and similar.
- *
- * @returns 0 on success, OS specific error code on failure.
- * @param   pRdr        The file provider instance.
- * @param   pv          The address passed to pfnMap.
- * @param   cb          The size passed to pfnMap.
- * @param   enmProt     The desired memory protection.
- */
-int kLdrRdrProtect(PKLDRRDR pRdr, void *pv, size_t cb, KLDRPROT enmProt)
-{
-    KLDRRDR_VALIDATE(pRdr);
-    return pRdr->pOps->pfnProtect(pRdr, pv, cb, enmProt);
-}
-
-
-/**
- * Unmaps a section of the file previously mapped using pfnMap.
- *
- * @returns 0 on success, OS specific error code on failure.
- * @param   pRdr        The file provider instance.
- * @param   pv          The address passed to pfnMap.
- * @param   cb          The size passed to pfnMap.
- */
-int kLdrRdrUnmap(PKLDRRDR pRdr, void *pv, size_t cb)
-{
-    KLDRRDR_VALIDATE(pRdr);
-    return pRdr->pOps->pfnUnmap(pRdr, pv, cb);
-}
-
-
-/**
- * Releases the memory region prepared by pfnPrepare().
- *
- * Before calling this function, all sections mapped by pfnMap must first be unmapped by calling pfnUnmap.
- *
- * @returns 0 on success, OS specific error code on failure.
- * @param   pRdr        The file provider instance.
- * @param   pv          The address of the prepared region.
- * @param   cb          The size of the prepared region.
- */
-int kLdrRdrUnprepare(PKLDRRDR pRdr, void *pv, size_t cb)
-{
-    KLDRRDR_VALIDATE(pRdr);
-    return pRdr->pOps->pfnUnprepare(pRdr, pv, cb);
+ * Maps the segments of a image into memory.
+ *
+ * The file reader will be using the RVA member of each segment to figure out where
+ * it goes relative to the image base address.
+ *
+ * @returns 0 on success, OS specific error code on failure.
+ * @param   pRdr        The file provider instance.
+ * @param   ppvBase     On input when fFixed is set, this contains the base address of the mapping.
+ *                      On output this contains the base of the image mapping.
+ * @param   cSegments   The number of segments in the array pointed to by paSegments.
+ * @param   paSegments  The segments thats going to be mapped.
+ * @param   fFixed      If set, the address at *ppvBase should be the base address of the mapping.
+ */
+int kLdrRdrMap(PKLDRRDR pRdr, void **ppvBase, uint32_t cSegments, PCKLDRSEG paSegments, unsigned fFixed)
+{
+    KLDRRDR_VALIDATE(pRdr);
+    return pRdr->pOps->pfnMap(pRdr, ppvBase, cSegments, paSegments, fFixed);
+}
+
+
+/**
+ * Reloads dirty pages in mapped image.
+ *
+ * @returns 0 on success, OS specific error code on failure.
+ * @param   pRdr        The file provider instance.
+ * @param   pvBase      The base address of the image mapping.
+ * @param   cSegments   The number of segments in the array pointed to by paSegments.
+ * @param   paSegments  The segments thats going to be mapped.
+ */
+int kLdrRdrRefresh(PKLDRRDR pRdr, void *pvBase, uint32_t cSegments, PCKLDRSEG paSegments)
+{
+    KLDRRDR_VALIDATE(pRdr);
+    return pRdr->pOps->pfnRefresh(pRdr, pvBase, cSegments, paSegments);
+}
+
+
+/**
+ * Protects or unprotects an image mapping.
+ *
+ * This is typically used for getting write access to read or execute only
+ * pages while applying fixups.
+ *
+ * @returns 0 on success, OS specific error code on failure.
+ * @param   pRdr        The file provider instance.
+ * @param   pvBase      The base address of the image mapping.
+ * @param   cSegments   The number of segments in the array pointed to by paSegments.
+ * @param   paSegments  The segments thats going to be mapped.
+ * @param   fUnprotectOrProtect     When set the all mapped segments are made writable.
+ *                                  When clean the segment protection is restored.
+ */
+int kLdrRdrProtect(PKLDRRDR pRdr, void *pvBase, uint32_t cSegments, PCKLDRSEG paSegments, unsigned fUnprotectOrProtect)
+{
+    KLDRRDR_VALIDATE(pRdr);
+    return pRdr->pOps->pfnProtect(pRdr, pvBase, cSegments, paSegments, fUnprotectOrProtect);
+}
+
+
+/**
+ * Unmaps a image mapping.
+ *
+ * @returns 0 on success, OS specific error code on failure.
+ * @param   pRdr        The file provider instance.
+ * @param   pvBase      The base address of the image mapping.
+ * @param   cSegments   The number of segments in the array pointed to by paSegments.
+ * @param   paSegments  The segments thats going to be mapped.
+ */
+int kLdrRdrUnmap(PKLDRRDR pRdr, void *pvBase, uint32_t cSegments, PCKLDRSEG paSegments)
+{
+    KLDRRDR_VALIDATE(pRdr);
+    return pRdr->pOps->pfnUnmap(pRdr, pvBase, cSegments, paSegments);
 }