2 * Win32 virtual memory functions
4 * Copyright 1997 Alexandre Julliard
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.
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.
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
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "wine/port.h"
28 #include <sys/types.h>
33 #define NONAMELESSUNION
34 #define NONAMELESSSTRUCT
36 #define WIN32_NO_STATUS
42 #include "wine/exception.h"
43 #include "wine/debug.h"
45 #include "kernel_private.h"
47 WINE_DECLARE_DEBUG_CHANNEL(seh
);
49 static unsigned int page_size
;
52 /***********************************************************************
53 * VirtualAlloc (KERNEL32.@)
55 * Reserves or commits a region of pages in virtual address space.
58 * addr [I] Address of region to reserve or commit.
59 * size [I] Size of region.
60 * type [I] Type of allocation.
61 * protect [I] Type of access protection.
64 * Success: Base address of allocated region of pages.
67 LPVOID WINAPI
VirtualAlloc( LPVOID addr
, SIZE_T size
, DWORD type
, DWORD protect
)
69 return VirtualAllocEx( GetCurrentProcess(), addr
, size
, type
, protect
);
73 /***********************************************************************
74 * VirtualAllocEx (KERNEL32.@)
76 * Seems to be just as VirtualAlloc, but with process handle.
79 * hProcess [I] Handle to process to do mem operation.
80 * addr [I] Address of region to reserve or commit.
81 * size [I] Size of region.
82 * type [I] Type of allocation.
83 * protect [I] Type of access protection.
87 * Success: Base address of allocated region of pages.
90 LPVOID WINAPI
VirtualAllocEx( HANDLE hProcess
, LPVOID addr
, SIZE_T size
,
91 DWORD type
, DWORD protect
)
96 if ((status
= NtAllocateVirtualMemory( hProcess
, &ret
, 0, &size
, type
, protect
)))
98 SetLastError( RtlNtStatusToDosError(status
) );
105 /***********************************************************************
106 * VirtualFree (KERNEL32.@)
108 * Releases or decommits a region of pages in virtual address space.
111 * addr [I] Address of region of committed pages.
112 * size [I] Size of region.
113 * type [I] Type of operation.
119 BOOL WINAPI
VirtualFree( LPVOID addr
, SIZE_T size
, DWORD type
)
121 return VirtualFreeEx( GetCurrentProcess(), addr
, size
, type
);
125 /***********************************************************************
126 * VirtualFreeEx (KERNEL32.@)
128 * Releases or decommits a region of pages in virtual address space.
131 * process [I] Handle to process.
132 * addr [I] Address of region to free.
133 * size [I] Size of region.
134 * type [I] Type of operation.
140 BOOL WINAPI
VirtualFreeEx( HANDLE process
, LPVOID addr
, SIZE_T size
, DWORD type
)
142 NTSTATUS status
= NtFreeVirtualMemory( process
, &addr
, &size
, type
);
143 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
148 /***********************************************************************
149 * VirtualLock (KERNEL32.@)
151 * Locks the specified region of virtual address space.
154 * addr [I] Address of first byte of range to lock.
155 * size [I] Number of bytes in range to lock.
162 * Always returns TRUE.
165 BOOL WINAPI
VirtualLock( LPVOID addr
, SIZE_T size
)
167 NTSTATUS status
= NtLockVirtualMemory( GetCurrentProcess(), &addr
, &size
, 1 );
168 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
173 /***********************************************************************
174 * VirtualUnlock (KERNEL32.@)
176 * Unlocks a range of pages in the virtual address space.
179 * addr [I] Address of first byte of range.
180 * size [I] Number of bytes in range.
187 * Always returns TRUE.
190 BOOL WINAPI
VirtualUnlock( LPVOID addr
, SIZE_T size
)
192 NTSTATUS status
= NtUnlockVirtualMemory( GetCurrentProcess(), &addr
, &size
, 1 );
193 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
198 /***********************************************************************
199 * VirtualProtect (KERNEL32.@)
201 * Changes the access protection on a region of committed pages.
204 * addr [I] Address of region of committed pages.
205 * size [I] Size of region.
206 * new_prot [I] Desired access protection.
207 * old_prot [O] Address of variable to get old protection.
213 BOOL WINAPI
VirtualProtect( LPVOID addr
, SIZE_T size
, DWORD new_prot
, LPDWORD old_prot
)
215 return VirtualProtectEx( GetCurrentProcess(), addr
, size
, new_prot
, old_prot
);
219 /***********************************************************************
220 * VirtualProtectEx (KERNEL32.@)
222 * Changes the access protection on a region of committed pages in the
223 * virtual address space of a specified process.
226 * process [I] Handle of process.
227 * addr [I] Address of region of committed pages.
228 * size [I] Size of region.
229 * new_prot [I] Desired access protection.
230 * old_prot [O] Address of variable to get old protection.
236 BOOL WINAPI
VirtualProtectEx( HANDLE process
, LPVOID addr
, SIZE_T size
,
237 DWORD new_prot
, LPDWORD old_prot
)
239 NTSTATUS status
= NtProtectVirtualMemory( process
, &addr
, &size
, new_prot
, old_prot
);
240 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
245 /***********************************************************************
246 * VirtualQuery (KERNEL32.@)
248 * Provides info about a range of pages in virtual address space.
251 * addr [I] Address of region.
252 * info [O] Address of info buffer.
253 * len [I] Size of buffer.
256 * Number of bytes returned in information buffer or 0 if
257 * addr >= 0xc0000000 (kernel space).
259 SIZE_T WINAPI
VirtualQuery( LPCVOID addr
, PMEMORY_BASIC_INFORMATION info
,
262 return VirtualQueryEx( GetCurrentProcess(), addr
, info
, len
);
266 /***********************************************************************
267 * VirtualQueryEx (KERNEL32.@)
269 * Provides info about a range of pages in virtual address space of a
273 * process [I] Handle to process.
274 * addr [I] Address of region.
275 * info [O] Address of info buffer.
276 * len [I] Size of buffer.
279 * Number of bytes returned in information buffer.
281 SIZE_T WINAPI
VirtualQueryEx( HANDLE process
, LPCVOID addr
,
282 PMEMORY_BASIC_INFORMATION info
, SIZE_T len
)
287 if ((status
= NtQueryVirtualMemory( process
, addr
, MemoryBasicInformation
, info
, len
, &ret
)))
289 SetLastError( RtlNtStatusToDosError(status
) );
296 /***********************************************************************
297 * CreateFileMappingA (KERNEL32.@)
299 * Creates a named or unnamed file-mapping object for the specified file.
302 * hFile [I] Handle to the file to map.
303 * sa [I] Optional security attributes.
304 * protect [I] Protection for mapping object.
305 * size_high [I] High-order 32 bits of object size.
306 * size_low [I] Low-order 32 bits of object size.
307 * name [I] Name of file-mapping object.
311 * Failure: NULL. Mapping object does not exist.
313 HANDLE WINAPI
CreateFileMappingA( HANDLE hFile
, SECURITY_ATTRIBUTES
*sa
,
314 DWORD protect
, DWORD size_high
, DWORD size_low
, LPCSTR name
)
316 WCHAR buffer
[MAX_PATH
];
318 if (!name
) return CreateFileMappingW( hFile
, sa
, protect
, size_high
, size_low
, NULL
);
320 if (!MultiByteToWideChar( CP_ACP
, 0, name
, -1, buffer
, MAX_PATH
))
322 SetLastError( ERROR_FILENAME_EXCED_RANGE
);
325 return CreateFileMappingW( hFile
, sa
, protect
, size_high
, size_low
, buffer
);
329 /***********************************************************************
330 * CreateFileMappingW (KERNEL32.@)
332 * See CreateFileMappingA.
334 HANDLE WINAPI
CreateFileMappingW( HANDLE hFile
, LPSECURITY_ATTRIBUTES sa
,
335 DWORD protect
, DWORD size_high
,
336 DWORD size_low
, LPCWSTR name
)
338 static const int sec_flags
= SEC_FILE
| SEC_IMAGE
| SEC_RESERVE
| SEC_COMMIT
| SEC_NOCACHE
;
342 DWORD access
, sec_type
;
345 sec_type
= protect
& sec_flags
;
346 protect
&= ~sec_flags
;
347 if (!sec_type
) sec_type
= SEC_COMMIT
;
352 protect
= PAGE_READONLY
; /* Win9x compatibility */
356 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_EXECUTE
;
359 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_WRITE
| SECTION_MAP_EXECUTE
;
362 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_EXECUTE
| SECTION_MAP_EXECUTE_EXPLICIT
;
364 case PAGE_EXECUTE_READ
:
365 case PAGE_EXECUTE_WRITECOPY
:
366 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_EXECUTE
| SECTION_MAP_EXECUTE_EXPLICIT
;
368 case PAGE_EXECUTE_READWRITE
:
369 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_WRITE
| SECTION_MAP_EXECUTE
| SECTION_MAP_EXECUTE_EXPLICIT
;
372 SetLastError( ERROR_INVALID_PARAMETER
);
376 if (hFile
== INVALID_HANDLE_VALUE
)
379 if (!size_low
&& !size_high
)
381 SetLastError( ERROR_INVALID_PARAMETER
);
386 size
.u
.LowPart
= size_low
;
387 size
.u
.HighPart
= size_high
;
391 OBJECT_ATTRIBUTES attr
;
392 UNICODE_STRING nameW
;
394 attr
.Length
= sizeof(attr
);
395 attr
.RootDirectory
= 0;
396 attr
.ObjectName
= NULL
;
397 attr
.Attributes
= OBJ_OPENIF
| ((sa
&& sa
->bInheritHandle
) ? OBJ_INHERIT
: 0);
398 attr
.SecurityDescriptor
= sa
? sa
->lpSecurityDescriptor
: NULL
;
399 attr
.SecurityQualityOfService
= NULL
;
402 RtlInitUnicodeString( &nameW
, name
);
403 attr
.ObjectName
= &nameW
;
404 attr
.RootDirectory
= get_BaseNamedObjects_handle();
406 status
= NtCreateSection( &ret
, access
, &attr
, &size
, protect
, sec_type
, hFile
);
408 else status
= NtCreateSection( &ret
, access
, NULL
, &size
, protect
, sec_type
, hFile
);
410 if (status
== STATUS_OBJECT_NAME_EXISTS
)
411 SetLastError( ERROR_ALREADY_EXISTS
);
413 SetLastError( RtlNtStatusToDosError(status
) );
418 /***********************************************************************
419 * OpenFileMappingA (KERNEL32.@)
421 * Opens a named file-mapping object.
424 * access [I] Access mode.
425 * inherit [I] Inherit flag.
426 * name [I] Name of file-mapping object.
432 HANDLE WINAPI
OpenFileMappingA( DWORD access
, BOOL inherit
, LPCSTR name
)
434 WCHAR buffer
[MAX_PATH
];
436 if (!name
) return OpenFileMappingW( access
, inherit
, NULL
);
438 if (!MultiByteToWideChar( CP_ACP
, 0, name
, -1, buffer
, MAX_PATH
))
440 SetLastError( ERROR_FILENAME_EXCED_RANGE
);
443 return OpenFileMappingW( access
, inherit
, buffer
);
447 /***********************************************************************
448 * OpenFileMappingW (KERNEL32.@)
450 * See OpenFileMappingA.
452 HANDLE WINAPI
OpenFileMappingW( DWORD access
, BOOL inherit
, LPCWSTR name
)
454 OBJECT_ATTRIBUTES attr
;
455 UNICODE_STRING nameW
;
461 SetLastError( ERROR_INVALID_PARAMETER
);
464 attr
.Length
= sizeof(attr
);
465 attr
.RootDirectory
= get_BaseNamedObjects_handle();
466 attr
.ObjectName
= &nameW
;
467 attr
.Attributes
= inherit
? OBJ_INHERIT
: 0;
468 attr
.SecurityDescriptor
= NULL
;
469 attr
.SecurityQualityOfService
= NULL
;
470 RtlInitUnicodeString( &nameW
, name
);
472 if (access
== FILE_MAP_COPY
) access
= SECTION_MAP_READ
;
473 access
|= SECTION_QUERY
;
475 if (GetVersion() & 0x80000000)
477 /* win9x doesn't do access checks, so try with full access first */
478 if (!NtOpenSection( &ret
, access
| SECTION_MAP_READ
| SECTION_MAP_WRITE
, &attr
)) return ret
;
481 if ((status
= NtOpenSection( &ret
, access
, &attr
)))
483 SetLastError( RtlNtStatusToDosError(status
) );
490 /***********************************************************************
491 * MapViewOfFile (KERNEL32.@)
493 * Maps a view of a file into the address space.
496 * mapping [I] File-mapping object to map.
497 * access [I] Access mode.
498 * offset_high [I] High-order 32 bits of file offset.
499 * offset_low [I] Low-order 32 bits of file offset.
500 * count [I] Number of bytes to map.
503 * Success: Starting address of mapped view.
506 LPVOID WINAPI
MapViewOfFile( HANDLE mapping
, DWORD access
,
507 DWORD offset_high
, DWORD offset_low
, SIZE_T count
)
509 return MapViewOfFileEx( mapping
, access
, offset_high
,
510 offset_low
, count
, NULL
);
514 /***********************************************************************
515 * MapViewOfFileEx (KERNEL32.@)
517 * Maps a view of a file into the address space.
520 * handle [I] File-mapping object to map.
521 * access [I] Access mode.
522 * offset_high [I] High-order 32 bits of file offset.
523 * offset_low [I] Low-order 32 bits of file offset.
524 * count [I] Number of bytes to map.
525 * addr [I] Suggested starting address for mapped view.
528 * Success: Starting address of mapped view.
531 LPVOID WINAPI
MapViewOfFileEx( HANDLE handle
, DWORD access
,
532 DWORD offset_high
, DWORD offset_low
, SIZE_T count
, LPVOID addr
)
535 LARGE_INTEGER offset
;
538 offset
.u
.LowPart
= offset_low
;
539 offset
.u
.HighPart
= offset_high
;
541 if (access
& FILE_MAP_WRITE
) protect
= PAGE_READWRITE
;
542 else if (access
& FILE_MAP_READ
) protect
= PAGE_READONLY
;
543 else if (access
& FILE_MAP_COPY
) protect
= PAGE_WRITECOPY
;
544 else protect
= PAGE_NOACCESS
;
546 if (access
& FILE_MAP_EXECUTE
) protect
<<= 4;
548 if ((status
= NtMapViewOfSection( handle
, GetCurrentProcess(), &addr
, 0, 0, &offset
,
549 &count
, ViewShare
, 0, protect
)))
551 SetLastError( RtlNtStatusToDosError(status
) );
558 /***********************************************************************
559 * UnmapViewOfFile (KERNEL32.@)
561 * Unmaps a mapped view of a file.
564 * addr [I] Address where mapped view begins.
571 BOOL WINAPI
UnmapViewOfFile( LPCVOID addr
)
573 NTSTATUS status
= NtUnmapViewOfSection( GetCurrentProcess(), (void *)addr
);
574 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
579 /***********************************************************************
580 * FlushViewOfFile (KERNEL32.@)
582 * Writes to the disk a byte range within a mapped view of a file.
585 * base [I] Start address of byte range to flush.
586 * size [I] Number of bytes in range.
592 BOOL WINAPI
FlushViewOfFile( LPCVOID base
, SIZE_T size
)
594 NTSTATUS status
= NtFlushVirtualMemory( GetCurrentProcess(), &base
, &size
, 0 );
597 if (status
== STATUS_NOT_MAPPED_DATA
) status
= STATUS_SUCCESS
;
598 else SetLastError( RtlNtStatusToDosError(status
) );
604 /***********************************************************************
605 * GetWriteWatch (KERNEL32.@)
607 UINT WINAPI
GetWriteWatch( DWORD flags
, LPVOID base
, SIZE_T size
, LPVOID
*addresses
,
608 ULONG_PTR
*count
, ULONG
*granularity
)
612 status
= NtGetWriteWatch( GetCurrentProcess(), flags
, base
, size
, addresses
, count
, granularity
);
613 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
614 return status
? ~0u : 0;
618 /***********************************************************************
619 * ResetWriteWatch (KERNEL32.@)
621 UINT WINAPI
ResetWriteWatch( LPVOID base
, SIZE_T size
)
625 status
= NtResetWriteWatch( GetCurrentProcess(), base
, size
);
626 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
627 return status
? ~0u : 0;
631 /***********************************************************************
632 * IsBadReadPtr (KERNEL32.@)
634 * Check for read access on a memory block.
636 * ptr [I] Address of memory block.
637 * size [I] Size of block.
641 * Failure: FALSE. Process has read access to entire block.
643 BOOL WINAPI
IsBadReadPtr( LPCVOID ptr
, UINT size
)
645 if (!size
) return FALSE
; /* handle 0 size case w/o reference */
646 if (!ptr
) return TRUE
;
648 if (!page_size
) page_size
= getpagesize();
651 volatile const char *p
= ptr
;
655 while (count
> page_size
)
662 dummy
= p
[count
- 1];
666 TRACE_(seh
)("%p caused page fault during read\n", ptr
);
674 /***********************************************************************
675 * IsBadWritePtr (KERNEL32.@)
677 * Check for write access on a memory block.
680 * ptr [I] Address of memory block.
681 * size [I] Size of block in bytes.
685 * Failure: FALSE. Process has write access to entire block.
687 BOOL WINAPI
IsBadWritePtr( LPVOID ptr
, UINT size
)
689 if (!size
) return FALSE
; /* handle 0 size case w/o reference */
690 if (!ptr
) return TRUE
;
692 if (!page_size
) page_size
= getpagesize();
695 volatile char *p
= ptr
;
698 while (count
> page_size
)
709 TRACE_(seh
)("%p caused page fault during write\n", ptr
);
717 /***********************************************************************
718 * IsBadHugeReadPtr (KERNEL32.@)
720 * Check for read access on a memory block.
723 * ptr [I] Address of memory block.
724 * size [I] Size of block.
728 * Failure: FALSE. Process has read access to entire block.
730 BOOL WINAPI
IsBadHugeReadPtr( LPCVOID ptr
, UINT size
)
732 return IsBadReadPtr( ptr
, size
);
736 /***********************************************************************
737 * IsBadHugeWritePtr (KERNEL32.@)
739 * Check for write access on a memory block.
742 * ptr [I] Address of memory block.
743 * size [I] Size of block.
747 * Failure: FALSE. Process has write access to entire block.
749 BOOL WINAPI
IsBadHugeWritePtr( LPVOID ptr
, UINT size
)
751 return IsBadWritePtr( ptr
, size
);
755 /***********************************************************************
756 * IsBadCodePtr (KERNEL32.@)
758 * Check for read access on a memory address.
761 * ptr [I] Address of function.
765 * Failure: FALSE. Process has read access to specified memory.
767 BOOL WINAPI
IsBadCodePtr( FARPROC ptr
)
769 return IsBadReadPtr( ptr
, 1 );
773 /***********************************************************************
774 * IsBadStringPtrA (KERNEL32.@)
776 * Check for read access on a range of memory pointed to by a string pointer.
779 * str [I] Address of string.
780 * max [I] Maximum size of string.
784 * Failure: FALSE. Read access to all bytes in string.
786 BOOL WINAPI
IsBadStringPtrA( LPCSTR str
, UINT max
)
788 if (!str
) return TRUE
;
792 volatile const char *p
= str
;
793 while (p
!= str
+ max
) if (!*p
++) break;
797 TRACE_(seh
)("%p caused page fault during read\n", str
);
805 /***********************************************************************
806 * IsBadStringPtrW (KERNEL32.@)
808 * See IsBadStringPtrA.
810 BOOL WINAPI
IsBadStringPtrW( LPCWSTR str
, UINT max
)
812 if (!str
) return TRUE
;
816 volatile const WCHAR
*p
= str
;
817 while (p
!= str
+ max
) if (!*p
++) break;
821 TRACE_(seh
)("%p caused page fault during read\n", str
);