Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/tools/perf/Documentation/perf-kmem.txt
26282 views
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' [<options>] {record|stat}

12


13
DESCRIPTION

14
-----------

15
There 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


24
OPTIONS

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


78
SEE ALSO

79
--------

80
linkperf:perf-record[1]

81


82