Skip to contentSkip to conversation

util/mmap-alloc: add comments, assertions

PATCH In review Michael S. Tsirkin 2 participants 2 messages Sep 29, 2015

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 util/mmap-alloc: add comments, assertions

Document RAM guard page logic within mmap-alloc.

---

Paolo, can you pls confirm this is what you had in mind?

 util/mmap-alloc.c | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
util/mmap-alloc.c +16 -0
index 05c8b4b..d978399 100644
@@ -12,9 +12,14 @@
 #include <qemu/mmap-alloc.h>
 #include <sys/types.h>
 #include <sys/mman.h>
+#include <assert.h>
 
 void *qemu_ram_mmap(int fd, size_t size, size_t align)
 {
+    /*
+     * Note: this always allocates at least one extra page of virtual address
+     * space, even if size is already aligned.
+     */
     size_t total = size + align;
     void *ptr = mmap(0, total, PROT_NONE, MAP_ANONYMOUS | MAP_PRIVATE, -1, 0);
     size_t offset = QEMU_ALIGN_UP((uintptr_t)ptr, align) - (uintptr_t)ptr;
@@ -24,6 +29,11 @@ void *qemu_ram_mmap(int fd, size_t size, size_t align)
         return NULL;
     }
 
+    /* Make sure align is a power of 2 */
+    assert(!(align & (align - 1)));
+    /* Always align to host page size */
+    assert(align >= getpagesize());
+
     ptr1 = mmap(ptr + offset, size, PROT_READ | PROT_WRITE,
                 MAP_FIXED | MAP_ANONYMOUS | MAP_PRIVATE, fd, 0);
     if (ptr1 == MAP_FAILED) {
@@ -37,6 +47,11 @@ void *qemu_ram_mmap(int fd, size_t size, size_t align)
     if (offset > 0) {
         munmap(ptr - offset, offset);
     }
+
+    /*
+     * Leave a single PROT_NONE page allocated after the RAM block, to serve as
+     * a guard page guarding against potential buffer overflows.
+     */
     if (total > size + getpagesize()) {
         munmap(ptr + size + getpagesize(), total - size - getpagesize());
     }
@@ -47,6 +62,7 @@ void *qemu_ram_mmap(int fd, size_t size, size_t align)
 void qemu_ram_munmap(void *ptr, size_t size)
 {
     if (ptr) {
+        /* Unmap both the RAM block and the guard page */
         munmap(ptr, size + getpagesize());
     }
 }
Signature · 1 line
MST
#1 lore raw
Quoted 55 lines · Michael S. Tsirkin

Document RAM guard page logic within mmap-alloc.

---

Paolo, can you pls confirm this is what you had in mind?

 util/mmap-alloc.c | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
util/mmap-alloc.c +15 -0
index 05c8b4b..d978399 100644
@@ -12,9 +12,14 @@
 #include <qemu/mmap-alloc.h>
 #include <sys/types.h>
 #include <sys/mman.h>
+#include <assert.h>
 
 void *qemu_ram_mmap(int fd, size_t size, size_t align)
 {
+    /*
+     * Note: this always allocates at least one extra page of virtual address
+     * space, even if size is already aligned.
+     */
     size_t total = size + align;
     void *ptr = mmap(0, total, PROT_NONE, MAP_ANONYMOUS | MAP_PRIVATE, -1, 0);
     size_t offset = QEMU_ALIGN_UP((uintptr_t)ptr, align) - (uintptr_t)ptr;
@@ -24,6 +29,11 @@ void *qemu_ram_mmap(int fd, size_t size, size_t align)
         return NULL;
     }
 
+    /* Make sure align is a power of 2 */
+    assert(!(align & (align - 1)));
+    /* Always align to host page size */
+    assert(align >= getpagesize());
+
     ptr1 = mmap(ptr + offset, size, PROT_READ | PROT_WRITE,
                 MAP_FIXED | MAP_ANONYMOUS | MAP_PRIVATE, fd, 0);
     if (ptr1 == MAP_FAILED) {
@@ -37,6 +47,11 @@ void *qemu_ram_mmap(int fd, size_t size, size_t align)
     if (offset > 0) {
         munmap(ptr - offset, offset);
     }
+
+    /*
+     * Leave a single PROT_NONE page allocated after the RAM block, to serve as
+     * a guard page guarding against potential buffer overflows.
+     */
     if (total > size + getpagesize()) {
         munmap(ptr + size + getpagesize(), total - size - getpagesize());
     }

util/mmap-alloc.c void *qemu_ram_mmap(int fd, size_t size, size_t align) · line 68

Quoted 7 lines
util/mmap-alloc.c +1 -0
@@ -47,6 +62,7 @@ void *qemu_ram_mmap(int fd, size_t size, size_t align)
 void qemu_ram_munmap(void *ptr, size_t size)
 {
     if (ptr) {
+        /* Unmap both the RAM block and the guard page */
         munmap(ptr, size + getpagesize());
     }
 }

Yes, thanks!

Paolo