Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

perf tools docs: Use canonical ftrace path

The canonical location for the tracefs filesystem is at /sys/kernel/tracing.

But, from Documentation/trace/ftrace.rst:

Before 4.1, all ftrace tracing control files were within the debugfs
file system, which is typically located at /sys/kernel/debug/tracing.
For backward compatibility, when mounting the debugfs file system,
the tracefs file system will be automatically mounted at:

/sys/kernel/debug/tracing

A few spots in the perf docs still refer to this older debugfs path, so
let's update them to avoid confusion.

Signed-off-by: Ross Zwisler <zwisler@google.com>
Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Steven Rostedt (VMware) <rostedt@goodmis.org>
Cc: linux-trace-kernel@vger.kernel.org
Link: http://lore.kernel.org/lkml/20230130181915.1113313-5-zwisler@google.com
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>

authored by

Ross Zwisler and committed by
Arnaldo Carvalho de Melo
1df49ef9 28899594

+4 -4
+1 -1
tools/perf/Documentation/perf-list.txt
··· 232 232 sysctl to -1, which allows non root to use these events. 233 233 234 234 For accessing trace point events perf needs to have read access to 235 - /sys/kernel/debug/tracing, even when perf_event_paranoid is in a relaxed 235 + /sys/kernel/tracing, even when perf_event_paranoid is in a relaxed 236 236 setting. 237 237 238 238 TRACING
+1 -1
tools/perf/Documentation/perf-script-perl.txt
··· 55 55 the above option: -a to enable system-wide collection. 56 56 57 57 The format file for the sched_wakeup event defines the following fields 58 - (see /sys/kernel/debug/tracing/events/sched/sched_wakeup/format): 58 + (see /sys/kernel/tracing/events/sched/sched_wakeup/format): 59 59 60 60 ---- 61 61 format:
+2 -2
tools/perf/Documentation/perf-script-python.txt
··· 319 319 process can be generalized to any tracepoint or set of tracepoints 320 320 you're interested in - basically find the tracepoint(s) you're 321 321 interested in by looking at the list of available events shown by 322 - 'perf list' and/or look in /sys/kernel/debug/tracing/events/ for 322 + 'perf list' and/or look in /sys/kernel/tracing/events/ for 323 323 detailed event and field info, record the corresponding trace data 324 324 using 'perf record', passing it the list of interesting events, 325 325 generate a skeleton script using 'perf script -g python' and modify the ··· 449 449 the above option: -a to enable system-wide collection. 450 450 451 451 The format file for the sched_wakeup event defines the following fields 452 - (see /sys/kernel/debug/tracing/events/sched/sched_wakeup/format): 452 + (see /sys/kernel/tracing/events/sched/sched_wakeup/format): 453 453 454 454 ---- 455 455 format: