kumem_alloc.h File Reference

Kumem allocator utility C interface. More...

#include <l4/sys/types.h>
#include <l4/sys/linkage.h>

Include dependency graph for kumem_alloc.h:

Go to the source code of this file.

Functions
int	l4re_util_kumem_alloc (l4_addr_t *mem, unsigned pages_order, l4_cap_idx_t task, l4_cap_idx_t rm) L4_NOTHROW
	Allocate state area.

Detailed Description

Kumem allocator utility C interface.

Definition in file kumem_alloc.h.

Function Documentation

l4re_util_kumem_alloc()

int l4re_util_kumem_alloc	(	l4_addr_t *	mem,
		unsigned	pages_order,
		l4_cap_idx_t	task,
		l4_cap_idx_t	rm
	)

Allocate state area.

Parameters

[out]	mem	Pointer to memory that has been allocated.
	pages_order	Size to allocate, in log2 pages.
	task	Task to use for allocation.
	rm	Region manager to use for allocation.

Return values

0	for success
<0	error code on failure

Note

The amount of kernel-user memory that can be allocated at once is limited by the used kernel implementation. The minimum allocatable amount is one page. A portable implementation should not depend on allocations greater than 16KiB to succeed.

Examples

examples/sys/aliens/main.c, and examples/sys/utcb-ipc/main.c.