Struct MiMalloc 

pub struct MiMalloc;

The mimalloc global allocator.

Drop-in replacement for the system allocator. Always uses mi_malloc_aligned internally to guarantee correct alignment for all layouts.

Implementations

impl MiMalloc

pub fn version() -> i32

mimalloc version as major * 10000 + minor * 100 + patch.

pub fn collect(force: bool)

Force garbage collection.

pub unsafe fn usable_size(ptr: *const u8) -> usize

Usable size of an allocated block (may be larger than requested).

Safety

ptr must have been allocated by mimalloc.

pub unsafe fn free_csize(ptr: *mut u8, size: usize)

Free a mimalloc block when the allocation size is known.

For small sizes this uses mimalloc’s small-free fast path.

Safety

ptr must be null or a valid mimalloc allocation, and size must be the allocation size used for the corresponding allocation.

pub unsafe fn free_csize_nonnull(ptr: NonNull<u8>, size: usize)

Free a non-null mimalloc block when the allocation size is known.

For small sizes this uses mimalloc’s non-null small-free fast path.

Safety

ptr must be a valid mimalloc allocation, and size must be the allocation size used for the corresponding allocation.

pub unsafe fn free_small(ptr: *mut u8)

Free a small mimalloc block.

Safety

ptr must be null or a valid mimalloc allocation whose allocation size is less than or equal to crate::MI_SMALL_SIZE_MAX.

pub unsafe fn free_small_nonnull(ptr: NonNull<u8>)

Free a non-null small mimalloc block.

Safety

ptr must be a valid mimalloc allocation whose allocation size is less than or equal to crate::MI_SMALL_SIZE_MAX.

pub fn process_info() -> ProcessInfo

Process memory information.

pub fn stats_json() -> String

Allocation statistics as JSON. Returns empty string on failure.

pub fn stats_print() -> String

Allocation statistics in mimalloc’s human-readable text format.

pub fn stats_reset()

Reset accumulated mimalloc allocation statistics.

pub fn process_info_print() -> String

Process memory information in mimalloc’s human-readable text format.

pub fn option_is_enabled(option: mi_option_t) -> bool

Check if an option is enabled.

pub fn option_get(option: mi_option_t) -> c_long

Get an option value.

pub fn option_get_size(option: mi_option_t) -> usize

Get an option value as size (bytes).

pub fn option_set(option: mi_option_t, value: c_long)

Set an option value.

use rustfs_mimalloc::MiMalloc;
use rustfs_mimalloc_sys::mi_option_t;

// Return memory to OS immediately
MiMalloc::option_set(mi_option_t::mi_option_purge_delay, 0);

pub fn option_enable(option: mi_option_t)

Enable an option.

pub fn option_disable(option: mi_option_t)

Disable an option.

Trait Implementations

impl Clone for MiMalloc

fn clone(&self) -> MiMalloc

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for MiMalloc

impl Debug for MiMalloc

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MiMalloc

fn default() -> MiMalloc

Returns the “default value” for a type.

impl GlobalAlloc for MiMalloc

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory as described by the given layout.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Behaves like alloc, but also ensures that the contents are set to zero before being returned.

unsafe fn dealloc(&self, ptr: *mut u8, _layout: Layout)

Deallocates the block of memory at the given ptr pointer with the given layout.

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.