xref: /linux/tools/perf/Documentation/perf-kmem.txt (revision 34f7c6e7d4396090692a09789db231e12cb4762b)
1perf-kmem(1)
2============
3
4NAME
5----
6perf-kmem - Tool to trace/measure kernel memory properties
7
8SYNOPSIS
9--------
10[verse]
11'perf kmem' [<options>] {record|stat}
12
13DESCRIPTION
14-----------
15There are two variants of perf kmem:
16
17  'perf kmem [<options>] record [<perf-record-options>] <command>' to
18  record the kmem events of an arbitrary workload. Additional 'perf
19  record' options may be specified after record, such as '-o' to
20  change the output file name.
21
22  'perf kmem [<options>] stat' to report kernel memory statistics.
23
24OPTIONS
25-------
26-i <file>::
27--input=<file>::
28	For stat, select the input file (default: perf.data unless stdin is a
29	fifo)
30
31-f::
32--force::
33	Don't do ownership validation
34
35-v::
36--verbose::
37        Be more verbose. (show symbol address, etc)
38
39--caller::
40	Show per-callsite statistics
41
42--alloc::
43	Show per-allocation statistics
44
45-s <key[,key2...]>::
46--sort=<key[,key2...]>::
47	Sort the output (default: 'frag,hit,bytes' for slab and 'bytes,hit'
48	for page).  Available sort keys are 'ptr, callsite, bytes, hit,
49	pingpong, frag' for slab and 'page, callsite, bytes, hit, order,
50	migtype, gfp' for page.  This option should be preceded by one of the
51	mode selection options - i.e. --slab, --page, --alloc and/or --caller.
52
53-l <num>::
54--line=<num>::
55	Print n lines only
56
57--raw-ip::
58	Print raw ip instead of symbol
59
60--slab::
61	Analyze SLAB allocator events.
62
63--page::
64	Analyze page allocator events
65
66--live::
67	Show live page stat.  The perf kmem shows total allocation stat by
68	default, but this option shows live (currently allocated) pages
69	instead.  (This option works with --page option only)
70
71--time=<start>,<stop>::
72	Only analyze samples within given time window: <start>,<stop>. Times
73	have the format seconds.microseconds. If start is not given (i.e., time
74	string is ',x.y') then analysis starts at the beginning of the file. If
75	stop time is not given (i.e, time string is 'x.y,') then analysis goes
76	to end of file.
77
78SEE ALSO
79--------
80linkperf:perf-record[1]
81