1 |
/* |
2 |
* vm_alloc.h - Wrapper to various virtual memory allocation schemes |
3 |
* (supports mmap, vm_allocate or fallbacks to malloc) |
4 |
* |
5 |
* Basilisk II (C) 1997-2002 Christian Bauer |
6 |
* |
7 |
* This program is free software; you can redistribute it and/or modify |
8 |
* it under the terms of the GNU General Public License as published by |
9 |
* the Free Software Foundation; either version 2 of the License, or |
10 |
* (at your option) any later version. |
11 |
* |
12 |
* This program is distributed in the hope that it will be useful, |
13 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
14 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
15 |
* GNU General Public License for more details. |
16 |
* |
17 |
* You should have received a copy of the GNU General Public License |
18 |
* along with this program; if not, write to the Free Software |
19 |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
20 |
*/ |
21 |
|
22 |
// TODO: Win32 VM ? |
23 |
#ifndef VM_ALLOC_H |
24 |
#define VM_ALLOC_H |
25 |
|
26 |
#ifdef HAVE_UNISTD_H |
27 |
#include <unistd.h> |
28 |
#include <sys/types.h> |
29 |
#endif |
30 |
#ifdef HAVE_SYS_MMAN_H |
31 |
#include <sys/mman.h> |
32 |
#endif |
33 |
#ifdef HAVE_MACH_VM |
34 |
extern "C" { |
35 |
#include <mach/mach.h> |
36 |
} |
37 |
#endif |
38 |
|
39 |
/* Return value of `vm_acquire' in case of an error. */ |
40 |
#ifdef HAVE_MACH_VM |
41 |
#define VM_MAP_FAILED ((void *)-1) |
42 |
#else |
43 |
#ifdef HAVE_MMAP_VM |
44 |
#define VM_MAP_FAILED ((void *)-1) |
45 |
#else |
46 |
#define VM_MAP_FAILED 0 |
47 |
#endif |
48 |
#endif |
49 |
|
50 |
/* Protection bits. */ |
51 |
#ifdef HAVE_MACH_VM |
52 |
#define VM_PAGE_NOACCESS VM_PROT_NONE |
53 |
#define VM_PAGE_READ VM_PROT_READ |
54 |
#define VM_PAGE_WRITE VM_PROT_WRITE |
55 |
#define VM_PAGE_EXECUTE VM_PROT_EXECUTE |
56 |
#else |
57 |
#ifdef HAVE_MMAP_VM |
58 |
#define VM_PAGE_NOACCESS PROT_NONE |
59 |
#define VM_PAGE_READ PROT_READ |
60 |
#define VM_PAGE_WRITE PROT_WRITE |
61 |
#define VM_PAGE_EXECUTE PROT_EXEC |
62 |
#else |
63 |
#define VM_PAGE_NOACCESS 0x0 |
64 |
#define VM_PAGE_READ 0x1 |
65 |
#define VM_PAGE_WRITE 0x2 |
66 |
#define VM_PAGE_EXECUTE 0x4 |
67 |
#endif |
68 |
#endif |
69 |
|
70 |
/* Default protection bits. */ |
71 |
#define VM_PAGE_DEFAULT (VM_PAGE_READ | VM_PAGE_WRITE) |
72 |
|
73 |
/* Initialize the VM system. Returns 0 if successful, -1 for errors. */ |
74 |
|
75 |
extern int vm_init(void); |
76 |
|
77 |
/* Deallocate all internal data used to wrap virtual memory allocators. */ |
78 |
|
79 |
extern void vm_exit(void); |
80 |
|
81 |
/* Allocate zero-filled memory of SIZE bytes. The mapping is private |
82 |
and default protection bits are read / write. The return value |
83 |
is the actual mapping address chosen or VM_MAP_FAILED for errors. */ |
84 |
|
85 |
extern void * vm_acquire(size_t size); |
86 |
|
87 |
/* Allocate zero-filled memory at exactly ADDR (which must be page-aligned). |
88 |
Returns 0 if successful, -1 on errors. */ |
89 |
|
90 |
extern int vm_acquire_fixed(void * addr, size_t size); |
91 |
|
92 |
/* Deallocate any mapping for the region starting at ADDR and extending |
93 |
LEN bytes. Returns 0 if successful, -1 on errors. */ |
94 |
|
95 |
extern int vm_release(void * addr, size_t size); |
96 |
|
97 |
/* Change the memory protection of the region starting at ADDR and |
98 |
extending LEN bytes to PROT. Returns 0 if successful, -1 for errors. */ |
99 |
|
100 |
extern int vm_protect(void * addr, size_t size, int prot); |
101 |
|
102 |
#endif /* VM_ALLOC_H */ |