Documentation/ABI/testing/sysfs-kernel-mm-contiguous

   1 What:           /sys/kernel/mm/contiguous/
   2 Date:           August 2010
   3 Contact:        Michal Nazarewicz <m.nazarewicz@samsung.com>
   4 Description:
   5                 If CMA has been built with SysFS support,
   6                 /sys/kernel/mm/contiguous/ contains a file called
   7                 "map", a file called "allocators" and a directory
   8                 called "regions".
   9
  10                 The "map" file lets one change the CMA's map attribute
  11                 at run-time.
  12
  13                 The "allocators" file list all registered allocators.
  14                 Allocators with no name are listed as a single minus
  15                 sign.
  16
  17                 The "regions" directory list all reserved regions.
  18
  19                 For more details see
  20                 Documentation/contiguous-memory.txt.
  21
  22 What:           /sys/kernel/mm/contiguous/regions/
  23 Date:           August 2010
  24 Contact:        Michal Nazarewicz <m.nazarewicz@samsung.com>
  25 Description:
  26                 The /sys/kernel/mm/contiguous/regions/ directory
  27                 contain directories for each registered CMA region.
  28                 The name of the directory is the same as the start
  29                 address of the region.
  30
  31                 If region is named there is also a symbolic link named
  32                 like the region pointing to the region's directory.
  33
  34                 Such directory contains the following files:
  35
  36                 * "name"  -- the name of the region or an empty file
  37                 * "start" -- starting address of the region (formatted
  38                             with %p, ie. hex).
  39                 * "size"  -- size of the region (in bytes).
  40                 * "free"  -- free space in the region (in bytes).
  41                 * "users" -- number of chunks allocated in the region.
  42                 * "alloc" -- name of the allocator.
  43
  44                 If allocator is not attached to the region, "alloc" is
  45                 either the name of desired allocator in square
  46                 brackets (ie. "[foo]") or an empty file if region is
  47                 to be attached to default allocator.  If an allocator
  48                 is attached to the region. "alloc" is either its name
  49                 or "-" if attached allocator has no name.
  50
  51                 If there are no chunks allocated in given region
  52                 ("users" is "0") then a name of desired allocator can
  53                 be written to "alloc".