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
43 #include "wine/exception.h"
44 #include "wine/debug.h"
46 #include "kernel_private.h"
48 WINE_DECLARE_DEBUG_CHANNEL(seh
);
49 WINE_DECLARE_DEBUG_CHANNEL(file
);
51 static unsigned int page_size
;
54 /***********************************************************************
55 * VirtualAlloc (KERNEL32.@)
57 * Reserves or commits a region of pages in virtual address space.
60 * addr [I] Address of region to reserve or commit.
61 * size [I] Size of region.
62 * type [I] Type of allocation.
63 * protect [I] Type of access protection.
66 * Success: Base address of allocated region of pages.
69 LPVOID WINAPI
VirtualAlloc( LPVOID addr
, SIZE_T size
, DWORD type
, DWORD protect
)
71 return VirtualAllocEx( GetCurrentProcess(), addr
, size
, type
, protect
);
75 /***********************************************************************
76 * VirtualAllocEx (KERNEL32.@)
78 * Seems to be just as VirtualAlloc, but with process handle.
81 * hProcess [I] Handle to process to do mem operation.
82 * addr [I] Address of region to reserve or commit.
83 * size [I] Size of region.
84 * type [I] Type of allocation.
85 * protect [I] Type of access protection.
89 * Success: Base address of allocated region of pages.
92 LPVOID WINAPI
VirtualAllocEx( HANDLE hProcess
, LPVOID addr
, SIZE_T size
,
93 DWORD type
, DWORD protect
)
98 if ((status
= NtAllocateVirtualMemory( hProcess
, &ret
, 0, &size
, type
, protect
)))
100 SetLastError( RtlNtStatusToDosError(status
) );
107 /***********************************************************************
108 * VirtualFree (KERNEL32.@)
110 * Releases or decommits a region of pages in virtual address space.
113 * addr [I] Address of region of committed pages.
114 * size [I] Size of region.
115 * type [I] Type of operation.
121 BOOL WINAPI
VirtualFree( LPVOID addr
, SIZE_T size
, DWORD type
)
123 return VirtualFreeEx( GetCurrentProcess(), addr
, size
, type
);
127 /***********************************************************************
128 * VirtualFreeEx (KERNEL32.@)
130 * Releases or decommits a region of pages in virtual address space.
133 * process [I] Handle to process.
134 * addr [I] Address of region to free.
135 * size [I] Size of region.
136 * type [I] Type of operation.
142 BOOL WINAPI
VirtualFreeEx( HANDLE process
, LPVOID addr
, SIZE_T size
, DWORD type
)
144 NTSTATUS status
= NtFreeVirtualMemory( process
, &addr
, &size
, type
);
145 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
150 /***********************************************************************
151 * VirtualLock (KERNEL32.@)
153 * Locks the specified region of virtual address space.
156 * addr [I] Address of first byte of range to lock.
157 * size [I] Number of bytes in range to lock.
164 * Always returns TRUE.
167 BOOL WINAPI
VirtualLock( LPVOID addr
, SIZE_T size
)
169 NTSTATUS status
= NtLockVirtualMemory( GetCurrentProcess(), &addr
, &size
, 1 );
170 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
175 /***********************************************************************
176 * VirtualUnlock (KERNEL32.@)
178 * Unlocks a range of pages in the virtual address space.
181 * addr [I] Address of first byte of range.
182 * size [I] Number of bytes in range.
189 * Always returns TRUE.
192 BOOL WINAPI
VirtualUnlock( LPVOID addr
, SIZE_T size
)
194 NTSTATUS status
= NtUnlockVirtualMemory( GetCurrentProcess(), &addr
, &size
, 1 );
195 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
200 /***********************************************************************
201 * VirtualProtect (KERNEL32.@)
203 * Changes the access protection on a region of committed pages.
206 * addr [I] Address of region of committed pages.
207 * size [I] Size of region.
208 * new_prot [I] Desired access protection.
209 * old_prot [O] Address of variable to get old protection.
215 BOOL WINAPI
VirtualProtect( LPVOID addr
, SIZE_T size
, DWORD new_prot
, LPDWORD old_prot
)
217 return VirtualProtectEx( GetCurrentProcess(), addr
, size
, new_prot
, old_prot
);
221 /***********************************************************************
222 * VirtualProtectEx (KERNEL32.@)
224 * Changes the access protection on a region of committed pages in the
225 * virtual address space of a specified process.
228 * process [I] Handle of process.
229 * addr [I] Address of region of committed pages.
230 * size [I] Size of region.
231 * new_prot [I] Desired access protection.
232 * old_prot [O] Address of variable to get old protection.
238 BOOL WINAPI
VirtualProtectEx( HANDLE process
, LPVOID addr
, SIZE_T size
,
239 DWORD new_prot
, LPDWORD old_prot
)
241 NTSTATUS status
= NtProtectVirtualMemory( process
, &addr
, &size
, new_prot
, old_prot
);
242 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
247 /***********************************************************************
248 * VirtualQuery (KERNEL32.@)
250 * Provides info about a range of pages in virtual address space.
253 * addr [I] Address of region.
254 * info [O] Address of info buffer.
255 * len [I] Size of buffer.
258 * Number of bytes returned in information buffer or 0 if
259 * addr >= 0xc0000000 (kernel space).
261 SIZE_T WINAPI
VirtualQuery( LPCVOID addr
, PMEMORY_BASIC_INFORMATION info
,
264 return VirtualQueryEx( GetCurrentProcess(), addr
, info
, len
);
268 /***********************************************************************
269 * VirtualQueryEx (KERNEL32.@)
271 * Provides info about a range of pages in virtual address space of a
275 * process [I] Handle to process.
276 * addr [I] Address of region.
277 * info [O] Address of info buffer.
278 * len [I] Size of buffer.
281 * Number of bytes returned in information buffer.
283 SIZE_T WINAPI
VirtualQueryEx( HANDLE process
, LPCVOID addr
,
284 PMEMORY_BASIC_INFORMATION info
, SIZE_T len
)
289 if ((status
= NtQueryVirtualMemory( process
, addr
, MemoryBasicInformation
, info
, len
, &ret
)))
291 SetLastError( RtlNtStatusToDosError(status
) );
298 /***********************************************************************
299 * CreateFileMappingA (KERNEL32.@)
301 * Creates a named or unnamed file-mapping object for the specified file.
304 * hFile [I] Handle to the file to map.
305 * sa [I] Optional security attributes.
306 * protect [I] Protection for mapping object.
307 * size_high [I] High-order 32 bits of object size.
308 * size_low [I] Low-order 32 bits of object size.
309 * name [I] Name of file-mapping object.
313 * Failure: NULL. Mapping object does not exist.
315 HANDLE WINAPI
CreateFileMappingA( HANDLE hFile
, SECURITY_ATTRIBUTES
*sa
,
316 DWORD protect
, DWORD size_high
, DWORD size_low
, LPCSTR name
)
318 WCHAR buffer
[MAX_PATH
];
320 if (!name
) return CreateFileMappingW( hFile
, sa
, protect
, size_high
, size_low
, NULL
);
322 if (!MultiByteToWideChar( CP_ACP
, 0, name
, -1, buffer
, MAX_PATH
))
324 SetLastError( ERROR_FILENAME_EXCED_RANGE
);
327 return CreateFileMappingW( hFile
, sa
, protect
, size_high
, size_low
, buffer
);
331 /***********************************************************************
332 * CreateFileMappingW (KERNEL32.@)
334 * See CreateFileMappingA.
336 HANDLE WINAPI
CreateFileMappingW( HANDLE hFile
, LPSECURITY_ATTRIBUTES sa
,
337 DWORD protect
, DWORD size_high
,
338 DWORD size_low
, LPCWSTR name
)
340 static const int sec_flags
= SEC_FILE
| SEC_IMAGE
| SEC_RESERVE
| SEC_COMMIT
| SEC_NOCACHE
;
344 DWORD access
, sec_type
;
347 sec_type
= protect
& sec_flags
;
348 protect
&= ~sec_flags
;
349 if (!sec_type
) sec_type
= SEC_COMMIT
;
351 /* Win9x compatibility */
352 if (!protect
&& (GetVersion() & 0x80000000)) protect
= PAGE_READONLY
;
358 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_EXECUTE
;
361 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_WRITE
| SECTION_MAP_EXECUTE
;
363 case PAGE_EXECUTE_READ
:
364 case PAGE_EXECUTE_WRITECOPY
:
365 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_EXECUTE
| SECTION_MAP_EXECUTE_EXPLICIT
;
367 case PAGE_EXECUTE_READWRITE
:
368 access
= STANDARD_RIGHTS_REQUIRED
| SECTION_QUERY
| SECTION_MAP_READ
| SECTION_MAP_WRITE
| SECTION_MAP_EXECUTE
| SECTION_MAP_EXECUTE_EXPLICIT
;
371 SetLastError( ERROR_INVALID_PARAMETER
);
375 if (hFile
== INVALID_HANDLE_VALUE
)
378 if (!size_low
&& !size_high
)
380 SetLastError( ERROR_INVALID_PARAMETER
);
385 size
.u
.LowPart
= size_low
;
386 size
.u
.HighPart
= size_high
;
390 OBJECT_ATTRIBUTES attr
;
391 UNICODE_STRING nameW
;
393 attr
.Length
= sizeof(attr
);
394 attr
.RootDirectory
= 0;
395 attr
.ObjectName
= NULL
;
396 attr
.Attributes
= OBJ_OPENIF
| ((sa
&& sa
->bInheritHandle
) ? OBJ_INHERIT
: 0);
397 attr
.SecurityDescriptor
= sa
? sa
->lpSecurityDescriptor
: NULL
;
398 attr
.SecurityQualityOfService
= NULL
;
401 RtlInitUnicodeString( &nameW
, name
);
402 attr
.ObjectName
= &nameW
;
403 attr
.RootDirectory
= get_BaseNamedObjects_handle();
405 status
= NtCreateSection( &ret
, access
, &attr
, &size
, protect
, sec_type
, hFile
);
407 else status
= NtCreateSection( &ret
, access
, NULL
, &size
, protect
, sec_type
, hFile
);
409 if (status
== STATUS_OBJECT_NAME_EXISTS
)
410 SetLastError( ERROR_ALREADY_EXISTS
);
412 SetLastError( RtlNtStatusToDosError(status
) );
417 /***********************************************************************
418 * OpenFileMappingA (KERNEL32.@)
420 * Opens a named file-mapping object.
423 * access [I] Access mode.
424 * inherit [I] Inherit flag.
425 * name [I] Name of file-mapping object.
431 HANDLE WINAPI
OpenFileMappingA( DWORD access
, BOOL inherit
, LPCSTR name
)
433 WCHAR buffer
[MAX_PATH
];
435 if (!name
) return OpenFileMappingW( access
, inherit
, NULL
);
437 if (!MultiByteToWideChar( CP_ACP
, 0, name
, -1, buffer
, MAX_PATH
))
439 SetLastError( ERROR_FILENAME_EXCED_RANGE
);
442 return OpenFileMappingW( access
, inherit
, buffer
);
446 /***********************************************************************
447 * OpenFileMappingW (KERNEL32.@)
449 * See OpenFileMappingA.
451 HANDLE WINAPI
OpenFileMappingW( DWORD access
, BOOL inherit
, LPCWSTR name
)
453 OBJECT_ATTRIBUTES attr
;
454 UNICODE_STRING nameW
;
460 SetLastError( ERROR_INVALID_PARAMETER
);
463 attr
.Length
= sizeof(attr
);
464 attr
.RootDirectory
= get_BaseNamedObjects_handle();
465 attr
.ObjectName
= &nameW
;
466 attr
.Attributes
= inherit
? OBJ_INHERIT
: 0;
467 attr
.SecurityDescriptor
= NULL
;
468 attr
.SecurityQualityOfService
= NULL
;
469 RtlInitUnicodeString( &nameW
, name
);
471 if (access
== FILE_MAP_COPY
) access
= SECTION_MAP_READ
;
472 access
|= SECTION_QUERY
;
474 if (GetVersion() & 0x80000000)
476 /* win9x doesn't do access checks, so try with full access first */
477 if (!NtOpenSection( &ret
, access
| SECTION_MAP_READ
| SECTION_MAP_WRITE
, &attr
)) return ret
;
480 if ((status
= NtOpenSection( &ret
, access
, &attr
)))
482 SetLastError( RtlNtStatusToDosError(status
) );
489 /***********************************************************************
490 * MapViewOfFile (KERNEL32.@)
492 * Maps a view of a file into the address space.
495 * mapping [I] File-mapping object to map.
496 * access [I] Access mode.
497 * offset_high [I] High-order 32 bits of file offset.
498 * offset_low [I] Low-order 32 bits of file offset.
499 * count [I] Number of bytes to map.
502 * Success: Starting address of mapped view.
505 LPVOID WINAPI
MapViewOfFile( HANDLE mapping
, DWORD access
,
506 DWORD offset_high
, DWORD offset_low
, SIZE_T count
)
508 return MapViewOfFileEx( mapping
, access
, offset_high
,
509 offset_low
, count
, NULL
);
513 /***********************************************************************
514 * MapViewOfFileEx (KERNEL32.@)
516 * Maps a view of a file into the address space.
519 * handle [I] File-mapping object to map.
520 * access [I] Access mode.
521 * offset_high [I] High-order 32 bits of file offset.
522 * offset_low [I] Low-order 32 bits of file offset.
523 * count [I] Number of bytes to map.
524 * addr [I] Suggested starting address for mapped view.
527 * Success: Starting address of mapped view.
530 LPVOID WINAPI
MapViewOfFileEx( HANDLE handle
, DWORD access
,
531 DWORD offset_high
, DWORD offset_low
, SIZE_T count
, LPVOID addr
)
534 LARGE_INTEGER offset
;
537 offset
.u
.LowPart
= offset_low
;
538 offset
.u
.HighPart
= offset_high
;
540 if (access
& FILE_MAP_WRITE
) protect
= PAGE_READWRITE
;
541 else if (access
& FILE_MAP_COPY
) protect
= PAGE_WRITECOPY
;
542 else protect
= PAGE_READONLY
;
544 if (access
& FILE_MAP_EXECUTE
) protect
<<= 4;
546 if ((status
= NtMapViewOfSection( handle
, GetCurrentProcess(), &addr
, 0, 0, &offset
,
547 &count
, ViewShare
, 0, protect
)) < 0)
549 SetLastError( RtlNtStatusToDosError(status
) );
556 /***********************************************************************
557 * UnmapViewOfFile (KERNEL32.@)
559 * Unmaps a mapped view of a file.
562 * addr [I] Address where mapped view begins.
569 BOOL WINAPI
UnmapViewOfFile( LPCVOID addr
)
571 NTSTATUS status
= NtUnmapViewOfSection( GetCurrentProcess(), (void *)addr
);
572 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
577 /***********************************************************************
578 * FlushViewOfFile (KERNEL32.@)
580 * Writes to the disk a byte range within a mapped view of a file.
583 * base [I] Start address of byte range to flush.
584 * size [I] Number of bytes in range.
590 BOOL WINAPI
FlushViewOfFile( LPCVOID base
, SIZE_T size
)
592 NTSTATUS status
= NtFlushVirtualMemory( GetCurrentProcess(), &base
, &size
, 0 );
595 if (status
== STATUS_NOT_MAPPED_DATA
) status
= STATUS_SUCCESS
;
596 else SetLastError( RtlNtStatusToDosError(status
) );
602 /***********************************************************************
603 * GetWriteWatch (KERNEL32.@)
605 UINT WINAPI
GetWriteWatch( DWORD flags
, LPVOID base
, SIZE_T size
, LPVOID
*addresses
,
606 ULONG_PTR
*count
, ULONG
*granularity
)
610 status
= NtGetWriteWatch( GetCurrentProcess(), flags
, base
, size
, addresses
, count
, granularity
);
611 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
612 return status
? ~0u : 0;
616 /***********************************************************************
617 * ResetWriteWatch (KERNEL32.@)
619 UINT WINAPI
ResetWriteWatch( LPVOID base
, SIZE_T size
)
623 status
= NtResetWriteWatch( GetCurrentProcess(), base
, size
);
624 if (status
) SetLastError( RtlNtStatusToDosError(status
) );
625 return status
? ~0u : 0;
629 /***********************************************************************
630 * IsBadReadPtr (KERNEL32.@)
632 * Check for read access on a memory block.
634 * ptr [I] Address of memory block.
635 * size [I] Size of block.
639 * Failure: FALSE. Process has read access to entire block.
641 BOOL WINAPI
IsBadReadPtr( LPCVOID ptr
, UINT size
)
643 if (!size
) return FALSE
; /* handle 0 size case w/o reference */
644 if (!ptr
) return TRUE
;
646 if (!page_size
) page_size
= getpagesize();
649 volatile const char *p
= ptr
;
650 char dummy
__attribute__((unused
));
653 while (count
> page_size
)
660 dummy
= p
[count
- 1];
664 TRACE_(seh
)("%p caused page fault during read\n", ptr
);
672 /***********************************************************************
673 * IsBadWritePtr (KERNEL32.@)
675 * Check for write access on a memory block.
678 * ptr [I] Address of memory block.
679 * size [I] Size of block in bytes.
683 * Failure: FALSE. Process has write access to entire block.
685 BOOL WINAPI
IsBadWritePtr( LPVOID ptr
, UINT size
)
687 if (!size
) return FALSE
; /* handle 0 size case w/o reference */
688 if (!ptr
) return TRUE
;
690 if (!page_size
) page_size
= getpagesize();
693 volatile char *p
= ptr
;
696 while (count
> page_size
)
707 TRACE_(seh
)("%p caused page fault during write\n", ptr
);
715 /***********************************************************************
716 * IsBadHugeReadPtr (KERNEL32.@)
718 * Check for read access on a memory block.
721 * ptr [I] Address of memory block.
722 * size [I] Size of block.
726 * Failure: FALSE. Process has read access to entire block.
728 BOOL WINAPI
IsBadHugeReadPtr( LPCVOID ptr
, UINT size
)
730 return IsBadReadPtr( ptr
, size
);
734 /***********************************************************************
735 * IsBadHugeWritePtr (KERNEL32.@)
737 * Check for write access on a memory block.
740 * ptr [I] Address of memory block.
741 * size [I] Size of block.
745 * Failure: FALSE. Process has write access to entire block.
747 BOOL WINAPI
IsBadHugeWritePtr( LPVOID ptr
, UINT size
)
749 return IsBadWritePtr( ptr
, size
);
753 /***********************************************************************
754 * IsBadCodePtr (KERNEL32.@)
756 * Check for read access on a memory address.
759 * ptr [I] Address of function.
763 * Failure: FALSE. Process has read access to specified memory.
765 BOOL WINAPI
IsBadCodePtr( FARPROC ptr
)
767 return IsBadReadPtr( ptr
, 1 );
771 /***********************************************************************
772 * IsBadStringPtrA (KERNEL32.@)
774 * Check for read access on a range of memory pointed to by a string pointer.
777 * str [I] Address of string.
778 * max [I] Maximum size of string.
782 * Failure: FALSE. Read access to all bytes in string.
784 BOOL WINAPI
IsBadStringPtrA( LPCSTR str
, UINT max
)
786 if (!str
) return TRUE
;
790 volatile const char *p
= str
;
791 while (p
!= str
+ max
) if (!*p
++) break;
795 TRACE_(seh
)("%p caused page fault during read\n", str
);
803 /***********************************************************************
804 * IsBadStringPtrW (KERNEL32.@)
806 * See IsBadStringPtrA.
808 BOOL WINAPI
IsBadStringPtrW( LPCWSTR str
, UINT max
)
810 if (!str
) return TRUE
;
814 volatile const WCHAR
*p
= str
;
815 while (p
!= str
+ max
) if (!*p
++) break;
819 TRACE_(seh
)("%p caused page fault during read\n", str
);
826 /***********************************************************************
827 * K32GetMappedFileNameA (KERNEL32.@)
829 DWORD WINAPI
K32GetMappedFileNameA(HANDLE process
, LPVOID lpv
, LPSTR file_name
, DWORD size
)
831 FIXME_(file
)("(%p, %p, %p, %d): stub\n", process
, lpv
, file_name
, size
);
833 if (file_name
&& size
)
839 /***********************************************************************
840 * K32GetMappedFileNameW (KERNEL32.@)
842 DWORD WINAPI
K32GetMappedFileNameW(HANDLE process
, LPVOID lpv
, LPWSTR file_name
, DWORD size
)
844 FIXME_(file
)("(%p, %p, %p, %d): stub\n", process
, lpv
, file_name
, size
);
846 if (file_name
&& size
)
852 /***********************************************************************
853 * K32EnumPageFilesA (KERNEL32.@)
855 BOOL WINAPI
K32EnumPageFilesA( PENUM_PAGE_FILE_CALLBACKA callback
, LPVOID context
)
857 FIXME_(file
)("(%p, %p) stub\n", callback
, context
);
861 /***********************************************************************
862 * K32EnumPageFilesW (KERNEL32.@)
864 BOOL WINAPI
K32EnumPageFilesW( PENUM_PAGE_FILE_CALLBACKW callback
, LPVOID context
)
866 FIXME_(file
)("(%p, %p) stub\n", callback
, context
);
870 /***********************************************************************
871 * K32GetWsChanges (KERNEL32.@)
873 BOOL WINAPI
K32GetWsChanges(HANDLE process
, PPSAPI_WS_WATCH_INFORMATION watchinfo
, DWORD size
)
877 TRACE_(seh
)("(%p, %p, %d)\n", process
, watchinfo
, size
);
879 status
= NtQueryInformationProcess( process
, ProcessWorkingSetWatch
, watchinfo
, size
, NULL
);
883 SetLastError( RtlNtStatusToDosError( status
) );
889 /***********************************************************************
890 * K32InitializeProcessForWsWatch (KERNEL32.@)
892 BOOL WINAPI
K32InitializeProcessForWsWatch(HANDLE process
)
894 FIXME_(seh
)("(process=%p): stub\n", process
);