aboutsummaryrefslogtreecommitdiff
path: root/include/qemu/mmap-alloc.h
blob: 90d0eee705351853ab7f7435e1e7a74dc305e4a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
#ifndef QEMU_MMAP_ALLOC_H
#define QEMU_MMAP_ALLOC_H


size_t qemu_fd_getpagesize(int fd);

size_t qemu_mempath_getpagesize(const char *mem_path);

/**
 * qemu_ram_mmap: mmap anonymous memory, the specified file or device.
 *
 * mmap() abstraction to map guest RAM, simplifying flag handling, taking
 * care of alignment requirements and installing guard pages.
 *
 * Parameters:
 *  @fd: the file or the device to mmap
 *  @size: the number of bytes to be mmaped
 *  @align: if not zero, specify the alignment of the starting mapping address;
 *          otherwise, the alignment in use will be determined by QEMU.
 *  @qemu_map_flags: QEMU_MAP_* flags
 *  @map_offset: map starts at offset of map_offset from the start of fd
 *
 * Internally, MAP_PRIVATE, MAP_ANONYMOUS and MAP_SHARED_VALIDATE are set
 * implicitly based on other parameters.
 *
 * Return:
 *  On success, return a pointer to the mapped area.
 *  On failure, return MAP_FAILED.
 */
void *qemu_ram_mmap(int fd,
                    size_t size,
                    size_t align,
                    uint32_t qemu_map_flags,
                    off_t map_offset);

void qemu_ram_munmap(int fd, void *ptr, size_t size);

#endif