summaryrefslogtreecommitdiffstats
path: root/man/man5/spl-module-parameters.5
diff options
context:
space:
mode:
authorBrian Behlendorf <[email protected]>2014-12-15 14:06:18 -0800
committerBrian Behlendorf <[email protected]>2015-01-16 13:55:09 -0800
commit3018bffa9b8bfd8d24010407c8a07c25b44c010e (patch)
tree04482ab0eb9cb14a130a9a992737b3712ee6659f /man/man5/spl-module-parameters.5
parente50e6cc958a85e010d996ca80cf20d48c51103d3 (diff)
Refine slab cache sizing
This change is designed to improve the memory utilization of slabs by more carefully setting their size. The way the code currently works is problematic for slabs which contain large objects (>1MB). This is due to slabs being unconditionally rounded up to a power of two which may result in unused space at the end of the slab. The reason the existing code rounds up every slab is because it assumes it will backed by the buddy allocator. Since the buddy allocator can only performs power of two allocations this is desirable because it avoids wasting any space. However, this logic breaks down if slab is backed by vmalloc() which operates at a page level granularity. In this case, the optimal thing to do is calculate the minimum required slab size given certain constraints (object size, alignment, objects/slab, etc). Therefore, this patch reworks the spl_slab_size() function so that it sizes KMC_KMEM slabs differently than KMC_VMEM slabs. KMC_KMEM slabs are rounded up to the nearest power of two, and KMC_VMEM slabs are allowed to be the minimum required size. This change also reduces the default number of objects per slab. This reduces how much memory a single cache object can pin, which can result in significant memory saving for highly fragmented caches. But depending on the workload it may result in slabs being allocated and freed more frequently. In practice, this has been shown to be a better default for most workloads. Also the maximum slab size has been reduced to 4MB on 32-bit systems. Due to the limited virtual address space it's critical the we be as frugal as possible. A limit of 4M still lets us reasonably comfortably allocate a limited number of 1MB objects. Finally, the kmem:slab_small and kmem:slab_large SPLAT tests were extended to provide better test coverage of various object sizes and alignments. Caches are created with random parameters and their basic functionality is verified by allocating several slabs worth of objects. Signed-off-by: Brian Behlendorf <[email protected]>
Diffstat (limited to 'man/man5/spl-module-parameters.5')
-rw-r--r--man/man5/spl-module-parameters.54
1 files changed, 2 insertions, 2 deletions
diff --git a/man/man5/spl-module-parameters.5 b/man/man5/spl-module-parameters.5
index 27c7bfd48..3e7e877fb 100644
--- a/man/man5/spl-module-parameters.5
+++ b/man/man5/spl-module-parameters.5
@@ -68,7 +68,7 @@ required to perform an allocation. Conversely, a smaller value will minimize
the footprint and improve cache reclaim time but individual allocations may
take longer.
.sp
-Default value: \fB16\fR
+Default value: \fB8\fR
.RE
.sp
@@ -96,7 +96,7 @@ the maximum cache object size to \fBspl_kmem_cache_max_size\fR /
\fBspl_kmem_cache_obj_per_slab\fR. Caches may not be created with
object sized larger than this limit.
.sp
-Default value: \fB32\fR
+Default value: \fB32 (64-bit) or 4 (32-bit)\fR
.RE
.sp