slabmalloc 0.2.1

Simple slab based malloc implementation in rust. Can be used stand-alone or in order to provide the necessary interface to rusts liballoc library. slabmalloc only relies on libcore.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# slabmalloc [![Build Status](https://travis-ci.org/gz/rust-slabmalloc.svg)](https://travis-ci.org/gz/rust-slabmalloc) [![Crates.io](https://img.shields.io/crates/v/slabmalloc.svg)](https://crates.io/crates/slabmalloc)

Simple slab based malloc implementation in rust, in order to provide the
necessary interface to rusts liballoc library. slabmalloc only relies on libcore
and is designed to be used in kernel level code as the only interface a client
needs to provide is the  necessary mechanism to allocate and free 4KiB frames
(or any other default page-size on non-x86 hardware).

## Usage

* Use the ZoneAllocator to allocate arbitrary sized objects:
```rust
let object_size = 12;
let alignment = 4;
let mut mmap = MmapPageProvider::new();
let mut zone = ZoneAllocator::new(Some(&mut mmap));


let allocated = zone.allocate(object_size, alignment);
allocated.map(|ptr| { zone.deallocate(ptr, object_size, alignment) });
```

* Use the SlabAllocator to allocate fixed sized objects:
```rust
let object_size = 10;
let alignment = 8;
let mut mmap = MmapPageProvider::new();
let mut sa: SlabAllocator = SlabAllocator::new(object_size, Some(&mut mmap));
sa.allocate(alignment);
```

The slabmalloc API is designed to satisfy the rust liballoc low-level memory allocation interface.

## TODOs
  * slabmalloc is not (yet) thread-safe.

## Documentation
* [API Documentation](http://gz.github.io/rust-slabmalloc/slabmalloc/)