Allocator API

include/mem/alloc.h

enum alloc_flags

enum alloc_flags {
    ALLOC_FLAG_PREFER_CACHE_ALIGNED = (1 << 0),
    ALLOC_FLAG_NO_CACHE_ALIGN = 0,
    ALLOC_FLAG_FLEXIBLE_LOCALITY = (1 << 1),
    ALLOC_FLAG_STRICT_LOCALITY = 0,
    ALLOC_FLAG_PAGEABLE = (1 << 2),
    ALLOC_FLAG_NONPAGEABLE = 0,
    ALLOC_FLAG_MOVABLE = (1 << 3),
    ALLOC_FLAG_NONMOVABLE = 0,
    ALLOC_FLAG_CLASS_DEFAULT = (1 << ALLOC_CLASS_SHIFT),
    ALLOC_FLAG_CLASS_INTERLEAVED = (2 << ALLOC_CLASS_SHIFT),
    ALLOC_FLAG_CLASS_HIGH_BANDWIDTH = (3 << ALLOC_CLASS_SHIFT),
};

enum alloc_behavior

enum alloc_behavior {
    ALLOC_BEHAVIOR_NORMAL,
    ALLOC_BEHAVIOR_ATOMIC,
    ALLOC_BEHAVIOR_NO_WAIT,
    ALLOC_BEHAVIOR_NO_RECLAIM,
    ALLOC_BEHAVIOR_FAULT_SAFE,
    ALLOC_BEHAVIOR_FLAG_FAST = 1 << ALLOC_BEHAVIOR_FLAG_SHIFT,
    ALLOC_BEHAVIOR_FLAG_MINIMAL = 1 << (ALLOC_BEHAVIOR_FLAG_SHIFT + 1),
};

alloc_flags_valid

bool alloc_flags_valid(enum alloc_flags flags);

alloc_flags_valid referenced types:

• enum alloc_flags

alloc_behavior_base

enum alloc_behavior alloc_behavior_base(enum alloc_behavior raw);

alloc_behavior_base referenced types:

• enum alloc_behavior

alloc_behavior_may_fault

bool alloc_behavior_may_fault(enum alloc_behavior raw);

alloc_behavior_may_fault referenced types:

• enum alloc_behavior

alloc_behavior_may_block

bool alloc_behavior_may_block(enum alloc_behavior raw);

alloc_behavior_may_block referenced types:

• enum alloc_behavior

alloc_behavior_is_isr_safe

bool alloc_behavior_is_isr_safe(enum alloc_behavior raw);

alloc_behavior_is_isr_safe referenced types:

• enum alloc_behavior

alloc_behavior_no_reclaim

bool alloc_behavior_no_reclaim(enum alloc_behavior raw);

alloc_behavior_no_reclaim referenced types:

• enum alloc_behavior

alloc_behavior_is_fast

bool alloc_behavior_is_fast(enum alloc_behavior raw);

alloc_behavior_is_fast referenced types:

• enum alloc_behavior

alloc_flag_behavior_verify

bool alloc_flag_behavior_verify(enum alloc_flags f, enum alloc_behavior behavior);

alloc_flag_behavior_verify referenced types:

• enum alloc_flags
• enum alloc_behavior

alloc_request_sanitize

void alloc_request_sanitize(enum alloc_flags *f, enum alloc_behavior *b);

alloc_request_sanitize referenced types:

• enum alloc_flags
• enum alloc_behavior

kmalloc_new

void * kmalloc_new(size_t size, enum alloc_flags flags, enum alloc_behavior behavior);

kmalloc_new referenced types:

• enum alloc_flags
• enum alloc_behavior

kfree_new

void kfree_new(void *ptr, enum alloc_behavior behavior);

kfree_new referenced types:

• enum alloc_behavior

kmalloc_from_domain

void * kmalloc_from_domain(size_t domain, size_t size);

kmalloc_internal

void * kmalloc_internal(size_t size, enum alloc_flags flags, enum alloc_behavior behavior);

kmalloc_internal referenced types:

• enum alloc_flags
• enum alloc_behavior

krealloc_internal

void * krealloc_internal(void *ptr, size_t size, enum alloc_flags flags, enum alloc_behavior behavior);

