Struct DiskAlloc 

pub struct DiskAlloc { /* private fields */ }

Manages the allocation of ideally one vector.
Sits on top of a file, and resizes it as needed by the vector.

Usage with vector:

#![feature(allocator_api)]
let alloc = diskallocator::DiskAlloc::new().unwrap();
let data: Vec<u64, diskallocator::DiskAlloc> = Vec::new_in(alloc);

Implementations

impl DiskAlloc

pub fn new() -> Result<Self, Error>

Create a new temporary file in /var/tmp/ and wait for potential “memory” allocation.

Might fail, if file can not be created or memory map fails.
An OutOfMemory error indicates, that no big enough address space could be found for the memory map (512GiB).

pub fn on_file(file: File) -> Result<Self, Error>

Use custom file (must be read/write) to allocate “memory”.

Can be useful for debugging.

Do not use same file twice or you will get memory access, bus or other unrecoverable hardware errors.

Trait Implementations

impl Allocator for DiskAlloc

fn allocate(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Attempts to allocate a block of memory.

unsafe fn grow( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Attempts to extend the memory block.

unsafe fn grow_zeroed( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

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

unsafe fn deallocate(&self, ptr: NonNull<u8>, layout: Layout)

🔬This is a nightly-only experimental API. (allocator_api)

Deallocates the memory referenced by ptr.

unsafe fn shrink( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Attempts to shrink the memory block.

fn allocate_zeroed(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Behaves like allocate, but also ensures that the returned memory is zero-initialized.

fn by_ref(&self) -> &Self

where Self: Sized,

🔬This is a nightly-only experimental API. (allocator_api)

Creates a “by reference” adapter for this instance of Allocator.

impl Clone for DiskAlloc

fn clone(&self) -> DiskAlloc

Returns a duplicate of the value.

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

Performs copy-assignment from source.