| perf-probe.txt (4ba24fef3eb3b142197135223b90ced2f319cd53) | perf-probe.txt (8b72805fd1dbfd697c5d4492d0cf1ebbd994950d) |
|---|---|
| 1perf-probe(1) 2============= 3 4NAME 5---- 6perf-probe - Define new dynamic tracepoints 7 8SYNOPSIS --- 33 unchanged lines hidden (view full) --- 42 43-s:: 44--source=PATH:: 45 Specify path to kernel source. 46 47-v:: 48--verbose:: 49 Be more verbose (show parsed arguments, etc). | 1perf-probe(1) 2============= 3 4NAME 5---- 6perf-probe - Define new dynamic tracepoints 7 8SYNOPSIS --- 33 unchanged lines hidden (view full) --- 42 43-s:: 44--source=PATH:: 45 Specify path to kernel source. 46 47-v:: 48--verbose:: 49 Be more verbose (show parsed arguments, etc). |
| 50 Can not use with -q. |
|
| 50 | 51 |
| 52-q:: 53--quiet:: 54 Be quiet (do not show any messages including errors). 55 Can not use with -v. 56 |
|
| 51-a:: 52--add=:: 53 Define a probe event (see PROBE SYNTAX for detail). 54 55-d:: 56--del=:: 57 Delete probe events. This accepts glob wildcards('*', '?') and character 58 classes(e.g. [a-z], [!A-Z]). --- 32 unchanged lines hidden (view full) --- 91--force:: 92 Forcibly add events with existing name. 93 94-n:: 95--dry-run:: 96 Dry run. With this option, --add and --del doesn't execute actual 97 adding and removal operations. 98 | 57-a:: 58--add=:: 59 Define a probe event (see PROBE SYNTAX for detail). 60 61-d:: 62--del=:: 63 Delete probe events. This accepts glob wildcards('*', '?') and character 64 classes(e.g. [a-z], [!A-Z]). --- 32 unchanged lines hidden (view full) --- 97--force:: 98 Forcibly add events with existing name. 99 100-n:: 101--dry-run:: 102 Dry run. With this option, --add and --del doesn't execute actual 103 adding and removal operations. 104 |
| 99--max-probes:: | 105--max-probes=NUM:: |
| 100 Set the maximum number of probe points for an event. Default is 128. 101 102-x:: 103--exec=PATH:: 104 Specify path to the executable or shared library file for user 105 space tracing. Can also be used with --funcs option. 106 | 106 Set the maximum number of probe points for an event. Default is 128. 107 108-x:: 109--exec=PATH:: 110 Specify path to the executable or shared library file for user 111 space tracing. Can also be used with --funcs option. 112 |
| 113--demangle:: 114 Demangle application symbols. --no-demangle is also available 115 for disabling demangling. 116 |
|
| 107--demangle-kernel:: | 117--demangle-kernel:: |
| 108 Demangle kernel symbols. | 118 Demangle kernel symbols. --no-demangle-kernel is also available 119 for disabling kernel demangling. |
| 109 110In absence of -m/-x options, perf probe checks if the first argument after 111the options is an absolute path name. If its an absolute path, perf probe 112uses it as a target module/target user space binary to probe. 113 114PROBE SYNTAX 115------------ 116Probe points are defined by following syntax. --- 15 unchanged lines hidden (view full) --- 132 133PROBE ARGUMENT 134-------------- 135Each probe argument follows below syntax. 136 137 [NAME=]LOCALVAR|$retval|%REG|@SYMBOL[:TYPE] 138 139'NAME' specifies the name of this argument (optional). You can use the name of local variable, local data structure member (e.g. var->field, var.field2), local array with fixed index (e.g. array[1], var->array[0], var->pointer[2]), or kprobe-tracer argument format (e.g. $retval, %ax, etc). Note that the name of this argument will be set as the last member name if you specify a local data structure member (e.g. field2 for 'var->field1.field2'.) | 120 121In absence of -m/-x options, perf probe checks if the first argument after 122the options is an absolute path name. If its an absolute path, perf probe 123uses it as a target module/target user space binary to probe. 124 125PROBE SYNTAX 126------------ 127Probe points are defined by following syntax. --- 15 unchanged lines hidden (view full) --- 143 144PROBE ARGUMENT 145-------------- 146Each probe argument follows below syntax. 147 148 [NAME=]LOCALVAR|$retval|%REG|@SYMBOL[:TYPE] 149 150'NAME' specifies the name of this argument (optional). You can use the name of local variable, local data structure member (e.g. var->field, var.field2), local array with fixed index (e.g. array[1], var->array[0], var->pointer[2]), or kprobe-tracer argument format (e.g. $retval, %ax, etc). Note that the name of this argument will be set as the last member name if you specify a local data structure member (e.g. field2 for 'var->field1.field2'.) |
| 151'$vars' special argument is also available for NAME, it is expanded to the local variables which can access at given probe point. |
|
| 140'TYPE' casts the type of this argument (optional). If omitted, perf probe automatically set the type based on debuginfo. You can specify 'string' type only for the local variable or structure member which is an array of or a pointer to 'char' or 'unsigned char' type. 141 142On x86 systems %REG is always the short form of the register: for example %AX. %RAX or %EAX is not valid. 143 144LINE SYNTAX 145----------- 146Line range is described by following syntax. 147 --- 63 unchanged lines hidden --- | 152'TYPE' casts the type of this argument (optional). If omitted, perf probe automatically set the type based on debuginfo. You can specify 'string' type only for the local variable or structure member which is an array of or a pointer to 'char' or 'unsigned char' type. 153 154On x86 systems %REG is always the short form of the register: for example %AX. %RAX or %EAX is not valid. 155 156LINE SYNTAX 157----------- 158Line range is described by following syntax. 159 --- 63 unchanged lines hidden --- |