krealloc_internal referenced types:

• enum alloc_flags
• enum alloc_behavior

kzalloc_internal

void * kzalloc_internal(size_t size, enum alloc_flags flags, enum alloc_behavior behavior);

kzalloc_internal referenced types:

• enum alloc_flags
• enum alloc_behavior

kfree_internal

void kfree_internal(void *ptr, enum alloc_behavior behavior);

kfree_internal referenced types:

• enum alloc_behavior

ksize

size_t ksize(void *ptr);

kmalloc_aligned_internal

void * kmalloc_aligned_internal(size_t size, size_t align, enum alloc_flags flags, enum alloc_behavior behavior);

kmalloc_aligned_internal referenced types:

• enum alloc_flags
• enum alloc_behavior

kzalloc_aligned_internal

void * kzalloc_aligned_internal(size_t size, size_t align, enum alloc_flags flags, enum alloc_behavior behavior);

kzalloc_aligned_internal referenced types:

• enum alloc_flags
• enum alloc_behavior

kfree_aligned_internal

void kfree_aligned_internal(void *ptr, enum alloc_behavior behavior);

kfree_aligned_internal referenced types:

• enum alloc_behavior

Defines

ALLOC_LOCALITY_SHIFT

#define ALLOC_LOCALITY_SHIFT 9

ALLOC_CLASS_SHIFT

#define ALLOC_CLASS_SHIFT 12

ALLOC_CLASS_MASK

#define ALLOC_CLASS_MASK 0xF

ALLOC_LOCALITY_MAX

#define ALLOC_LOCALITY_MAX 7

ALLOC_LOCALITY_MIN

#define ALLOC_LOCALITY_MIN 0

ALLOC_LOCALITY_MASK

#define ALLOC_LOCALITY_MASK 0x7

ALLOC_LOCALITY_FROM_FLAGS(flags)

#define ALLOC_LOCALITY_FROM_FLAGS(flags)                                       \ (((flags) >> ALLOC_LOCALITY_SHIFT) & ALLOC_LOCALITY_MASK)

ALLOC_LOCALITY_TO_FLAGS(locality)

#define ALLOC_LOCALITY_TO_FLAGS(locality)                                      \ (((locality) & ALLOC_LOCALITY_MASK) << ALLOC_LOCALITY_SHIFT)

ALLOC_FLAG_TEST(flags, mask)

#define ALLOC_FLAG_TEST(flags, mask) (flags & mask)

ALLOC_FLAG_CLASS(flags)

#define ALLOC_FLAG_CLASS(flags)                                                \ ((flags >> ALLOC_CLASS_SHIFT) & ALLOC_CLASS_MASK)

ALLOC_FLAGS_UNAVAILABLE_BITS

#define ALLOC_FLAGS_UNAVAILABLE_BITS 0x70

ALLOC_FLAGS_DEFAULT

#define ALLOC_FLAGS_DEFAULT                                                    \ (ALLOC_FLAG_CLASS_DEFAULT | ALLOC_FLAG_FLEXIBLE_LOCALITY |                 \ ALLOC_FLAG_NONMOVABLE | ALLOC_FLAG_NONPAGEABLE |                          \ ALLOC_FLAG_NO_CACHE_ALIGN | ALLOC_LOCALITY_TO_FLAGS(ALLOC_LOCALITY_MIN))

ALLOC_FLAGS_PAGEABLE

#define ALLOC_FLAGS_PAGEABLE                                                   \ ALLOC_FLAG_PAGEABLE | ALLOC_FLAG_CLASS_DEFAULT |                           \ ALLOC_FLAG_FLEXIBLE_LOCALITY

ALLOC_BEHAVIOR_FLAG_SHIFT

#define ALLOC_BEHAVIOR_FLAG_SHIFT 4

ALLOC_BEHAVIOR_MASK

#define ALLOC_BEHAVIOR_MASK (0xF)

ALLOC_BEHAVIOR_AVAILABLE_SHIFT

#define ALLOC_BEHAVIOR_AVAILABLE_SHIFT 12

ALLOC_BEHAVIOR_DEFAULT

#define ALLOC_BEHAVIOR_DEFAULT ALLOC_BEHAVIOR_NORMAL

---