1 #ifndef _BABELTRACE_MMAP_ALIGN_H
2 #define _BABELTRACE_MMAP_ALIGN_H
5 * BabelTrace mmap-align.h - mmap alignment header
7 * Copyright 2010 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
9 * Permission is hereby granted, free of charge, to any person obtaining a copy
10 * of this software and associated documentation files (the "Software"), to deal
11 * in the Software without restriction, including without limitation the rights
12 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13 * copies of the Software, and to permit persons to whom the Software is
14 * furnished to do so, subject to the following conditions:
16 * The above copyright notice and this permission notice shall be included in
17 * all copies or substantial portions of the Software.
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
28 #include <babeltrace/align-internal.h>
31 #include <babeltrace/compat/mman-internal.h>
32 #include <babeltrace/common-internal.h>
35 * This header implements a wrapper over mmap (mmap_align) that memory
36 * maps a file region that is not necessarily multiple of the page size.
37 * It returns a structure (instead of a pointer) that contains the mmap
38 * pointer (page-aligned) and a pointer to the offset requested within
39 * that page. Note: in the current implementation, the "addr" parameter
40 * cannot be forced, so we allocate at an address chosen by the OS.
44 void *page_aligned_addr
; /* mmap address, aligned to floor */
45 size_t page_aligned_length
; /* mmap length, containing range */
47 void *addr
; /* virtual mmap address */
48 size_t length
; /* virtual mmap length */
55 * On windows the memory mapping offset must be aligned to the memory
56 * allocator allocation granularity and not the page size.
59 off_t
get_page_aligned_offset(off_t offset
, size_t page_size
)
63 GetNativeSystemInfo(&sysinfo
);
65 return ALIGN_FLOOR(offset
, sysinfo
.dwAllocationGranularity
);
69 off_t
get_page_aligned_offset(off_t offset
, size_t page_size
)
71 return ALIGN_FLOOR(offset
, page_size
);
76 struct mmap_align
*mmap_align(size_t length
, int prot
,
77 int flags
, int fd
, off_t offset
)
79 struct mmap_align
*mma
;
80 off_t page_aligned_offset
; /* mmap offset, aligned to floor */
83 page_size
= bt_common_get_page_size();
85 mma
= malloc(sizeof(*mma
));
89 page_aligned_offset
= get_page_aligned_offset(offset
, page_size
);
91 * Page aligned length needs to contain the requested range.
92 * E.g., for a small range that fits within a single page, we might
93 * require a 2 pages page_aligned_length if the range crosses a page
96 mma
->page_aligned_length
= ALIGN(length
+ offset
- page_aligned_offset
, page_size
);
97 mma
->page_aligned_addr
= bt_mmap(NULL
, mma
->page_aligned_length
,
98 prot
, flags
, fd
, page_aligned_offset
);
99 if (mma
->page_aligned_addr
== MAP_FAILED
) {
103 mma
->addr
= ((uint8_t *) mma
->page_aligned_addr
) + (offset
- page_aligned_offset
);
108 int munmap_align(struct mmap_align
*mma
)
110 void *page_aligned_addr
;
111 size_t page_aligned_length
;
113 page_aligned_addr
= mma
->page_aligned_addr
;
114 page_aligned_length
= mma
->page_aligned_length
;
116 return bt_munmap(page_aligned_addr
, page_aligned_length
);
120 void *mmap_align_addr(struct mmap_align
*mma
)
126 * Helper for special-cases, normally unused.
129 void mmap_align_set_addr(struct mmap_align
*mma
, void *addr
)
134 #endif /* _BABELTRACE_MMAP_ALIGN_H */