.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "KMEM_CACHE_DESTROY" "" "06 October 2005" "" ""

.SH NAME
kmem_cache_destroy \- delete a cache
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int kmem_cache_destroy  (kmem_cache_t * \fIcachep\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIcachep\fB\fR
the cache to destroy
.SH "DESCRIPTION"
.PP
Remove a kmem_cache_t object from the slab cache.
Returns 0 on success.
.PP
It is expected this function will be called by a module when it is
unloaded.  This will remove the cache completely, and avoid a duplicate
cache being allocated each time a module is loaded and unloaded, if the
module doesn't have persistent in-kernel storage across loads and unloads.
.PP
The cache must be empty before calling this function.
.PP
The caller must guarantee that noone will allocate memory from the cache
during the \fBkmem_cache_destroy\fR\&.