projects / linux-2.6-block.git / blame
| Commit | Line | Data |
|---|---|---|
| b23d5767 | 1 | perf-kmem(1) |
| 4778e0e8 | 2 | ============ |
| b23d5767 LZ |
3 | |
| 4 | NAME | |
| 5 | ---- | |
| 0d68bc92 | 6 | perf-kmem - Tool to trace/measure kernel memory properties |
| b23d5767 LZ |
7 | |
| 8 | SYNOPSIS | |
| 9 | -------- | |
| 10 | [verse] | |
| f792cf8a | 11 | 'perf kmem' [<options>] {record|stat} |
| b23d5767 LZ |
12 | |
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| 90b86a9f | 15 | There are two variants of perf kmem: |
| b23d5767 | 16 | |
| f792cf8a IR |
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. | |
| b23d5767 | 21 | |
| f792cf8a | 22 | 'perf kmem [<options>] stat' to report kernel memory statistics. |
| b23d5767 LZ |
23 | |
| 24 | OPTIONS | |
| 25 | ------- | |
| 26 | -i <file>:: | |
| 27 | --input=<file>:: | |
| f792cf8a IR |
28 | For stat, select the input file (default: perf.data unless stdin is a |
| 29 | fifo) | |
| b23d5767 | 30 | |
| 577980a0 SH |
31 | -f:: |
| 32 | --force:: | |
| 33 | Don't do ownership validation | |
| 34 | ||
| bd72a33e NK |
35 | -v:: |
| 36 | --verbose:: | |
| 37 | Be more verbose. (show symbol address, etc) | |
| 38 | ||
| 90b86a9f LZ |
39 | --caller:: |
| 40 | Show per-callsite statistics | |
| 41 | ||
| 42 | --alloc:: | |
| 43 | Show per-allocation statistics | |
| b23d5767 LZ |
44 | |
| 45 | -s <key[,key2...]>:: | |
| 46 | --sort=<key[,key2...]>:: | |
| fb4f313d NK |
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. | |
| b23d5767 LZ |
52 | |
| 53 | -l <num>:: | |
| 54 | --line=<num>:: | |
| 55 | Print n lines only | |
| 56 | ||
| 57 | --raw-ip:: | |
| 58 | Print raw ip instead of symbol | |
| 59 | ||
| 0d68bc92 NK |
60 | --slab:: |
| 61 | Analyze SLAB allocator events. | |
| 62 | ||
| 63 | --page:: | |
| 64 | Analyze page allocator events | |
| 65 | ||
| 2a7ef02c NK |
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 | ||
| 577980a0 | 71 | --time=<start>,<stop>:: |
| 2a865bd8 DA |
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 | ||
| b23d5767 LZ |
78 | SEE ALSO |
| 79 | -------- | |
| 80 | linkperf:perf-record[1] |