wasm-micro-runtime/tests/unit/mem-alloc/mem_alloc_test.c
liang.he@intel.com 779edfa277 feat(api): expose aligned allocation through wasm_runtime_aligned_alloc
Add public API for aligned memory allocation, exposing the existing
mem_allocator_malloc_aligned infrastructure through wasm_export.h.

- Add wasm_runtime_aligned_alloc() API declaration with documentation
- Implement internal helper wasm_runtime_aligned_alloc_internal()
- Add public function with size/alignment validation
- POOL mode only, returns NULL for other memory modes
- Follows wasm_runtime_malloc() patterns for consistency

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-04-16 09:00:06 +08:00

520 lines
14 KiB
C

/*
* Copyright (C) 2019 Intel Corporation. All rights reserved.
* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
*/
#include <stdarg.h>
#include <stddef.h>
#include <setjmp.h>
#include <stdint.h>
#include <string.h>
#include <cmocka.h>
#if WAMR_BUILD_TEST != 1
#error "WAMR_BUILD_TEST must be defined as 1"
#endif
#include "mem_alloc.h"
#include "ems_gc_internal.h"
#include "wasm_export.h"
/* Test helper: Check if pointer is aligned */
static inline bool
is_aligned(void *ptr, size_t alignment)
{
return ((uintptr_t)ptr % alignment) == 0;
}
/* Test helper: Check if allocation is aligned (has magic value) */
static inline bool
is_aligned_allocation(gc_object_t obj)
{
uint32_t *magic_ptr = (uint32_t *)((char *)obj - 4);
return ((*magic_ptr & ALIGNED_ALLOC_MAGIC_MASK)
== ALIGNED_ALLOC_MAGIC_VALUE);
}
/* Test: Normal allocation still works (regression) */
static void
test_normal_alloc_basic(void **state)
{
mem_allocator_t allocator;
char heap_buf[64 * 1024];
void *ptr;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Normal allocation should still work */
ptr = mem_allocator_malloc(allocator, 128);
assert_non_null(ptr);
/* Should be 8-byte aligned */
assert_true(is_aligned(ptr, 8));
/* Should NOT be marked as aligned allocation */
assert_false(is_aligned_allocation(ptr));
/* Free should work */
mem_allocator_free(allocator, ptr);
mem_allocator_destroy(allocator);
}
/* Test: Valid alignment powers of 2 */
static void
test_aligned_alloc_valid_alignments(void **state)
{
mem_allocator_t allocator;
char heap_buf[128 * 1024];
void *ptr;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Test each valid alignment */
int alignments[] = { 8, 16, 32, 64, 128, 256, 512, 1024 };
int num_alignments = sizeof(alignments) / sizeof(alignments[0]);
for (int i = 0; i < num_alignments; i++) {
int align = alignments[i];
/* Allocate with size = multiple of alignment */
ptr = mem_allocator_malloc_aligned(allocator, align * 2, align);
assert_non_null(ptr);
/* Verify alignment */
assert_true(is_aligned(ptr, align));
/* Verify marked as aligned */
assert_true(is_aligned_allocation(ptr));
/* Free */
mem_allocator_free(allocator, ptr);
}
mem_allocator_destroy(allocator);
}
/* Test: Realloc rejects aligned allocations */
static void
test_realloc_rejects_aligned(void **state)
{
mem_allocator_t allocator;
char heap_buf[64 * 1024];
void *ptr, *new_ptr;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Allocate aligned */
ptr = mem_allocator_malloc_aligned(allocator, 128, 64);
assert_non_null(ptr);
assert_true(is_aligned_allocation(ptr));
/* Realloc should reject aligned allocation */
new_ptr = mem_allocator_realloc(allocator, ptr, 256);
assert_null(new_ptr);
/* Original pointer should still be valid - free it */
mem_allocator_free(allocator, ptr);
mem_allocator_destroy(allocator);
}
/* Test: Realloc still works for normal allocations */
static void
test_normal_realloc_works(void **state)
{
mem_allocator_t allocator;
char heap_buf[64 * 1024];
void *ptr, *new_ptr;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Allocate normal */
ptr = mem_allocator_malloc(allocator, 128);
assert_non_null(ptr);
/* Write some data */
memset(ptr, 0xAB, 128);
/* Realloc should work */
new_ptr = mem_allocator_realloc(allocator, ptr, 256);
assert_non_null(new_ptr);
/* Data should be preserved */
for (int i = 0; i < 128; i++) {
assert_int_equal(((unsigned char *)new_ptr)[i], 0xAB);
}
mem_allocator_free(allocator, new_ptr);
mem_allocator_destroy(allocator);
}
/* Test: Invalid alignments (not power of 2 or zero) */
static void
test_aligned_alloc_invalid_not_power_of_2(void **state)
{
mem_allocator_t allocator;
char heap_buf[64 * 1024];
void *ptr;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* These should all fail (zero or not power of 2) */
int invalid_alignments[] = { 0, 3, 5, 7, 9, 15, 17, 100 };
int num_invalid =
sizeof(invalid_alignments) / sizeof(invalid_alignments[0]);
for (int i = 0; i < num_invalid; i++) {
ptr =
mem_allocator_malloc_aligned(allocator, 128, invalid_alignments[i]);
assert_null(ptr);
}
/* Small powers of 2 should succeed (adjusted to GC_MIN_ALIGNMENT) */
ptr = mem_allocator_malloc_aligned(allocator, 8, 1);
assert_non_null(ptr);
mem_allocator_free(allocator, ptr);
ptr = mem_allocator_malloc_aligned(allocator, 8, 2);
assert_non_null(ptr);
mem_allocator_free(allocator, ptr);
ptr = mem_allocator_malloc_aligned(allocator, 8, 4);
assert_non_null(ptr);
mem_allocator_free(allocator, ptr);
mem_allocator_destroy(allocator);
}
/* Test: Size must be multiple of alignment */
static void
test_aligned_alloc_size_not_multiple(void **state)
{
mem_allocator_t allocator;
char heap_buf[64 * 1024];
void *ptr;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Size not multiple of alignment - should fail */
ptr = mem_allocator_malloc_aligned(allocator, 100, 64);
assert_null(ptr);
ptr = mem_allocator_malloc_aligned(allocator, 65, 64);
assert_null(ptr);
/* Size is multiple - should succeed */
ptr = mem_allocator_malloc_aligned(allocator, 128, 64);
assert_non_null(ptr);
mem_allocator_free(allocator, ptr);
mem_allocator_destroy(allocator);
}
/* Test: Mixed normal and aligned allocations */
static void
test_mixed_alloc_interleaved(void **state)
{
mem_allocator_t allocator;
char heap_buf[128 * 1024];
void *normal1, *aligned1, *normal2, *aligned2;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Allocate: normal -> aligned -> normal -> aligned */
normal1 = mem_allocator_malloc(allocator, 64);
assert_non_null(normal1);
assert_false(is_aligned_allocation(normal1));
aligned1 = mem_allocator_malloc_aligned(allocator, 128, 64);
assert_non_null(aligned1);
assert_true(is_aligned_allocation(aligned1));
assert_true(is_aligned(aligned1, 64));
normal2 = mem_allocator_malloc(allocator, 96);
assert_non_null(normal2);
assert_false(is_aligned_allocation(normal2));
aligned2 = mem_allocator_malloc_aligned(allocator, 256, 128);
assert_non_null(aligned2);
assert_true(is_aligned_allocation(aligned2));
assert_true(is_aligned(aligned2, 128));
/* Free in mixed order */
mem_allocator_free(allocator, normal1);
mem_allocator_free(allocator, aligned2);
mem_allocator_free(allocator, normal2);
mem_allocator_free(allocator, aligned1);
mem_allocator_destroy(allocator);
}
/* Test: obj_to_hmu works correctly for both types */
static void
test_mixed_obj_to_hmu(void **state)
{
mem_allocator_t allocator;
char heap_buf[64 * 1024];
void *normal, *aligned;
hmu_t *hmu_normal, *hmu_aligned;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Allocate both types */
normal = mem_allocator_malloc(allocator, 128);
assert_non_null(normal);
aligned = mem_allocator_malloc_aligned(allocator, 128, 64);
assert_non_null(aligned);
/* Get HMU pointers */
hmu_normal = obj_to_hmu(normal);
hmu_aligned = obj_to_hmu(aligned);
assert_non_null(hmu_normal);
assert_non_null(hmu_aligned);
/* Both should have HMU_VO type */
assert_int_equal(hmu_get_ut(hmu_normal), HMU_VO);
assert_int_equal(hmu_get_ut(hmu_aligned), HMU_VO);
/* Sizes should be reasonable */
assert_true(hmu_get_size(hmu_normal) >= 128);
assert_true(hmu_get_size(hmu_aligned) >= 128);
/* Free both */
mem_allocator_free(allocator, normal);
mem_allocator_free(allocator, aligned);
mem_allocator_destroy(allocator);
}
/* Test: Many aligned allocations */
static void
test_aligned_alloc_many(void **state)
{
mem_allocator_t allocator;
char heap_buf[512 * 1024];
void *ptrs[100];
int count = 0;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Allocate as many as possible */
for (int i = 0; i < 100; i++) {
int align = (i % 4 == 0) ? 64 : 32;
ptrs[i] = mem_allocator_malloc_aligned(allocator, align * 2, align);
if (ptrs[i]) {
assert_true(is_aligned(ptrs[i], align));
count++;
}
else {
break;
}
}
assert_true(count > 10); /* At least some should succeed */
/* Free all */
for (int i = 0; i < count; i++) {
mem_allocator_free(allocator, ptrs[i]);
}
mem_allocator_destroy(allocator);
}
/* Test: Many mixed allocations */
static void
test_mixed_alloc_many(void **state)
{
mem_allocator_t allocator;
char heap_buf[512 * 1024];
void *ptrs[200];
int count = 0;
allocator = mem_allocator_create(heap_buf, sizeof(heap_buf));
assert_non_null(allocator);
/* Alternate normal and aligned */
for (int i = 0; i < 200; i++) {
if (i % 2 == 0) {
/* Normal allocation */
ptrs[i] = mem_allocator_malloc(allocator, 64);
}
else {
/* Aligned allocation */
ptrs[i] = mem_allocator_malloc_aligned(allocator, 64, 32);
}
if (ptrs[i]) {
count++;
}
else {
break;
}
}
assert_true(count > 20);
/* Free in reverse order */
for (int i = count - 1; i >= 0; i--) {
mem_allocator_free(allocator, ptrs[i]);
}
mem_allocator_destroy(allocator);
}
/* Test: wasm_runtime_aligned_alloc with valid inputs in POOL mode */
static void
test_wasm_runtime_aligned_alloc_valid(void **state)
{
RuntimeInitArgs init_args;
void *ptr;
memset(&init_args, 0, sizeof(RuntimeInitArgs));
init_args.mem_alloc_type = Alloc_With_Pool;
init_args.mem_alloc_option.pool.heap_buf = malloc(256 * 1024);
init_args.mem_alloc_option.pool.heap_size = 256 * 1024;
assert_true(wasm_runtime_full_init(&init_args));
/* Test valid aligned allocation */
ptr = wasm_runtime_aligned_alloc(128, 64);
assert_non_null(ptr);
assert_true(is_aligned(ptr, 64));
/* Free should work */
wasm_runtime_free(ptr);
wasm_runtime_destroy();
free(init_args.mem_alloc_option.pool.heap_buf);
}
/* Test: wasm_runtime_aligned_alloc with zero size */
static void
test_wasm_runtime_aligned_alloc_zero_size(void **state)
{
RuntimeInitArgs init_args;
void *ptr;
memset(&init_args, 0, sizeof(RuntimeInitArgs));
init_args.mem_alloc_type = Alloc_With_Pool;
init_args.mem_alloc_option.pool.heap_buf = malloc(256 * 1024);
init_args.mem_alloc_option.pool.heap_size = 256 * 1024;
assert_true(wasm_runtime_full_init(&init_args));
/* Zero size should allocate alignment bytes (like malloc(0) behavior) */
ptr = wasm_runtime_aligned_alloc(0, 64);
assert_non_null(ptr);
assert_true(is_aligned(ptr, 64));
wasm_runtime_free(ptr);
wasm_runtime_destroy();
free(init_args.mem_alloc_option.pool.heap_buf);
}
/* Test: wasm_runtime_aligned_alloc with zero alignment */
static void
test_wasm_runtime_aligned_alloc_zero_alignment(void **state)
{
RuntimeInitArgs init_args;
void *ptr;
memset(&init_args, 0, sizeof(RuntimeInitArgs));
init_args.mem_alloc_type = Alloc_With_Pool;
init_args.mem_alloc_option.pool.heap_buf = malloc(256 * 1024);
init_args.mem_alloc_option.pool.heap_size = 256 * 1024;
assert_true(wasm_runtime_full_init(&init_args));
/* Zero alignment should return NULL */
ptr = wasm_runtime_aligned_alloc(128, 0);
assert_null(ptr);
wasm_runtime_destroy();
free(init_args.mem_alloc_option.pool.heap_buf);
}
/* Test: wasm_runtime_aligned_alloc in SYSTEM_ALLOCATOR mode returns NULL */
static void
test_wasm_runtime_aligned_alloc_system_mode(void **state)
{
RuntimeInitArgs init_args;
void *ptr;
memset(&init_args, 0, sizeof(RuntimeInitArgs));
init_args.mem_alloc_type = Alloc_With_System_Allocator;
assert_true(wasm_runtime_full_init(&init_args));
/* Should return NULL in non-POOL mode */
ptr = wasm_runtime_aligned_alloc(128, 64);
assert_null(ptr);
wasm_runtime_destroy();
}
/* Test: wasm_runtime_realloc rejects aligned allocations */
static void
test_wasm_runtime_realloc_rejects_aligned(void **state)
{
RuntimeInitArgs init_args;
void *ptr, *new_ptr;
memset(&init_args, 0, sizeof(RuntimeInitArgs));
init_args.mem_alloc_type = Alloc_With_Pool;
init_args.mem_alloc_option.pool.heap_buf = malloc(256 * 1024);
init_args.mem_alloc_option.pool.heap_size = 256 * 1024;
assert_true(wasm_runtime_full_init(&init_args));
/* Allocate with alignment */
ptr = wasm_runtime_aligned_alloc(128, 64);
assert_non_null(ptr);
/* Realloc should return NULL */
new_ptr = wasm_runtime_realloc(ptr, 256);
assert_null(new_ptr);
/* Original pointer still valid */
wasm_runtime_free(ptr);
wasm_runtime_destroy();
free(init_args.mem_alloc_option.pool.heap_buf);
}
/* Test: wasm_runtime_aligned_alloc with various alignments */
static void
test_wasm_runtime_aligned_alloc_multiple_alignments(void **state)
{
RuntimeInitArgs init_args;
int alignments[] = { 8, 16, 32, 64, 128, 256 };
int num_alignments = sizeof(alignments) / sizeof(alignments[0]);
memset(&init_args, 0, sizeof(RuntimeInitArgs));
init_args.mem_alloc_type = Alloc_With_Pool;
init_args.mem_alloc_option.pool.heap_buf = malloc(512 * 1024);
init_args.mem_alloc_option.pool.heap_size = 512 * 1024;
assert_true(wasm_runtime_full_init(&init_args));
for (int i = 0; i < num_alignments; i++) {
int align = alignments[i];
void *ptr = wasm_runtime_aligned_alloc(align * 2, align);
assert_non_null(ptr);
assert_true(is_aligned(ptr, align));
wasm_runtime_free(ptr);
}
wasm_runtime_destroy();
free(init_args.mem_alloc_option.pool.heap_buf);
}