add new system file

hc

2024-02-20 102a0743326a03cd1a1202ceda21e175b7d3575c

 kernel/tools/perf/Documentation/perf-ftrace.txt
..
..
@@ -24,15 +24,28 @@
24
24
 
25
25
 -t::
26
26
 --tracer=::
27
-	Tracer to use: function_graph or function.
27
+	Tracer to use when neither -G nor -F option is not
28
+	specified: function_graph or function.
28
29
 
29
30
 -v::
30
31
 --verbose=::
31
32
         Verbosity level.
32
33
 
34
+-F::
35
+--funcs::
36
+        List available functions to trace. It accepts a pattern to
37
+        only list interested functions.
38
+
33
39
 -p::
34
40
 --pid=::
35
41
 	Trace on existing process id (comma separated list).
42
+
43
+--tid=::
44
+	Trace on existing thread id (comma separated list).
45
+
46
+-D::
47
+--delay::
48
+	Time (ms) to wait before starting tracing after program start.
36
49
 
37
50
 -a::
38
51
 --all-cpus::
..
..
@@ -48,39 +61,58 @@
48
61
 	Ranges of CPUs are specified with -: 0-2.
49
62
 	Default is to trace on all online CPUs.
50
63
 
64
+-m::
65
+--buffer-size::
66
+	Set the size of per-cpu tracing buffer, <size> is expected to
67
+	be a number with appended unit character - B/K/M/G.
68
+
69
+--inherit::
70
+	Trace children processes spawned by our target.
71
+
51
72
 -T::
52
73
 --trace-funcs=::
53
-	Only trace functions given by the argument.  Multiple functions
54
-	can be given by using this option more than once.  The function
55
-	argument also can be a glob pattern.  It will be passed to
56
-	'set_ftrace_filter' in tracefs.
74
+	Select function tracer and set function filter on the given
75
+	function (or a glob pattern). Multiple functions can be given
76
+	by using this option more than once. The function argument also
77
+	can be a glob pattern. It will be passed to 'set_ftrace_filter'
78
+	in tracefs.
57
79
 
58
80
 -N::
59
81
 --notrace-funcs=::
60
-	Do not trace functions given by the argument.  Like -T option,
61
-	this can be used more than once to specify multiple functions
62
-	(or glob patterns).  It will be passed to 'set_ftrace_notrace'
63
-	in tracefs.
82
+	Select function tracer and do not trace functions given by the
83
+	argument.  Like -T option, this can be used more than once to
84
+	specify multiple functions (or glob patterns).  It will be
85
+	passed to 'set_ftrace_notrace' in tracefs.
86
+
87
+--func-opts::
88
+	List of options allowed to set:
89
+	  call-graph - Display kernel stack trace for function tracer.
90
+	  irq-info   - Display irq context info for function tracer.
64
91
 
65
92
 -G::
66
93
 --graph-funcs=::
67
-	Set graph filter on the given function (or a glob pattern).
68
-	This is useful for the function_graph tracer only and enables
69
-	tracing for functions executed from the given function.
70
-	This can be used more than once to specify multiple functions.
71
-	It will be passed to 'set_graph_function' in tracefs.
94
+	Select function_graph tracer and set graph filter on the given
95
+	function (or a glob pattern). This is useful to trace for
96
+	functions executed from the given function. This can be used more
97
+	than once to specify multiple functions. It will be passed to
98
+	'set_graph_function' in tracefs.
72
99
 
73
100
 -g::
74
101
 --nograph-funcs=::
75
-	Set graph notrace filter on the given function (or a glob pattern).
76
-	Like -G option, this is useful for the function_graph tracer only
77
-	and disables tracing for function executed from the given function.
78
-	This can be used more than once to specify multiple functions.
79
-	It will be passed to 'set_graph_notrace' in tracefs.
102
+	Select function_graph tracer and set graph notrace filter on the
103
+	given function (or a glob pattern). Like -G option, this is useful
104
+	for the function_graph tracer only and disables tracing for function
105
+	executed from the given function. This can be used more than once to
106
+	specify multiple functions. It will be passed to 'set_graph_notrace'
107
+	in tracefs.
80
108
 
81
--D::
82
---graph-depth=::
83
-	Set max depth for function graph tracer to follow
109
+--graph-opts::
110
+	List of options allowed to set:
111
+	  nosleep-time - Measure on-CPU time only for function_graph tracer.
112
+	  noirqs       - Ignore functions that happen inside interrupt.
113
+	  verbose      - Show process names, PIDs, timestamps, etc.
114
+	  thresh=<n>   - Setup trace duration threshold in microseconds.
115
+	  depth=<n>    - Set max depth for function graph tracer to follow.
84
116
 
85
117
 SEE ALSO
86
118
 --------