table of contents
KMEM_CACHE_CREATE(9) | Memory Management in Linux | KMEM_CACHE_CREATE(9) |
NAME¶
kmem_cache_create - Create a cache.
SYNOPSIS¶
struct kmem_cache * kmem_cache_create(const char * name, size_t size, size_t align, unsigned long flags, void (*ctor) (void *));
ARGUMENTS¶
name
size
align
flags
ctor
DESCRIPTION¶
Returns a ptr to the cache on success, NULL on failure. Cannot be called within a int, but can be interrupted. The ctor is run when new pages are allocated by the cache.
name must be valid until the cache is destroyed. This implies that the module calling this has to destroy the cache before getting unloaded. Note that kmem_cache_name is not guaranteed to return the same pointer, therefore applications must manage it themselves.
The flags are
SLAB_POISON - Poison the slab with a known test pattern (a5a5a5a5) to catch references to uninitialised memory.
SLAB_RED_ZONE - Insert `Red´ zones around the allocated memory to check for buffer overruns.
SLAB_HWCACHE_ALIGN - Align the objects in this cache to a hardware cacheline. This can be beneficial if you´re counting cycles as closely as davem.
COPYRIGHT¶
May 2024 | Kernel Hackers Manual 2.6. |