Merge branch 'drm-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/airlied...
[pandora-kernel.git] / Documentation / ABI / testing / sysfs-kernel-slab
index 6dcf75e..8b093f8 100644 (file)
@@ -45,8 +45,9 @@ KernelVersion:        2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The alloc_fastpath file is read-only and specifies how many
-               objects have been allocated using the fast path.
+               The alloc_fastpath file shows how many objects have been
+               allocated using the fast path.  It can be written to clear the
+               current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/alloc_from_partial
@@ -55,9 +56,10 @@ KernelVersion:       2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The alloc_from_partial file is read-only and specifies how
-               many times a cpu slab has been full and it has been refilled
-               by using a slab from the list of partially used slabs.
+               The alloc_from_partial file shows how many times a cpu slab has
+               been full and it has been refilled by using a slab from the list
+               of partially used slabs.  It can be written to clear the current
+               count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/alloc_refill
@@ -66,9 +68,9 @@ KernelVersion:        2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The alloc_refill file is read-only and specifies how many
-               times the per-cpu freelist was empty but there were objects
-               available as the result of remote cpu frees.
+               The alloc_refill file shows how many times the per-cpu freelist
+               was empty but there were objects available as the result of
+               remote cpu frees.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/alloc_slab
@@ -77,8 +79,9 @@ KernelVersion:        2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The alloc_slab file is read-only and specifies how many times
-               a new slab had to be allocated from the page allocator.
+               The alloc_slab file is shows how many times a new slab had to
+               be allocated from the page allocator.  It can be written to
+               clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/alloc_slowpath
@@ -87,9 +90,10 @@ KernelVersion:       2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The alloc_slowpath file is read-only and specifies how many
-               objects have been allocated using the slow path because of a
-               refill or allocation from a partial or new slab.
+               The alloc_slowpath file shows how many objects have been
+               allocated using the slow path because of a refill or
+               allocation from a partial or new slab.  It can be written to
+               clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/cache_dma
@@ -117,10 +121,11 @@ KernelVersion:    2.6.31
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file cpuslab_flush is read-only and specifies how many
-               times a cache's cpu slabs have been flushed as the result of
-               destroying or shrinking a cache, a cpu going offline, or as
-               the result of forcing an allocation from a certain node.
+               The file cpuslab_flush shows how many times a cache's cpu slabs
+               have been flushed as the result of destroying or shrinking a
+               cache, a cpu going offline, or as the result of forcing an
+               allocation from a certain node.  It can be written to clear the
+               current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/ctor
@@ -139,8 +144,8 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file deactivate_empty is read-only and specifies how many
-               times an empty cpu slab was deactivated.
+               The deactivate_empty file shows how many times an empty cpu slab
+               was deactivated.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/deactivate_full
@@ -149,8 +154,8 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file deactivate_full is read-only and specifies how many
-               times a full cpu slab was deactivated.
+               The deactivate_full file shows how many times a full cpu slab
+               was deactivated.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/deactivate_remote_frees
@@ -159,9 +164,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file deactivate_remote_frees is read-only and specifies how
-               many times a cpu slab has been deactivated and contained free
-               objects that were freed remotely.
+               The deactivate_remote_frees file shows how many times a cpu slab
+               has been deactivated and contained free objects that were freed
+               remotely.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/deactivate_to_head
@@ -170,9 +175,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file deactivate_to_head is read-only and specifies how
-               many times a partial cpu slab was deactivated and added to the
-               head of its node's partial list.
+               The deactivate_to_head file shows how many times a partial cpu
+               slab was deactivated and added to the head of its node's partial
+               list.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/deactivate_to_tail
@@ -181,9 +186,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file deactivate_to_tail is read-only and specifies how
-               many times a partial cpu slab was deactivated and added to the
-               tail of its node's partial list.
+               The deactivate_to_tail file shows how many times a partial cpu
+               slab was deactivated and added to the tail of its node's partial
+               list.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/destroy_by_rcu
@@ -201,9 +206,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file free_add_partial is read-only and specifies how many
-               times an object has been freed in a full slab so that it had to
-               added to its node's partial list.
+               The free_add_partial file shows how many times an object has
+               been freed in a full slab so that it had to added to its node's
+               partial list.  It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/free_calls
@@ -222,9 +227,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The free_fastpath file is read-only and specifies how many
-               objects have been freed using the fast path because it was an
-               object from the cpu slab.
+               The free_fastpath file shows how many objects have been freed
+               using the fast path because it was an object from the cpu slab.
+               It can be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/free_frozen
@@ -233,9 +238,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The free_frozen file is read-only and specifies how many
-               objects have been freed to a frozen slab (i.e. a remote cpu
-               slab).
+               The free_frozen file shows how many objects have been freed to
+               a frozen slab (i.e. a remote cpu slab).  It can be written to
+               clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/free_remove_partial
@@ -244,9 +249,10 @@ KernelVersion:     2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file free_remove_partial is read-only and specifies how
-               many times an object has been freed to a now-empty slab so
-               that it had to be removed from its node's partial list.
+               The free_remove_partial file shows how many times an object has
+               been freed to a now-empty slab so that it had to be removed from
+               its node's partial list.  It can be written to clear the current
+               count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/free_slab
@@ -255,8 +261,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The free_slab file is read-only and specifies how many times an
-               empty slab has been freed back to the page allocator.
+               The free_slab file shows how many times an empty slab has been
+               freed back to the page allocator.  It can be written to clear
+               the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/free_slowpath
@@ -265,9 +272,9 @@ KernelVersion:      2.6.25
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The free_slowpath file is read-only and specifies how many
-               objects have been freed using the slow path (i.e. to a full or
-               partial slab).
+               The free_slowpath file shows how many objects have been freed
+               using the slow path (i.e. to a full or partial slab).  It can
+               be written to clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/hwcache_align
@@ -346,10 +353,10 @@ KernelVersion:    2.6.26
 Contact:       Pekka Enberg <penberg@cs.helsinki.fi>,
                Christoph Lameter <cl@linux-foundation.org>
 Description:
-               The file order_fallback is read-only and specifies how many
-               times an allocation of a new slab has not been possible at the
-               cache's order and instead fallen back to its minimum possible
-               order.
+               The order_fallback file shows how many times an allocation of a
+               new slab has not been possible at the cache's order and instead
+               fallen back to its minimum possible order.  It can be written to
+               clear the current count.
                Available when CONFIG_SLUB_STATS is enabled.
 
 What:          /sys/kernel/slab/cache/partial