xref: /linux/tools/perf/Documentation/perf-kmem.txt (revision b85d45947951d23cb22d90caecf4c1eb81342c96)
1perf-kmem(1)
2============
3
4NAME
5----
6perf-kmem - Tool to trace/measure kernel memory properties
7
8SYNOPSIS
9--------
10[verse]
11'perf kmem' {record|stat} [<options>]
12
13DESCRIPTION
14-----------
15There 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
22OPTIONS
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
64SEE ALSO
65--------
66linkperf:perf-record[1]
67