kernel/tools/perf/Documentation/perf-kmem.txt

   1 perf-kmem(1)
   2 ============
   3
   4 NAME
   5 ----
   6 perf-kmem - Tool to trace/measure kernel memory properties
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'perf kmem' {record|stat} [<options>]
  12
  13 DESCRIPTION
  14 -----------
  15 There are two variants of perf kmem:
  16
  17   'perf kmem record <command>' to record the kmem events
  18   of an arbitrary workload.
  19
  20   'perf kmem stat' to report kernel memory statistics.
  21
  22 OPTIONS
  23 -------
  24 -i <file>::
  25 --input=<file>::
  26         Select the input file (default: perf.data unless stdin is a fifo)
  27
  28 -v::
  29 --verbose::
  30         Be more verbose. (show symbol address, etc)
  31
  32 --caller::
  33         Show per-callsite statistics
  34
  35 --alloc::
  36         Show per-allocation statistics
  37
  38 -s <key[,key2...]>::
  39 --sort=<key[,key2...]>::
  40         Sort the output (default: 'frag,hit,bytes' for slab and 'bytes,hit'
  41         for page).  Available sort keys are 'ptr, callsite, bytes, hit,
  42         pingpong, frag' for slab and 'page, callsite, bytes, hit, order,
  43         migtype, gfp' for page.  This option should be preceded by one of the
  44         mode selection options - i.e. --slab, --page, --alloc and/or --caller.
  45
  46 -l <num>::
  47 --line=<num>::
  48         Print n lines only
  49
  50 --raw-ip::
  51         Print raw ip instead of symbol
  52
  53 --slab::
  54         Analyze SLAB allocator events.
  55
  56 --page::
  57         Analyze page allocator events
  58
  59 --live::
  60         Show live page stat.  The perf kmem shows total allocation stat by
  61         default, but this option shows live (currently allocated) pages
  62         instead.  (This option works with --page option only)
  63
  64 SEE ALSO
  65 --------
  66 linkperf:perf-record[1]