| 1 | /* Iteration over virtual memory areas.
|
|---|
| 2 | Copyright (C) 2011-2022 Free Software Foundation, Inc.
|
|---|
| 3 | Written by Bruno Haible <bruno@clisp.org>, 2011.
|
|---|
| 4 |
|
|---|
| 5 | This program is free software: you can redistribute it and/or modify
|
|---|
| 6 | it under the terms of the GNU General Public License as published by
|
|---|
| 7 | the Free Software Foundation, either version 3 of the License, or
|
|---|
| 8 | (at your option) any later version.
|
|---|
| 9 |
|
|---|
| 10 | This program is distributed in the hope that it will be useful,
|
|---|
| 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|---|
| 13 | GNU General Public License for more details.
|
|---|
| 14 |
|
|---|
| 15 | You should have received a copy of the GNU General Public License
|
|---|
| 16 | along with this program. If not, see <https://www.gnu.org/licenses/>. */
|
|---|
| 17 |
|
|---|
| 18 | #ifndef _VMA_ITER_H
|
|---|
| 19 | #define _VMA_ITER_H
|
|---|
| 20 |
|
|---|
| 21 | #include <stdint.h>
|
|---|
| 22 |
|
|---|
| 23 | #ifdef __cplusplus
|
|---|
| 24 | extern "C" {
|
|---|
| 25 | #endif
|
|---|
| 26 |
|
|---|
| 27 |
|
|---|
| 28 | /* Bit mask for the FLAGS parameter of a vma_iterate callback function. */
|
|---|
| 29 | #define VMA_PROT_READ (1<<0)
|
|---|
| 30 | #define VMA_PROT_WRITE (1<<1)
|
|---|
| 31 | #define VMA_PROT_EXECUTE (1<<2)
|
|---|
| 32 |
|
|---|
| 33 | typedef int (*vma_iterate_callback_fn) (void *data,
|
|---|
| 34 | uintptr_t start, uintptr_t end,
|
|---|
| 35 | unsigned int flags);
|
|---|
| 36 |
|
|---|
| 37 | /* Iterate over the virtual memory areas of the current process.
|
|---|
| 38 | If such iteration is supported, the callback is called once for every
|
|---|
| 39 | virtual memory area, in ascending order, with the following arguments:
|
|---|
| 40 | - DATA is the same argument as passed to vma_iterate.
|
|---|
| 41 | - START is the address of the first byte in the area, page-aligned.
|
|---|
| 42 | - END is the address of the last byte in the area plus 1, page-aligned.
|
|---|
| 43 | Note that it may be 0 for the last area in the address space.
|
|---|
| 44 | - FLAGS is a combination of the VMA_* bits.
|
|---|
| 45 | If the callback returns 0, the iteration continues. If it returns 1,
|
|---|
| 46 | the iteration terminates prematurely.
|
|---|
| 47 | This function may open file descriptors, but does not call malloc().
|
|---|
| 48 | Return 0 if all went well, or -1 in case of error. */
|
|---|
| 49 | extern int vma_iterate (vma_iterate_callback_fn callback, void *data);
|
|---|
| 50 |
|
|---|
| 51 | /* The macro VMA_ITERATE_SUPPORTED indicates that vma_iterate is supported on
|
|---|
| 52 | this platform.
|
|---|
| 53 | Note that even when this macro is defined, vma_iterate() may still fail to
|
|---|
| 54 | find any virtual memory area, for example if /proc is not mounted. */
|
|---|
| 55 | #if defined __linux__ || defined __ANDROID__ || defined __GNU__ || defined __FreeBSD_kernel__ || defined __FreeBSD__ || defined __DragonFly__ || defined __NetBSD__ || defined _AIX || defined __sgi || defined __osf__ || defined __sun || HAVE_PSTAT_GETPROCVM || (defined __APPLE__ && defined __MACH__) || defined _WIN32 || defined __CYGWIN__ || defined __BEOS__ || defined __HAIKU__ || defined __minix || HAVE_MQUERY
|
|---|
| 56 | # define VMA_ITERATE_SUPPORTED 1
|
|---|
| 57 | #endif
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | #ifdef __cplusplus
|
|---|
| 61 | }
|
|---|
| 62 | #endif
|
|---|
| 63 |
|
|---|
| 64 | #endif /* _VMA_ITER_H */
|
|---|
