blob: 009d6f724697007435607fe458d864c7d3ea2906 [file] [log] [blame]
Patrik Stridvall091e7851998-10-11 17:04:17 +00001/*
2 * IMAGEHLP library
3 *
4 * Copyright 1998 Patrik Stridvall
Alexandre Julliard0799c1a2002-03-09 23:29:33 +00005 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
Jonathan Ernst360a3f92006-05-18 14:49:52 +020018 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
Patrik Stridvall091e7851998-10-11 17:04:17 +000019 */
20
Alexandre Julliarde37c6e12003-09-05 23:08:26 +000021#include <stdarg.h>
James Juranf4d5fef2001-01-26 20:43:40 +000022#include <string.h>
Alexandre Julliarde37c6e12003-09-05 23:08:26 +000023#include "windef.h"
Patrik Stridvall091e7851998-10-11 17:04:17 +000024#include "winbase.h"
25#include "winnt.h"
Marcus R. Brown76fc4172003-11-21 21:31:35 +000026#include "winternl.h"
Patrik Stridvall091e7851998-10-11 17:04:17 +000027#include "winerror.h"
Alexandre Julliard0799c1a2002-03-09 23:29:33 +000028#include "wine/debug.h"
Patrik Stridvall091e7851998-10-11 17:04:17 +000029#include "imagehlp.h"
30
Alexandre Julliard0799c1a2002-03-09 23:29:33 +000031WINE_DEFAULT_DEBUG_CHANNEL(imagehlp);
Patrik Stridvallb4b9fae1999-04-19 14:56:29 +000032
Patrik Stridvall091e7851998-10-11 17:04:17 +000033/***********************************************************************
34 * Data
35 */
36
Alexandre Julliarda3960291999-02-26 11:11:13 +000037static PLOADED_IMAGE IMAGEHLP_pFirstLoadedImage=NULL;
38static PLOADED_IMAGE IMAGEHLP_pLastLoadedImage=NULL;
Patrik Stridvall091e7851998-10-11 17:04:17 +000039
Alexandre Julliarda3960291999-02-26 11:11:13 +000040static LOADED_IMAGE IMAGEHLP_EmptyLoadedImage = {
Patrik Stridvall091e7851998-10-11 17:04:17 +000041 NULL, /* ModuleName */
Alexandre Julliard613ead72002-10-04 00:27:10 +000042 0, /* hFile */
Patrik Stridvall091e7851998-10-11 17:04:17 +000043 NULL, /* MappedAddress */
44 NULL, /* FileHeader */
45 NULL, /* LastRvaSection */
46 0, /* NumberOfSections */
47 NULL, /* Sections */
48 1, /* Characteristics */
49 FALSE, /* fSystemImage */
50 FALSE, /* fDOSImage */
Francois Gouget7a70f9f2007-08-03 00:49:50 +020051 FALSE, /* fReadOnly */
52 0, /* Version */
Alexandre Julliarda3960291999-02-26 11:11:13 +000053 { &IMAGEHLP_EmptyLoadedImage.Links, &IMAGEHLP_EmptyLoadedImage.Links }, /* Links */
Patrik Stridvall091e7851998-10-11 17:04:17 +000054 148, /* SizeOfImage; */
55};
56
Alexandre Julliard0643acd2003-06-27 22:24:23 +000057extern HANDLE IMAGEHLP_hHeap;
58
Patrik Stridvall091e7851998-10-11 17:04:17 +000059/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +000060 * GetImageConfigInformation (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +000061 */
Alexandre Julliarda3960291999-02-26 11:11:13 +000062BOOL WINAPI GetImageConfigInformation(
63 PLOADED_IMAGE LoadedImage,
64 PIMAGE_LOAD_CONFIG_DIRECTORY ImageConfigInformation)
Patrik Stridvall091e7851998-10-11 17:04:17 +000065{
Alexandre Julliard9fe7a251999-05-14 08:17:14 +000066 FIXME("(%p, %p): stub\n",
Patrik Stridvall091e7851998-10-11 17:04:17 +000067 LoadedImage, ImageConfigInformation
68 );
69 SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
70 return FALSE;
71}
72
73/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +000074 * GetImageUnusedHeaderBytes (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +000075 */
Alexandre Julliarda3960291999-02-26 11:11:13 +000076DWORD WINAPI GetImageUnusedHeaderBytes(
77 PLOADED_IMAGE LoadedImage,
Patrik Stridvall091e7851998-10-11 17:04:17 +000078 LPDWORD SizeUnusedHeaderBytes)
79{
Alexandre Julliard9fe7a251999-05-14 08:17:14 +000080 FIXME("(%p, %p): stub\n",
Patrik Stridvall091e7851998-10-11 17:04:17 +000081 LoadedImage, SizeUnusedHeaderBytes
82 );
83 SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
84 return 0;
85}
86
87/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +000088 * ImageLoad (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +000089 */
Francois Gougetb86570d2007-08-04 03:15:44 +020090PLOADED_IMAGE WINAPI ImageLoad(PCSTR DllName, PCSTR DllPath)
Patrik Stridvall091e7851998-10-11 17:04:17 +000091{
Christian Costa9650db42003-08-19 00:57:29 +000092 PLOADED_IMAGE pLoadedImage;
93
94 FIXME("(%s, %s): stub\n", DllName, DllPath);
95
96 pLoadedImage = HeapAlloc(IMAGEHLP_hHeap, 0, sizeof(LOADED_IMAGE));
97 if (pLoadedImage)
98 pLoadedImage->FileHeader = HeapAlloc(IMAGEHLP_hHeap, 0, sizeof(IMAGE_NT_HEADERS));
99
Patrik Stridvall091e7851998-10-11 17:04:17 +0000100 return pLoadedImage;
101}
102
103/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +0000104 * ImageUnload (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000105 */
Alexandre Julliarda3960291999-02-26 11:11:13 +0000106BOOL WINAPI ImageUnload(PLOADED_IMAGE pLoadedImage)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000107{
Alexandre Julliarda3960291999-02-26 11:11:13 +0000108 LIST_ENTRY *pCurrent, *pFind;
Christian Costa9650db42003-08-19 00:57:29 +0000109
110 TRACE("(%p)\n", pLoadedImage);
111
Alexandre Julliarda3960291999-02-26 11:11:13 +0000112 if(!IMAGEHLP_pFirstLoadedImage || !pLoadedImage)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000113 {
114 /* No image loaded or null pointer */
115 SetLastError(ERROR_INVALID_PARAMETER);
116 return FALSE;
117 }
118
119 pFind=&pLoadedImage->Links;
Alexandre Julliarda3960291999-02-26 11:11:13 +0000120 pCurrent=&IMAGEHLP_pFirstLoadedImage->Links;
Vincent BĂ©ron9a624912002-05-31 23:06:46 +0000121 while((pCurrent != pFind) &&
122 (pCurrent != NULL))
Patrik Stridvall091e7851998-10-11 17:04:17 +0000123 pCurrent = pCurrent->Flink;
124 if(!pCurrent)
125 {
126 /* Not found */
127 SetLastError(ERROR_INVALID_PARAMETER);
128 return FALSE;
129 }
130
131 if(pCurrent->Blink)
132 pCurrent->Blink->Flink = pCurrent->Flink;
133 else
Alexandre Julliarda3960291999-02-26 11:11:13 +0000134 IMAGEHLP_pFirstLoadedImage = pCurrent->Flink?CONTAINING_RECORD(
135 pCurrent->Flink, LOADED_IMAGE, Links):NULL;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000136
137 if(pCurrent->Flink)
138 pCurrent->Flink->Blink = pCurrent->Blink;
139 else
Alexandre Julliarda3960291999-02-26 11:11:13 +0000140 IMAGEHLP_pLastLoadedImage = pCurrent->Blink?CONTAINING_RECORD(
141 pCurrent->Blink, LOADED_IMAGE, Links):NULL;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000142
143 return FALSE;
144}
145
146/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +0000147 * MapAndLoad (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000148 */
Francois Gougetb86570d2007-08-04 03:15:44 +0200149BOOL WINAPI MapAndLoad(PCSTR pszImageName, PCSTR pszDllPath, PLOADED_IMAGE pLoadedImage,
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100150 BOOL bDotDll, BOOL bReadOnly)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000151{
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100152 CHAR szFileName[MAX_PATH];
153 HANDLE hFile = INVALID_HANDLE_VALUE;
154 HANDLE hFileMapping = NULL;
155 PVOID mapping = NULL;
156 PIMAGE_NT_HEADERS pNtHeader = NULL;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000157
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100158 TRACE("(%s, %s, %p, %d, %d)\n",
159 pszImageName, pszDllPath, pLoadedImage, bDotDll, bReadOnly);
Patrik Stridvall091e7851998-10-11 17:04:17 +0000160
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100161 if (!SearchPathA(pszDllPath, pszImageName, bDotDll ? ".DLL" : ".EXE",
162 sizeof(szFileName), szFileName, NULL))
Patrik Stridvall091e7851998-10-11 17:04:17 +0000163 {
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100164 SetLastError(ERROR_FILE_NOT_FOUND);
165 goto Error;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000166 }
167
Eric Pouech2d6e9142007-01-03 14:39:33 +0100168 hFile = CreateFileA(szFileName,
169 GENERIC_READ | (bReadOnly ? 0 : GENERIC_WRITE),
170 FILE_SHARE_READ,
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100171 NULL, OPEN_EXISTING, 0, NULL);
172 if (hFile == INVALID_HANDLE_VALUE)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000173 {
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100174 WARN("CreateFile: Error = %d\n", GetLastError());
175 goto Error;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000176 }
177
Eric Pouech2d6e9142007-01-03 14:39:33 +0100178 hFileMapping = CreateFileMappingA(hFile, NULL,
179 (bReadOnly ? PAGE_READONLY : PAGE_READWRITE) | SEC_COMMIT,
180 0, 0, NULL);
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100181 if (!hFileMapping)
182 {
183 WARN("CreateFileMapping: Error = %d\n", GetLastError());
184 goto Error;
185 }
Patrik Stridvall091e7851998-10-11 17:04:17 +0000186
Eric Pouech2d6e9142007-01-03 14:39:33 +0100187 mapping = MapViewOfFile(hFileMapping, bReadOnly ? FILE_MAP_READ : FILE_MAP_WRITE, 0, 0, 0);
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100188 CloseHandle(hFileMapping);
189 if (!mapping)
190 {
191 WARN("MapViewOfFile: Error = %d\n", GetLastError());
192 goto Error;
193 }
Patrik Stridvall091e7851998-10-11 17:04:17 +0000194
Eric Pouech4950d3d2007-01-03 14:39:33 +0100195 if (!(pNtHeader = RtlImageNtHeader(mapping)))
196 {
197 WARN("Not an NT header\n");
198 UnmapViewOfFile(mapping);
199 goto Error;
200 }
Patrik Stridvall091e7851998-10-11 17:04:17 +0000201
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100202 pLoadedImage->ModuleName = HeapAlloc(GetProcessHeap(), 0,
203 strlen(szFileName) + 1);
204 if (pLoadedImage->ModuleName) strcpy(pLoadedImage->ModuleName, szFileName);
205 pLoadedImage->hFile = hFile;
206 pLoadedImage->MappedAddress = mapping;
207 pLoadedImage->FileHeader = pNtHeader;
208 pLoadedImage->Sections = (PIMAGE_SECTION_HEADER)
209 ((LPBYTE) &pNtHeader->OptionalHeader +
210 pNtHeader->FileHeader.SizeOfOptionalHeader);
211 pLoadedImage->NumberOfSections = pNtHeader->FileHeader.NumberOfSections;
Eric Pouech5dbb2512007-01-03 14:39:33 +0100212 pLoadedImage->SizeOfImage = GetFileSize(hFile, NULL);
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100213 pLoadedImage->Characteristics = pNtHeader->FileHeader.Characteristics;
214 pLoadedImage->LastRvaSection = pLoadedImage->Sections;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000215
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100216 pLoadedImage->fSystemImage = FALSE; /* FIXME */
217 pLoadedImage->fDOSImage = FALSE; /* FIXME */
Patrik Stridvall091e7851998-10-11 17:04:17 +0000218
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100219 pLoadedImage->Links.Flink = &pLoadedImage->Links;
220 pLoadedImage->Links.Blink = &pLoadedImage->Links;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000221
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100222 return TRUE;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000223
224Error:
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100225 if (hFile != INVALID_HANDLE_VALUE) CloseHandle(hFile);
226 return FALSE;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000227}
228
229/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +0000230 * SetImageConfigInformation (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000231 */
Alexandre Julliarda3960291999-02-26 11:11:13 +0000232BOOL WINAPI SetImageConfigInformation(
233 PLOADED_IMAGE LoadedImage,
234 PIMAGE_LOAD_CONFIG_DIRECTORY ImageConfigInformation)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000235{
Alexandre Julliard9fe7a251999-05-14 08:17:14 +0000236 FIXME("(%p, %p): stub\n",
Patrik Stridvall091e7851998-10-11 17:04:17 +0000237 LoadedImage, ImageConfigInformation
238 );
239 SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
240 return FALSE;
241}
242
243/***********************************************************************
Patrik Stridvall2d6457c2000-03-28 20:22:59 +0000244 * UnMapAndLoad (IMAGEHLP.@)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000245 */
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100246BOOL WINAPI UnMapAndLoad(PLOADED_IMAGE pLoadedImage)
Patrik Stridvall091e7851998-10-11 17:04:17 +0000247{
Eric Pouech8ca3ca52006-12-01 21:56:31 +0100248 HeapFree(GetProcessHeap(), 0, pLoadedImage->ModuleName);
249 /* FIXME: MSDN states that a new checksum is computed and stored into the file */
250 if (pLoadedImage->MappedAddress) UnmapViewOfFile(pLoadedImage->MappedAddress);
251 if (pLoadedImage->hFile != INVALID_HANDLE_VALUE) CloseHandle(pLoadedImage->hFile);
252 return TRUE;
Patrik Stridvall091e7851998-10-11 17:04:17 +0000253}