1 // SPDX-License-Identifier: GPL-2.0
5 * Builtin record command: Record the profile of a workload
6 * (or a CPU, or a PID) into the perf.data output file - for
7 * later analysis via perf report.
11 #include "util/build-id.h"
12 #include <subcmd/parse-options.h>
13 #include "util/parse-events.h"
14 #include "util/config.h"
16 #include "util/callchain.h"
17 #include "util/cgroup.h"
18 #include "util/header.h"
19 #include "util/event.h"
20 #include "util/evlist.h"
21 #include "util/evsel.h"
22 #include "util/debug.h"
23 #include "util/mmap.h"
24 #include "util/target.h"
25 #include "util/session.h"
26 #include "util/tool.h"
27 #include "util/symbol.h"
28 #include "util/record.h"
29 #include "util/cpumap.h"
30 #include "util/thread_map.h"
31 #include "util/data.h"
32 #include "util/perf_regs.h"
33 #include "util/auxtrace.h"
35 #include "util/parse-branch-options.h"
36 #include "util/parse-regs-options.h"
37 #include "util/perf_api_probe.h"
38 #include "util/llvm-utils.h"
39 #include "util/bpf-loader.h"
40 #include "util/trigger.h"
41 #include "util/perf-hooks.h"
42 #include "util/cpu-set-sched.h"
43 #include "util/synthetic-events.h"
44 #include "util/time-utils.h"
45 #include "util/units.h"
46 #include "util/bpf-event.h"
47 #include "util/util.h"
49 #include "util/clockid.h"
61 #ifdef HAVE_EVENTFD_SUPPORT
62 #include <sys/eventfd.h>
66 #include <sys/types.h>
69 #include <linux/err.h>
70 #include <linux/string.h>
71 #include <linux/time64.h>
72 #include <linux/zalloc.h>
73 #include <linux/bitmap.h>
76 struct switch_output
{
89 struct perf_tool tool
;
90 struct record_opts opts
;
92 struct perf_data data
;
93 struct auxtrace_record
*itr
;
94 struct evlist
*evlist
;
95 struct perf_session
*session
;
96 struct evlist
*sb_evlist
;
99 bool switch_output_event_set
;
102 bool no_buildid_cache
;
103 bool no_buildid_cache_set
;
105 bool timestamp_filename
;
106 bool timestamp_boundary
;
107 struct switch_output switch_output
;
108 unsigned long long samples
;
109 struct mmap_cpu_mask affinity_mask
;
110 unsigned long output_max_size
; /* = 0: unlimited */
113 static volatile int done
;
115 static volatile int auxtrace_record__snapshot_started
;
116 static DEFINE_TRIGGER(auxtrace_snapshot_trigger
);
117 static DEFINE_TRIGGER(switch_output_trigger
);
119 static const char *affinity_tags
[PERF_AFFINITY_MAX
] = {
123 static bool switch_output_signal(struct record
*rec
)
125 return rec
->switch_output
.signal
&&
126 trigger_is_ready(&switch_output_trigger
);
129 static bool switch_output_size(struct record
*rec
)
131 return rec
->switch_output
.size
&&
132 trigger_is_ready(&switch_output_trigger
) &&
133 (rec
->bytes_written
>= rec
->switch_output
.size
);
136 static bool switch_output_time(struct record
*rec
)
138 return rec
->switch_output
.time
&&
139 trigger_is_ready(&switch_output_trigger
);
142 static bool record__output_max_size_exceeded(struct record
*rec
)
144 return rec
->output_max_size
&&
145 (rec
->bytes_written
>= rec
->output_max_size
);
148 static int record__write(struct record
*rec
, struct mmap
*map __maybe_unused
,
149 void *bf
, size_t size
)
151 struct perf_data_file
*file
= &rec
->session
->data
->file
;
153 if (perf_data_file__write(file
, bf
, size
) < 0) {
154 pr_err("failed to write perf data, error: %m\n");
158 rec
->bytes_written
+= size
;
160 if (record__output_max_size_exceeded(rec
) && !done
) {
161 fprintf(stderr
, "[ perf record: perf size limit reached (%" PRIu64
" KB),"
162 " stopping session ]\n",
163 rec
->bytes_written
>> 10);
167 if (switch_output_size(rec
))
168 trigger_hit(&switch_output_trigger
);
173 static int record__aio_enabled(struct record
*rec
);
174 static int record__comp_enabled(struct record
*rec
);
175 static size_t zstd_compress(struct perf_session
*session
, void *dst
, size_t dst_size
,
176 void *src
, size_t src_size
);
178 #ifdef HAVE_AIO_SUPPORT
179 static int record__aio_write(struct aiocb
*cblock
, int trace_fd
,
180 void *buf
, size_t size
, off_t off
)
184 cblock
->aio_fildes
= trace_fd
;
185 cblock
->aio_buf
= buf
;
186 cblock
->aio_nbytes
= size
;
187 cblock
->aio_offset
= off
;
188 cblock
->aio_sigevent
.sigev_notify
= SIGEV_NONE
;
191 rc
= aio_write(cblock
);
194 } else if (errno
!= EAGAIN
) {
195 cblock
->aio_fildes
= -1;
196 pr_err("failed to queue perf data, error: %m\n");
204 static int record__aio_complete(struct mmap
*md
, struct aiocb
*cblock
)
210 ssize_t aio_ret
, written
;
212 aio_errno
= aio_error(cblock
);
213 if (aio_errno
== EINPROGRESS
)
216 written
= aio_ret
= aio_return(cblock
);
218 if (aio_errno
!= EINTR
)
219 pr_err("failed to write perf data, error: %m\n");
223 rem_size
= cblock
->aio_nbytes
- written
;
226 cblock
->aio_fildes
= -1;
228 * md->refcount is incremented in record__aio_pushfn() for
229 * every aio write request started in record__aio_push() so
230 * decrement it because the request is now complete.
232 perf_mmap__put(&md
->core
);
236 * aio write request may require restart with the
237 * reminder if the kernel didn't write whole
240 rem_off
= cblock
->aio_offset
+ written
;
241 rem_buf
= (void *)(cblock
->aio_buf
+ written
);
242 record__aio_write(cblock
, cblock
->aio_fildes
,
243 rem_buf
, rem_size
, rem_off
);
250 static int record__aio_sync(struct mmap
*md
, bool sync_all
)
252 struct aiocb
**aiocb
= md
->aio
.aiocb
;
253 struct aiocb
*cblocks
= md
->aio
.cblocks
;
254 struct timespec timeout
= { 0, 1000 * 1000 * 1 }; /* 1ms */
259 for (i
= 0; i
< md
->aio
.nr_cblocks
; ++i
) {
260 if (cblocks
[i
].aio_fildes
== -1 || record__aio_complete(md
, &cblocks
[i
])) {
267 * Started aio write is not complete yet
268 * so it has to be waited before the
271 aiocb
[i
] = &cblocks
[i
];
278 while (aio_suspend((const struct aiocb
**)aiocb
, md
->aio
.nr_cblocks
, &timeout
)) {
279 if (!(errno
== EAGAIN
|| errno
== EINTR
))
280 pr_err("failed to sync perf data, error: %m\n");
291 static int record__aio_pushfn(struct mmap
*map
, void *to
, void *buf
, size_t size
)
293 struct record_aio
*aio
= to
;
296 * map->core.base data pointed by buf is copied into free map->aio.data[] buffer
297 * to release space in the kernel buffer as fast as possible, calling
298 * perf_mmap__consume() from perf_mmap__push() function.
300 * That lets the kernel to proceed with storing more profiling data into
301 * the kernel buffer earlier than other per-cpu kernel buffers are handled.
303 * Coping can be done in two steps in case the chunk of profiling data
304 * crosses the upper bound of the kernel buffer. In this case we first move
305 * part of data from map->start till the upper bound and then the reminder
306 * from the beginning of the kernel buffer till the end of the data chunk.
309 if (record__comp_enabled(aio
->rec
)) {
310 size
= zstd_compress(aio
->rec
->session
, aio
->data
+ aio
->size
,
311 mmap__mmap_len(map
) - aio
->size
,
314 memcpy(aio
->data
+ aio
->size
, buf
, size
);
319 * Increment map->refcount to guard map->aio.data[] buffer
320 * from premature deallocation because map object can be
321 * released earlier than aio write request started on
322 * map->aio.data[] buffer is complete.
324 * perf_mmap__put() is done at record__aio_complete()
325 * after started aio request completion or at record__aio_push()
326 * if the request failed to start.
328 perf_mmap__get(&map
->core
);
336 static int record__aio_push(struct record
*rec
, struct mmap
*map
, off_t
*off
)
339 int trace_fd
= rec
->session
->data
->file
.fd
;
340 struct record_aio aio
= { .rec
= rec
, .size
= 0 };
343 * Call record__aio_sync() to wait till map->aio.data[] buffer
344 * becomes available after previous aio write operation.
347 idx
= record__aio_sync(map
, false);
348 aio
.data
= map
->aio
.data
[idx
];
349 ret
= perf_mmap__push(map
, &aio
, record__aio_pushfn
);
350 if (ret
!= 0) /* ret > 0 - no data, ret < 0 - error */
354 ret
= record__aio_write(&(map
->aio
.cblocks
[idx
]), trace_fd
, aio
.data
, aio
.size
, *off
);
357 rec
->bytes_written
+= aio
.size
;
358 if (switch_output_size(rec
))
359 trigger_hit(&switch_output_trigger
);
362 * Decrement map->refcount incremented in record__aio_pushfn()
363 * back if record__aio_write() operation failed to start, otherwise
364 * map->refcount is decremented in record__aio_complete() after
365 * aio write operation finishes successfully.
367 perf_mmap__put(&map
->core
);
373 static off_t
record__aio_get_pos(int trace_fd
)
375 return lseek(trace_fd
, 0, SEEK_CUR
);
378 static void record__aio_set_pos(int trace_fd
, off_t pos
)
380 lseek(trace_fd
, pos
, SEEK_SET
);
383 static void record__aio_mmap_read_sync(struct record
*rec
)
386 struct evlist
*evlist
= rec
->evlist
;
387 struct mmap
*maps
= evlist
->mmap
;
389 if (!record__aio_enabled(rec
))
392 for (i
= 0; i
< evlist
->core
.nr_mmaps
; i
++) {
393 struct mmap
*map
= &maps
[i
];
396 record__aio_sync(map
, true);
400 static int nr_cblocks_default
= 1;
401 static int nr_cblocks_max
= 4;
403 static int record__aio_parse(const struct option
*opt
,
407 struct record_opts
*opts
= (struct record_opts
*)opt
->value
;
410 opts
->nr_cblocks
= 0;
413 opts
->nr_cblocks
= strtol(str
, NULL
, 0);
414 if (!opts
->nr_cblocks
)
415 opts
->nr_cblocks
= nr_cblocks_default
;
420 #else /* HAVE_AIO_SUPPORT */
421 static int nr_cblocks_max
= 0;
423 static int record__aio_push(struct record
*rec __maybe_unused
, struct mmap
*map __maybe_unused
,
424 off_t
*off __maybe_unused
)
429 static off_t
record__aio_get_pos(int trace_fd __maybe_unused
)
434 static void record__aio_set_pos(int trace_fd __maybe_unused
, off_t pos __maybe_unused
)
438 static void record__aio_mmap_read_sync(struct record
*rec __maybe_unused
)
443 static int record__aio_enabled(struct record
*rec
)
445 return rec
->opts
.nr_cblocks
> 0;
448 #define MMAP_FLUSH_DEFAULT 1
449 static int record__mmap_flush_parse(const struct option
*opt
,
454 struct record_opts
*opts
= (struct record_opts
*)opt
->value
;
455 static struct parse_tag tags
[] = {
456 { .tag
= 'B', .mult
= 1 },
457 { .tag
= 'K', .mult
= 1 << 10 },
458 { .tag
= 'M', .mult
= 1 << 20 },
459 { .tag
= 'G', .mult
= 1 << 30 },
467 opts
->mmap_flush
= parse_tag_value(str
, tags
);
468 if (opts
->mmap_flush
== (int)-1)
469 opts
->mmap_flush
= strtol(str
, NULL
, 0);
472 if (!opts
->mmap_flush
)
473 opts
->mmap_flush
= MMAP_FLUSH_DEFAULT
;
475 flush_max
= evlist__mmap_size(opts
->mmap_pages
);
477 if (opts
->mmap_flush
> flush_max
)
478 opts
->mmap_flush
= flush_max
;
483 #ifdef HAVE_ZSTD_SUPPORT
484 static unsigned int comp_level_default
= 1;
486 static int record__parse_comp_level(const struct option
*opt
, const char *str
, int unset
)
488 struct record_opts
*opts
= opt
->value
;
491 opts
->comp_level
= 0;
494 opts
->comp_level
= strtol(str
, NULL
, 0);
495 if (!opts
->comp_level
)
496 opts
->comp_level
= comp_level_default
;
502 static unsigned int comp_level_max
= 22;
504 static int record__comp_enabled(struct record
*rec
)
506 return rec
->opts
.comp_level
> 0;
509 static int process_synthesized_event(struct perf_tool
*tool
,
510 union perf_event
*event
,
511 struct perf_sample
*sample __maybe_unused
,
512 struct machine
*machine __maybe_unused
)
514 struct record
*rec
= container_of(tool
, struct record
, tool
);
515 return record__write(rec
, NULL
, event
, event
->header
.size
);
518 static int process_locked_synthesized_event(struct perf_tool
*tool
,
519 union perf_event
*event
,
520 struct perf_sample
*sample __maybe_unused
,
521 struct machine
*machine __maybe_unused
)
523 static pthread_mutex_t synth_lock
= PTHREAD_MUTEX_INITIALIZER
;
526 pthread_mutex_lock(&synth_lock
);
527 ret
= process_synthesized_event(tool
, event
, sample
, machine
);
528 pthread_mutex_unlock(&synth_lock
);
532 static int record__pushfn(struct mmap
*map
, void *to
, void *bf
, size_t size
)
534 struct record
*rec
= to
;
536 if (record__comp_enabled(rec
)) {
537 size
= zstd_compress(rec
->session
, map
->data
, mmap__mmap_len(map
), bf
, size
);
542 return record__write(rec
, map
, bf
, size
);
545 static volatile int signr
= -1;
546 static volatile int child_finished
;
547 #ifdef HAVE_EVENTFD_SUPPORT
548 static int done_fd
= -1;
551 static void sig_handler(int sig
)
559 #ifdef HAVE_EVENTFD_SUPPORT
563 * It is possible for this signal handler to run after done is checked
564 * in the main loop, but before the perf counter fds are polled. If this
565 * happens, the poll() will continue to wait even though done is set,
566 * and will only break out if either another signal is received, or the
567 * counters are ready for read. To ensure the poll() doesn't sleep when
568 * done is set, use an eventfd (done_fd) to wake up the poll().
570 if (write(done_fd
, &tmp
, sizeof(tmp
)) < 0)
571 pr_err("failed to signal wakeup fd, error: %m\n");
573 #endif // HAVE_EVENTFD_SUPPORT
576 static void sigsegv_handler(int sig
)
578 perf_hooks__recover();
579 sighandler_dump_stack(sig
);
582 static void record__sig_exit(void)
587 signal(signr
, SIG_DFL
);
591 #ifdef HAVE_AUXTRACE_SUPPORT
593 static int record__process_auxtrace(struct perf_tool
*tool
,
595 union perf_event
*event
, void *data1
,
596 size_t len1
, void *data2
, size_t len2
)
598 struct record
*rec
= container_of(tool
, struct record
, tool
);
599 struct perf_data
*data
= &rec
->data
;
603 if (!perf_data__is_pipe(data
) && perf_data__is_single_file(data
)) {
605 int fd
= perf_data__fd(data
);
608 file_offset
= lseek(fd
, 0, SEEK_CUR
);
609 if (file_offset
== -1)
611 err
= auxtrace_index__auxtrace_event(&rec
->session
->auxtrace_index
,
617 /* event.auxtrace.size includes padding, see __auxtrace_mmap__read() */
618 padding
= (len1
+ len2
) & 7;
620 padding
= 8 - padding
;
622 record__write(rec
, map
, event
, event
->header
.size
);
623 record__write(rec
, map
, data1
, len1
);
625 record__write(rec
, map
, data2
, len2
);
626 record__write(rec
, map
, &pad
, padding
);
631 static int record__auxtrace_mmap_read(struct record
*rec
,
636 ret
= auxtrace_mmap__read(map
, rec
->itr
, &rec
->tool
,
637 record__process_auxtrace
);
647 static int record__auxtrace_mmap_read_snapshot(struct record
*rec
,
652 ret
= auxtrace_mmap__read_snapshot(map
, rec
->itr
, &rec
->tool
,
653 record__process_auxtrace
,
654 rec
->opts
.auxtrace_snapshot_size
);
664 static int record__auxtrace_read_snapshot_all(struct record
*rec
)
669 for (i
= 0; i
< rec
->evlist
->core
.nr_mmaps
; i
++) {
670 struct mmap
*map
= &rec
->evlist
->mmap
[i
];
672 if (!map
->auxtrace_mmap
.base
)
675 if (record__auxtrace_mmap_read_snapshot(rec
, map
) != 0) {
684 static void record__read_auxtrace_snapshot(struct record
*rec
, bool on_exit
)
686 pr_debug("Recording AUX area tracing snapshot\n");
687 if (record__auxtrace_read_snapshot_all(rec
) < 0) {
688 trigger_error(&auxtrace_snapshot_trigger
);
690 if (auxtrace_record__snapshot_finish(rec
->itr
, on_exit
))
691 trigger_error(&auxtrace_snapshot_trigger
);
693 trigger_ready(&auxtrace_snapshot_trigger
);
697 static int record__auxtrace_snapshot_exit(struct record
*rec
)
699 if (trigger_is_error(&auxtrace_snapshot_trigger
))
702 if (!auxtrace_record__snapshot_started
&&
703 auxtrace_record__snapshot_start(rec
->itr
))
706 record__read_auxtrace_snapshot(rec
, true);
707 if (trigger_is_error(&auxtrace_snapshot_trigger
))
713 static int record__auxtrace_init(struct record
*rec
)
718 rec
->itr
= auxtrace_record__init(rec
->evlist
, &err
);
723 err
= auxtrace_parse_snapshot_options(rec
->itr
, &rec
->opts
,
724 rec
->opts
.auxtrace_snapshot_opts
);
728 err
= auxtrace_parse_sample_options(rec
->itr
, rec
->evlist
, &rec
->opts
,
729 rec
->opts
.auxtrace_sample_opts
);
733 return auxtrace_parse_filters(rec
->evlist
);
739 int record__auxtrace_mmap_read(struct record
*rec __maybe_unused
,
740 struct mmap
*map __maybe_unused
)
746 void record__read_auxtrace_snapshot(struct record
*rec __maybe_unused
,
747 bool on_exit __maybe_unused
)
752 int auxtrace_record__snapshot_start(struct auxtrace_record
*itr __maybe_unused
)
758 int record__auxtrace_snapshot_exit(struct record
*rec __maybe_unused
)
763 static int record__auxtrace_init(struct record
*rec __maybe_unused
)
770 static int record__config_text_poke(struct evlist
*evlist
)
775 /* Nothing to do if text poke is already configured */
776 evlist__for_each_entry(evlist
, evsel
) {
777 if (evsel
->core
.attr
.text_poke
)
781 err
= parse_events(evlist
, "dummy:u", NULL
);
785 evsel
= evlist__last(evlist
);
787 evsel
->core
.attr
.freq
= 0;
788 evsel
->core
.attr
.sample_period
= 1;
789 evsel
->core
.attr
.text_poke
= 1;
790 evsel
->core
.attr
.ksymbol
= 1;
792 evsel
->core
.system_wide
= true;
793 evsel
->no_aux_samples
= true;
794 evsel
->immediate
= true;
796 /* Text poke must be collected on all CPUs */
797 perf_cpu_map__put(evsel
->core
.own_cpus
);
798 evsel
->core
.own_cpus
= perf_cpu_map__new(NULL
);
799 perf_cpu_map__put(evsel
->core
.cpus
);
800 evsel
->core
.cpus
= perf_cpu_map__get(evsel
->core
.own_cpus
);
802 evsel__set_sample_bit(evsel
, TIME
);
807 static bool record__kcore_readable(struct machine
*machine
)
809 char kcore
[PATH_MAX
];
812 scnprintf(kcore
, sizeof(kcore
), "%s/proc/kcore", machine
->root_dir
);
814 fd
= open(kcore
, O_RDONLY
);
823 static int record__kcore_copy(struct machine
*machine
, struct perf_data
*data
)
825 char from_dir
[PATH_MAX
];
826 char kcore_dir
[PATH_MAX
];
829 snprintf(from_dir
, sizeof(from_dir
), "%s/proc", machine
->root_dir
);
831 ret
= perf_data__make_kcore_dir(data
, kcore_dir
, sizeof(kcore_dir
));
835 return kcore_copy(from_dir
, kcore_dir
);
838 static int record__mmap_evlist(struct record
*rec
,
839 struct evlist
*evlist
)
841 struct record_opts
*opts
= &rec
->opts
;
842 bool auxtrace_overwrite
= opts
->auxtrace_snapshot_mode
||
843 opts
->auxtrace_sample_mode
;
846 if (opts
->affinity
!= PERF_AFFINITY_SYS
)
847 cpu__setup_cpunode_map();
849 if (evlist__mmap_ex(evlist
, opts
->mmap_pages
,
850 opts
->auxtrace_mmap_pages
,
852 opts
->nr_cblocks
, opts
->affinity
,
853 opts
->mmap_flush
, opts
->comp_level
) < 0) {
854 if (errno
== EPERM
) {
855 pr_err("Permission error mapping pages.\n"
856 "Consider increasing "
857 "/proc/sys/kernel/perf_event_mlock_kb,\n"
858 "or try again with a smaller value of -m/--mmap_pages.\n"
859 "(current value: %u,%u)\n",
860 opts
->mmap_pages
, opts
->auxtrace_mmap_pages
);
863 pr_err("failed to mmap with %d (%s)\n", errno
,
864 str_error_r(errno
, msg
, sizeof(msg
)));
874 static int record__mmap(struct record
*rec
)
876 return record__mmap_evlist(rec
, rec
->evlist
);
879 static int record__open(struct record
*rec
)
883 struct evlist
*evlist
= rec
->evlist
;
884 struct perf_session
*session
= rec
->session
;
885 struct record_opts
*opts
= &rec
->opts
;
889 * For initial_delay or system wide, we need to add a dummy event so
890 * that we can track PERF_RECORD_MMAP to cover the delay of waiting or
893 if (opts
->initial_delay
|| target__has_cpu(&opts
->target
)) {
894 pos
= evlist__get_tracking_event(evlist
);
895 if (!evsel__is_dummy_event(pos
)) {
896 /* Set up dummy event. */
897 if (evlist__add_dummy(evlist
))
899 pos
= evlist__last(evlist
);
900 evlist__set_tracking_event(evlist
, pos
);
904 * Enable the dummy event when the process is forked for
905 * initial_delay, immediately for system wide.
907 if (opts
->initial_delay
&& !pos
->immediate
)
908 pos
->core
.attr
.enable_on_exec
= 1;
913 evlist__config(evlist
, opts
, &callchain_param
);
915 evlist__for_each_entry(evlist
, pos
) {
917 if (evsel__open(pos
, pos
->core
.cpus
, pos
->core
.threads
) < 0) {
918 if (evsel__fallback(pos
, errno
, msg
, sizeof(msg
))) {
920 ui__warning("%s\n", msg
);
923 if ((errno
== EINVAL
|| errno
== EBADF
) &&
924 pos
->leader
!= pos
&&
926 pos
= evlist__reset_weak_group(evlist
, pos
, true);
930 evsel__open_strerror(pos
, &opts
->target
, errno
, msg
, sizeof(msg
));
931 ui__error("%s\n", msg
);
935 pos
->supported
= true;
938 if (symbol_conf
.kptr_restrict
&& !evlist__exclude_kernel(evlist
)) {
940 "WARNING: Kernel address maps (/proc/{kallsyms,modules}) are restricted,\n"
941 "check /proc/sys/kernel/kptr_restrict and /proc/sys/kernel/perf_event_paranoid.\n\n"
942 "Samples in kernel functions may not be resolved if a suitable vmlinux\n"
943 "file is not found in the buildid cache or in the vmlinux path.\n\n"
944 "Samples in kernel modules won't be resolved at all.\n\n"
945 "If some relocation was applied (e.g. kexec) symbols may be misresolved\n"
946 "even with a suitable vmlinux or kallsyms file.\n\n");
949 if (evlist__apply_filters(evlist
, &pos
)) {
950 pr_err("failed to set filter \"%s\" on event %s with %d (%s)\n",
951 pos
->filter
, evsel__name(pos
), errno
,
952 str_error_r(errno
, msg
, sizeof(msg
)));
957 rc
= record__mmap(rec
);
961 session
->evlist
= evlist
;
962 perf_session__set_id_hdr_size(session
);
967 static int process_sample_event(struct perf_tool
*tool
,
968 union perf_event
*event
,
969 struct perf_sample
*sample
,
971 struct machine
*machine
)
973 struct record
*rec
= container_of(tool
, struct record
, tool
);
975 if (rec
->evlist
->first_sample_time
== 0)
976 rec
->evlist
->first_sample_time
= sample
->time
;
978 rec
->evlist
->last_sample_time
= sample
->time
;
980 if (rec
->buildid_all
)
984 return build_id__mark_dso_hit(tool
, event
, sample
, evsel
, machine
);
987 static int process_buildids(struct record
*rec
)
989 struct perf_session
*session
= rec
->session
;
991 if (perf_data__size(&rec
->data
) == 0)
995 * During this process, it'll load kernel map and replace the
996 * dso->long_name to a real pathname it found. In this case
997 * we prefer the vmlinux path like
998 * /lib/modules/3.16.4/build/vmlinux
1000 * rather than build-id path (in debug directory).
1001 * $HOME/.debug/.build-id/f0/6e17aa50adf4d00b88925e03775de107611551
1003 symbol_conf
.ignore_vmlinux_buildid
= true;
1006 * If --buildid-all is given, it marks all DSO regardless of hits,
1007 * so no need to process samples. But if timestamp_boundary is enabled,
1008 * it still needs to walk on all samples to get the timestamps of
1009 * first/last samples.
1011 if (rec
->buildid_all
&& !rec
->timestamp_boundary
)
1012 rec
->tool
.sample
= NULL
;
1014 return perf_session__process_events(session
);
1017 static void perf_event__synthesize_guest_os(struct machine
*machine
, void *data
)
1020 struct perf_tool
*tool
= data
;
1022 *As for guest kernel when processing subcommand record&report,
1023 *we arrange module mmap prior to guest kernel mmap and trigger
1024 *a preload dso because default guest module symbols are loaded
1025 *from guest kallsyms instead of /lib/modules/XXX/XXX. This
1026 *method is used to avoid symbol missing when the first addr is
1027 *in module instead of in guest kernel.
1029 err
= perf_event__synthesize_modules(tool
, process_synthesized_event
,
1032 pr_err("Couldn't record guest kernel [%d]'s reference"
1033 " relocation symbol.\n", machine
->pid
);
1036 * We use _stext for guest kernel because guest kernel's /proc/kallsyms
1037 * have no _text sometimes.
1039 err
= perf_event__synthesize_kernel_mmap(tool
, process_synthesized_event
,
1042 pr_err("Couldn't record guest kernel [%d]'s reference"
1043 " relocation symbol.\n", machine
->pid
);
1046 static struct perf_event_header finished_round_event
= {
1047 .size
= sizeof(struct perf_event_header
),
1048 .type
= PERF_RECORD_FINISHED_ROUND
,
1051 static void record__adjust_affinity(struct record
*rec
, struct mmap
*map
)
1053 if (rec
->opts
.affinity
!= PERF_AFFINITY_SYS
&&
1054 !bitmap_equal(rec
->affinity_mask
.bits
, map
->affinity_mask
.bits
,
1055 rec
->affinity_mask
.nbits
)) {
1056 bitmap_zero(rec
->affinity_mask
.bits
, rec
->affinity_mask
.nbits
);
1057 bitmap_or(rec
->affinity_mask
.bits
, rec
->affinity_mask
.bits
,
1058 map
->affinity_mask
.bits
, rec
->affinity_mask
.nbits
);
1059 sched_setaffinity(0, MMAP_CPU_MASK_BYTES(&rec
->affinity_mask
),
1060 (cpu_set_t
*)rec
->affinity_mask
.bits
);
1062 mmap_cpu_mask__scnprintf(&rec
->affinity_mask
, "thread");
1066 static size_t process_comp_header(void *record
, size_t increment
)
1068 struct perf_record_compressed
*event
= record
;
1069 size_t size
= sizeof(*event
);
1072 event
->header
.size
+= increment
;
1076 event
->header
.type
= PERF_RECORD_COMPRESSED
;
1077 event
->header
.size
= size
;
1082 static size_t zstd_compress(struct perf_session
*session
, void *dst
, size_t dst_size
,
1083 void *src
, size_t src_size
)
1086 size_t max_record_size
= PERF_SAMPLE_MAX_SIZE
- sizeof(struct perf_record_compressed
) - 1;
1088 compressed
= zstd_compress_stream_to_records(&session
->zstd_data
, dst
, dst_size
, src
, src_size
,
1089 max_record_size
, process_comp_header
);
1091 session
->bytes_transferred
+= src_size
;
1092 session
->bytes_compressed
+= compressed
;
1097 static int record__mmap_read_evlist(struct record
*rec
, struct evlist
*evlist
,
1098 bool overwrite
, bool synch
)
1100 u64 bytes_written
= rec
->bytes_written
;
1104 int trace_fd
= rec
->data
.file
.fd
;
1110 maps
= overwrite
? evlist
->overwrite_mmap
: evlist
->mmap
;
1114 if (overwrite
&& evlist
->bkw_mmap_state
!= BKW_MMAP_DATA_PENDING
)
1117 if (record__aio_enabled(rec
))
1118 off
= record__aio_get_pos(trace_fd
);
1120 for (i
= 0; i
< evlist
->core
.nr_mmaps
; i
++) {
1122 struct mmap
*map
= &maps
[i
];
1124 if (map
->core
.base
) {
1125 record__adjust_affinity(rec
, map
);
1127 flush
= map
->core
.flush
;
1128 map
->core
.flush
= 1;
1130 if (!record__aio_enabled(rec
)) {
1131 if (perf_mmap__push(map
, rec
, record__pushfn
) < 0) {
1133 map
->core
.flush
= flush
;
1138 if (record__aio_push(rec
, map
, &off
) < 0) {
1139 record__aio_set_pos(trace_fd
, off
);
1141 map
->core
.flush
= flush
;
1147 map
->core
.flush
= flush
;
1150 if (map
->auxtrace_mmap
.base
&& !rec
->opts
.auxtrace_snapshot_mode
&&
1151 !rec
->opts
.auxtrace_sample_mode
&&
1152 record__auxtrace_mmap_read(rec
, map
) != 0) {
1158 if (record__aio_enabled(rec
))
1159 record__aio_set_pos(trace_fd
, off
);
1162 * Mark the round finished in case we wrote
1163 * at least one event.
1165 if (bytes_written
!= rec
->bytes_written
)
1166 rc
= record__write(rec
, NULL
, &finished_round_event
, sizeof(finished_round_event
));
1169 evlist__toggle_bkw_mmap(evlist
, BKW_MMAP_EMPTY
);
1174 static int record__mmap_read_all(struct record
*rec
, bool synch
)
1178 err
= record__mmap_read_evlist(rec
, rec
->evlist
, false, synch
);
1182 return record__mmap_read_evlist(rec
, rec
->evlist
, true, synch
);
1185 static void record__init_features(struct record
*rec
)
1187 struct perf_session
*session
= rec
->session
;
1190 for (feat
= HEADER_FIRST_FEATURE
; feat
< HEADER_LAST_FEATURE
; feat
++)
1191 perf_header__set_feat(&session
->header
, feat
);
1193 if (rec
->no_buildid
)
1194 perf_header__clear_feat(&session
->header
, HEADER_BUILD_ID
);
1196 if (!have_tracepoints(&rec
->evlist
->core
.entries
))
1197 perf_header__clear_feat(&session
->header
, HEADER_TRACING_DATA
);
1199 if (!rec
->opts
.branch_stack
)
1200 perf_header__clear_feat(&session
->header
, HEADER_BRANCH_STACK
);
1202 if (!rec
->opts
.full_auxtrace
)
1203 perf_header__clear_feat(&session
->header
, HEADER_AUXTRACE
);
1205 if (!(rec
->opts
.use_clockid
&& rec
->opts
.clockid_res_ns
))
1206 perf_header__clear_feat(&session
->header
, HEADER_CLOCKID
);
1208 if (!rec
->opts
.use_clockid
)
1209 perf_header__clear_feat(&session
->header
, HEADER_CLOCK_DATA
);
1211 perf_header__clear_feat(&session
->header
, HEADER_DIR_FORMAT
);
1212 if (!record__comp_enabled(rec
))
1213 perf_header__clear_feat(&session
->header
, HEADER_COMPRESSED
);
1215 perf_header__clear_feat(&session
->header
, HEADER_STAT
);
1219 record__finish_output(struct record
*rec
)
1221 struct perf_data
*data
= &rec
->data
;
1222 int fd
= perf_data__fd(data
);
1227 rec
->session
->header
.data_size
+= rec
->bytes_written
;
1228 data
->file
.size
= lseek(perf_data__fd(data
), 0, SEEK_CUR
);
1230 if (!rec
->no_buildid
) {
1231 process_buildids(rec
);
1233 if (rec
->buildid_all
)
1234 dsos__hit_all(rec
->session
);
1236 perf_session__write_header(rec
->session
, rec
->evlist
, fd
, true);
1241 static int record__synthesize_workload(struct record
*rec
, bool tail
)
1244 struct perf_thread_map
*thread_map
;
1246 if (rec
->opts
.tail_synthesize
!= tail
)
1249 thread_map
= thread_map__new_by_tid(rec
->evlist
->workload
.pid
);
1250 if (thread_map
== NULL
)
1253 err
= perf_event__synthesize_thread_map(&rec
->tool
, thread_map
,
1254 process_synthesized_event
,
1255 &rec
->session
->machines
.host
,
1256 rec
->opts
.sample_address
);
1257 perf_thread_map__put(thread_map
);
1261 static int record__synthesize(struct record
*rec
, bool tail
);
1264 record__switch_output(struct record
*rec
, bool at_exit
)
1266 struct perf_data
*data
= &rec
->data
;
1270 /* Same Size: "2015122520103046"*/
1271 char timestamp
[] = "InvalidTimestamp";
1273 record__aio_mmap_read_sync(rec
);
1275 record__synthesize(rec
, true);
1276 if (target__none(&rec
->opts
.target
))
1277 record__synthesize_workload(rec
, true);
1280 record__finish_output(rec
);
1281 err
= fetch_current_timestamp(timestamp
, sizeof(timestamp
));
1283 pr_err("Failed to get current timestamp\n");
1287 fd
= perf_data__switch(data
, timestamp
,
1288 rec
->session
->header
.data_offset
,
1289 at_exit
, &new_filename
);
1290 if (fd
>= 0 && !at_exit
) {
1291 rec
->bytes_written
= 0;
1292 rec
->session
->header
.data_size
= 0;
1296 fprintf(stderr
, "[ perf record: Dump %s.%s ]\n",
1297 data
->path
, timestamp
);
1299 if (rec
->switch_output
.num_files
) {
1300 int n
= rec
->switch_output
.cur_file
+ 1;
1302 if (n
>= rec
->switch_output
.num_files
)
1304 rec
->switch_output
.cur_file
= n
;
1305 if (rec
->switch_output
.filenames
[n
]) {
1306 remove(rec
->switch_output
.filenames
[n
]);
1307 zfree(&rec
->switch_output
.filenames
[n
]);
1309 rec
->switch_output
.filenames
[n
] = new_filename
;
1314 /* Output tracking events */
1316 record__synthesize(rec
, false);
1319 * In 'perf record --switch-output' without -a,
1320 * record__synthesize() in record__switch_output() won't
1321 * generate tracking events because there's no thread_map
1322 * in evlist. Which causes newly created perf.data doesn't
1323 * contain map and comm information.
1324 * Create a fake thread_map and directly call
1325 * perf_event__synthesize_thread_map() for those events.
1327 if (target__none(&rec
->opts
.target
))
1328 record__synthesize_workload(rec
, false);
1333 static volatile int workload_exec_errno
;
1336 * evlist__prepare_workload will send a SIGUSR1
1337 * if the fork fails, since we asked by setting its
1338 * want_signal to true.
1340 static void workload_exec_failed_signal(int signo __maybe_unused
,
1342 void *ucontext __maybe_unused
)
1344 workload_exec_errno
= info
->si_value
.sival_int
;
1349 static void snapshot_sig_handler(int sig
);
1350 static void alarm_sig_handler(int sig
);
1352 static const struct perf_event_mmap_page
*evlist__pick_pc(struct evlist
*evlist
)
1355 if (evlist
->mmap
&& evlist
->mmap
[0].core
.base
)
1356 return evlist
->mmap
[0].core
.base
;
1357 if (evlist
->overwrite_mmap
&& evlist
->overwrite_mmap
[0].core
.base
)
1358 return evlist
->overwrite_mmap
[0].core
.base
;
1363 static const struct perf_event_mmap_page
*record__pick_pc(struct record
*rec
)
1365 const struct perf_event_mmap_page
*pc
= evlist__pick_pc(rec
->evlist
);
1371 static int record__synthesize(struct record
*rec
, bool tail
)
1373 struct perf_session
*session
= rec
->session
;
1374 struct machine
*machine
= &session
->machines
.host
;
1375 struct perf_data
*data
= &rec
->data
;
1376 struct record_opts
*opts
= &rec
->opts
;
1377 struct perf_tool
*tool
= &rec
->tool
;
1378 int fd
= perf_data__fd(data
);
1380 event_op f
= process_synthesized_event
;
1382 if (rec
->opts
.tail_synthesize
!= tail
)
1385 if (data
->is_pipe
) {
1387 * We need to synthesize events first, because some
1388 * features works on top of them (on report side).
1390 err
= perf_event__synthesize_attrs(tool
, rec
->evlist
,
1391 process_synthesized_event
);
1393 pr_err("Couldn't synthesize attrs.\n");
1397 err
= perf_event__synthesize_features(tool
, session
, rec
->evlist
,
1398 process_synthesized_event
);
1400 pr_err("Couldn't synthesize features.\n");
1404 if (have_tracepoints(&rec
->evlist
->core
.entries
)) {
1406 * FIXME err <= 0 here actually means that
1407 * there were no tracepoints so its not really
1408 * an error, just that we don't need to
1409 * synthesize anything. We really have to
1410 * return this more properly and also
1411 * propagate errors that now are calling die()
1413 err
= perf_event__synthesize_tracing_data(tool
, fd
, rec
->evlist
,
1414 process_synthesized_event
);
1416 pr_err("Couldn't record tracing data.\n");
1419 rec
->bytes_written
+= err
;
1423 err
= perf_event__synth_time_conv(record__pick_pc(rec
), tool
,
1424 process_synthesized_event
, machine
);
1428 /* Synthesize id_index before auxtrace_info */
1429 if (rec
->opts
.auxtrace_sample_mode
) {
1430 err
= perf_event__synthesize_id_index(tool
,
1431 process_synthesized_event
,
1432 session
->evlist
, machine
);
1437 if (rec
->opts
.full_auxtrace
) {
1438 err
= perf_event__synthesize_auxtrace_info(rec
->itr
, tool
,
1439 session
, process_synthesized_event
);
1444 if (!evlist__exclude_kernel(rec
->evlist
)) {
1445 err
= perf_event__synthesize_kernel_mmap(tool
, process_synthesized_event
,
1447 WARN_ONCE(err
< 0, "Couldn't record kernel reference relocation symbol\n"
1448 "Symbol resolution may be skewed if relocation was used (e.g. kexec).\n"
1449 "Check /proc/kallsyms permission or run as root.\n");
1451 err
= perf_event__synthesize_modules(tool
, process_synthesized_event
,
1453 WARN_ONCE(err
< 0, "Couldn't record kernel module information.\n"
1454 "Symbol resolution may be skewed if relocation was used (e.g. kexec).\n"
1455 "Check /proc/modules permission or run as root.\n");
1459 machines__process_guests(&session
->machines
,
1460 perf_event__synthesize_guest_os
, tool
);
1463 err
= perf_event__synthesize_extra_attr(&rec
->tool
,
1465 process_synthesized_event
,
1470 err
= perf_event__synthesize_thread_map2(&rec
->tool
, rec
->evlist
->core
.threads
,
1471 process_synthesized_event
,
1474 pr_err("Couldn't synthesize thread map.\n");
1478 err
= perf_event__synthesize_cpu_map(&rec
->tool
, rec
->evlist
->core
.cpus
,
1479 process_synthesized_event
, NULL
);
1481 pr_err("Couldn't synthesize cpu map.\n");
1485 err
= perf_event__synthesize_bpf_events(session
, process_synthesized_event
,
1488 pr_warning("Couldn't synthesize bpf events.\n");
1490 err
= perf_event__synthesize_cgroups(tool
, process_synthesized_event
,
1493 pr_warning("Couldn't synthesize cgroup events.\n");
1495 if (rec
->opts
.nr_threads_synthesize
> 1) {
1496 perf_set_multithreaded();
1497 f
= process_locked_synthesized_event
;
1500 err
= __machine__synthesize_threads(machine
, tool
, &opts
->target
, rec
->evlist
->core
.threads
,
1501 f
, opts
->sample_address
,
1502 rec
->opts
.nr_threads_synthesize
);
1504 if (rec
->opts
.nr_threads_synthesize
> 1)
1505 perf_set_singlethreaded();
1511 static int record__process_signal_event(union perf_event
*event __maybe_unused
, void *data
)
1513 struct record
*rec
= data
;
1514 pthread_kill(rec
->thread_id
, SIGUSR2
);
1518 static int record__setup_sb_evlist(struct record
*rec
)
1520 struct record_opts
*opts
= &rec
->opts
;
1522 if (rec
->sb_evlist
!= NULL
) {
1524 * We get here if --switch-output-event populated the
1525 * sb_evlist, so associate a callback that will send a SIGUSR2
1526 * to the main thread.
1528 evlist__set_cb(rec
->sb_evlist
, record__process_signal_event
, rec
);
1529 rec
->thread_id
= pthread_self();
1531 #ifdef HAVE_LIBBPF_SUPPORT
1532 if (!opts
->no_bpf_event
) {
1533 if (rec
->sb_evlist
== NULL
) {
1534 rec
->sb_evlist
= evlist__new();
1536 if (rec
->sb_evlist
== NULL
) {
1537 pr_err("Couldn't create side band evlist.\n.");
1542 if (evlist__add_bpf_sb_event(rec
->sb_evlist
, &rec
->session
->header
.env
)) {
1543 pr_err("Couldn't ask for PERF_RECORD_BPF_EVENT side band events.\n.");
1548 if (evlist__start_sb_thread(rec
->sb_evlist
, &rec
->opts
.target
)) {
1549 pr_debug("Couldn't start the BPF side band thread:\nBPF programs starting from now on won't be annotatable\n");
1550 opts
->no_bpf_event
= true;
1556 static int record__init_clock(struct record
*rec
)
1558 struct perf_session
*session
= rec
->session
;
1559 struct timespec ref_clockid
;
1560 struct timeval ref_tod
;
1563 if (!rec
->opts
.use_clockid
)
1566 if (rec
->opts
.use_clockid
&& rec
->opts
.clockid_res_ns
)
1567 session
->header
.env
.clock
.clockid_res_ns
= rec
->opts
.clockid_res_ns
;
1569 session
->header
.env
.clock
.clockid
= rec
->opts
.clockid
;
1571 if (gettimeofday(&ref_tod
, NULL
) != 0) {
1572 pr_err("gettimeofday failed, cannot set reference time.\n");
1576 if (clock_gettime(rec
->opts
.clockid
, &ref_clockid
)) {
1577 pr_err("clock_gettime failed, cannot set reference time.\n");
1581 ref
= (u64
) ref_tod
.tv_sec
* NSEC_PER_SEC
+
1582 (u64
) ref_tod
.tv_usec
* NSEC_PER_USEC
;
1584 session
->header
.env
.clock
.tod_ns
= ref
;
1586 ref
= (u64
) ref_clockid
.tv_sec
* NSEC_PER_SEC
+
1587 (u64
) ref_clockid
.tv_nsec
;
1589 session
->header
.env
.clock
.clockid_ns
= ref
;
1593 static void hit_auxtrace_snapshot_trigger(struct record
*rec
)
1595 if (trigger_is_ready(&auxtrace_snapshot_trigger
)) {
1596 trigger_hit(&auxtrace_snapshot_trigger
);
1597 auxtrace_record__snapshot_started
= 1;
1598 if (auxtrace_record__snapshot_start(rec
->itr
))
1599 trigger_error(&auxtrace_snapshot_trigger
);
1603 static int __cmd_record(struct record
*rec
, int argc
, const char **argv
)
1607 unsigned long waking
= 0;
1608 const bool forks
= argc
> 0;
1609 struct perf_tool
*tool
= &rec
->tool
;
1610 struct record_opts
*opts
= &rec
->opts
;
1611 struct perf_data
*data
= &rec
->data
;
1612 struct perf_session
*session
;
1613 bool disabled
= false, draining
= false;
1616 enum evlist_ctl_cmd cmd
= EVLIST_CTL_CMD_UNSUPPORTED
;
1618 atexit(record__sig_exit
);
1619 signal(SIGCHLD
, sig_handler
);
1620 signal(SIGINT
, sig_handler
);
1621 signal(SIGTERM
, sig_handler
);
1622 signal(SIGSEGV
, sigsegv_handler
);
1624 if (rec
->opts
.record_namespaces
)
1625 tool
->namespace_events
= true;
1627 if (rec
->opts
.record_cgroup
) {
1628 #ifdef HAVE_FILE_HANDLE
1629 tool
->cgroup_events
= true;
1631 pr_err("cgroup tracking is not supported\n");
1636 if (rec
->opts
.auxtrace_snapshot_mode
|| rec
->switch_output
.enabled
) {
1637 signal(SIGUSR2
, snapshot_sig_handler
);
1638 if (rec
->opts
.auxtrace_snapshot_mode
)
1639 trigger_on(&auxtrace_snapshot_trigger
);
1640 if (rec
->switch_output
.enabled
)
1641 trigger_on(&switch_output_trigger
);
1643 signal(SIGUSR2
, SIG_IGN
);
1646 session
= perf_session__new(data
, false, tool
);
1647 if (IS_ERR(session
)) {
1648 pr_err("Perf session creation failed.\n");
1649 return PTR_ERR(session
);
1652 fd
= perf_data__fd(data
);
1653 rec
->session
= session
;
1655 if (zstd_init(&session
->zstd_data
, rec
->opts
.comp_level
) < 0) {
1656 pr_err("Compression initialization failed.\n");
1659 #ifdef HAVE_EVENTFD_SUPPORT
1660 done_fd
= eventfd(0, EFD_NONBLOCK
);
1662 pr_err("Failed to create wakeup eventfd, error: %m\n");
1664 goto out_delete_session
;
1666 err
= evlist__add_pollfd(rec
->evlist
, done_fd
);
1668 pr_err("Failed to add wakeup eventfd to poll list\n");
1670 goto out_delete_session
;
1672 #endif // HAVE_EVENTFD_SUPPORT
1674 session
->header
.env
.comp_type
= PERF_COMP_ZSTD
;
1675 session
->header
.env
.comp_level
= rec
->opts
.comp_level
;
1677 if (rec
->opts
.kcore
&&
1678 !record__kcore_readable(&session
->machines
.host
)) {
1679 pr_err("ERROR: kcore is not readable.\n");
1683 if (record__init_clock(rec
))
1686 record__init_features(rec
);
1689 err
= evlist__prepare_workload(rec
->evlist
, &opts
->target
, argv
, data
->is_pipe
,
1690 workload_exec_failed_signal
);
1692 pr_err("Couldn't run the workload!\n");
1694 goto out_delete_session
;
1699 * If we have just single event and are sending data
1700 * through pipe, we need to force the ids allocation,
1701 * because we synthesize event name through the pipe
1702 * and need the id for that.
1704 if (data
->is_pipe
&& rec
->evlist
->core
.nr_entries
== 1)
1705 rec
->opts
.sample_id
= true;
1707 if (record__open(rec
) != 0) {
1711 session
->header
.env
.comp_mmap_len
= session
->evlist
->core
.mmap_len
;
1713 if (rec
->opts
.kcore
) {
1714 err
= record__kcore_copy(&session
->machines
.host
, data
);
1716 pr_err("ERROR: Failed to copy kcore\n");
1721 err
= bpf__apply_obj_config();
1723 char errbuf
[BUFSIZ
];
1725 bpf__strerror_apply_obj_config(err
, errbuf
, sizeof(errbuf
));
1726 pr_err("ERROR: Apply config to BPF failed: %s\n",
1732 * Normally perf_session__new would do this, but it doesn't have the
1735 if (rec
->tool
.ordered_events
&& !evlist__sample_id_all(rec
->evlist
)) {
1736 pr_warning("WARNING: No sample_id_all support, falling back to unordered processing\n");
1737 rec
->tool
.ordered_events
= false;
1740 if (!rec
->evlist
->nr_groups
)
1741 perf_header__clear_feat(&session
->header
, HEADER_GROUP_DESC
);
1743 if (data
->is_pipe
) {
1744 err
= perf_header__write_pipe(fd
);
1748 err
= perf_session__write_header(session
, rec
->evlist
, fd
, false);
1754 if (!rec
->no_buildid
1755 && !perf_header__has_feat(&session
->header
, HEADER_BUILD_ID
)) {
1756 pr_err("Couldn't generate buildids. "
1757 "Use --no-buildid to profile anyway.\n");
1761 err
= record__setup_sb_evlist(rec
);
1765 err
= record__synthesize(rec
, false);
1769 if (rec
->realtime_prio
) {
1770 struct sched_param param
;
1772 param
.sched_priority
= rec
->realtime_prio
;
1773 if (sched_setscheduler(0, SCHED_FIFO
, ¶m
)) {
1774 pr_err("Could not set realtime priority.\n");
1781 * When perf is starting the traced process, all the events
1782 * (apart from group members) have enable_on_exec=1 set,
1783 * so don't spoil it by prematurely enabling them.
1785 if (!target__none(&opts
->target
) && !opts
->initial_delay
)
1786 evlist__enable(rec
->evlist
);
1792 struct machine
*machine
= &session
->machines
.host
;
1793 union perf_event
*event
;
1796 event
= malloc(sizeof(event
->comm
) + machine
->id_hdr_size
);
1797 if (event
== NULL
) {
1803 * Some H/W events are generated before COMM event
1804 * which is emitted during exec(), so perf script
1805 * cannot see a correct process name for those events.
1806 * Synthesize COMM event to prevent it.
1808 tgid
= perf_event__synthesize_comm(tool
, event
,
1809 rec
->evlist
->workload
.pid
,
1810 process_synthesized_event
,
1817 event
= malloc(sizeof(event
->namespaces
) +
1818 (NR_NAMESPACES
* sizeof(struct perf_ns_link_info
)) +
1819 machine
->id_hdr_size
);
1820 if (event
== NULL
) {
1826 * Synthesize NAMESPACES event for the command specified.
1828 perf_event__synthesize_namespaces(tool
, event
,
1829 rec
->evlist
->workload
.pid
,
1830 tgid
, process_synthesized_event
,
1834 evlist__start_workload(rec
->evlist
);
1837 if (evlist__initialize_ctlfd(rec
->evlist
, opts
->ctl_fd
, opts
->ctl_fd_ack
))
1840 if (opts
->initial_delay
) {
1841 pr_info(EVLIST_DISABLED_MSG
);
1842 if (opts
->initial_delay
> 0) {
1843 usleep(opts
->initial_delay
* USEC_PER_MSEC
);
1844 evlist__enable(rec
->evlist
);
1845 pr_info(EVLIST_ENABLED_MSG
);
1849 trigger_ready(&auxtrace_snapshot_trigger
);
1850 trigger_ready(&switch_output_trigger
);
1851 perf_hooks__invoke_record_start();
1853 unsigned long long hits
= rec
->samples
;
1856 * rec->evlist->bkw_mmap_state is possible to be
1857 * BKW_MMAP_EMPTY here: when done == true and
1858 * hits != rec->samples in previous round.
1860 * evlist__toggle_bkw_mmap ensure we never
1861 * convert BKW_MMAP_EMPTY to BKW_MMAP_DATA_PENDING.
1863 if (trigger_is_hit(&switch_output_trigger
) || done
|| draining
)
1864 evlist__toggle_bkw_mmap(rec
->evlist
, BKW_MMAP_DATA_PENDING
);
1866 if (record__mmap_read_all(rec
, false) < 0) {
1867 trigger_error(&auxtrace_snapshot_trigger
);
1868 trigger_error(&switch_output_trigger
);
1873 if (auxtrace_record__snapshot_started
) {
1874 auxtrace_record__snapshot_started
= 0;
1875 if (!trigger_is_error(&auxtrace_snapshot_trigger
))
1876 record__read_auxtrace_snapshot(rec
, false);
1877 if (trigger_is_error(&auxtrace_snapshot_trigger
)) {
1878 pr_err("AUX area tracing snapshot failed\n");
1884 if (trigger_is_hit(&switch_output_trigger
)) {
1886 * If switch_output_trigger is hit, the data in
1887 * overwritable ring buffer should have been collected,
1888 * so bkw_mmap_state should be set to BKW_MMAP_EMPTY.
1890 * If SIGUSR2 raise after or during record__mmap_read_all(),
1891 * record__mmap_read_all() didn't collect data from
1892 * overwritable ring buffer. Read again.
1894 if (rec
->evlist
->bkw_mmap_state
== BKW_MMAP_RUNNING
)
1896 trigger_ready(&switch_output_trigger
);
1899 * Reenable events in overwrite ring buffer after
1900 * record__mmap_read_all(): we should have collected
1903 evlist__toggle_bkw_mmap(rec
->evlist
, BKW_MMAP_RUNNING
);
1906 fprintf(stderr
, "[ perf record: dump data: Woken up %ld times ]\n",
1909 fd
= record__switch_output(rec
, false);
1911 pr_err("Failed to switch to new file\n");
1912 trigger_error(&switch_output_trigger
);
1917 /* re-arm the alarm */
1918 if (rec
->switch_output
.time
)
1919 alarm(rec
->switch_output
.time
);
1922 if (hits
== rec
->samples
) {
1923 if (done
|| draining
)
1925 err
= evlist__poll(rec
->evlist
, -1);
1927 * Propagate error, only if there's any. Ignore positive
1928 * number of returned events and interrupt error.
1930 if (err
> 0 || (err
< 0 && errno
== EINTR
))
1934 if (evlist__filter_pollfd(rec
->evlist
, POLLERR
| POLLHUP
) == 0)
1938 if (evlist__ctlfd_process(rec
->evlist
, &cmd
) > 0) {
1940 case EVLIST_CTL_CMD_ENABLE
:
1941 pr_info(EVLIST_ENABLED_MSG
);
1943 case EVLIST_CTL_CMD_DISABLE
:
1944 pr_info(EVLIST_DISABLED_MSG
);
1946 case EVLIST_CTL_CMD_SNAPSHOT
:
1947 hit_auxtrace_snapshot_trigger(rec
);
1948 evlist__ctlfd_ack(rec
->evlist
);
1950 case EVLIST_CTL_CMD_ACK
:
1951 case EVLIST_CTL_CMD_UNSUPPORTED
:
1958 * When perf is starting the traced process, at the end events
1959 * die with the process and we wait for that. Thus no need to
1960 * disable events in this case.
1962 if (done
&& !disabled
&& !target__none(&opts
->target
)) {
1963 trigger_off(&auxtrace_snapshot_trigger
);
1964 evlist__disable(rec
->evlist
);
1969 trigger_off(&auxtrace_snapshot_trigger
);
1970 trigger_off(&switch_output_trigger
);
1972 if (opts
->auxtrace_snapshot_on_exit
)
1973 record__auxtrace_snapshot_exit(rec
);
1975 if (forks
&& workload_exec_errno
) {
1976 char msg
[STRERR_BUFSIZE
];
1977 const char *emsg
= str_error_r(workload_exec_errno
, msg
, sizeof(msg
));
1978 pr_err("Workload failed: %s\n", emsg
);
1984 fprintf(stderr
, "[ perf record: Woken up %ld times to write data ]\n", waking
);
1986 if (target__none(&rec
->opts
.target
))
1987 record__synthesize_workload(rec
, true);
1990 evlist__finalize_ctlfd(rec
->evlist
);
1991 record__mmap_read_all(rec
, true);
1992 record__aio_mmap_read_sync(rec
);
1994 if (rec
->session
->bytes_transferred
&& rec
->session
->bytes_compressed
) {
1995 ratio
= (float)rec
->session
->bytes_transferred
/(float)rec
->session
->bytes_compressed
;
1996 session
->header
.env
.comp_ratio
= ratio
+ 0.5;
2002 if (!child_finished
)
2003 kill(rec
->evlist
->workload
.pid
, SIGTERM
);
2009 else if (WIFEXITED(exit_status
))
2010 status
= WEXITSTATUS(exit_status
);
2011 else if (WIFSIGNALED(exit_status
))
2012 signr
= WTERMSIG(exit_status
);
2016 record__synthesize(rec
, true);
2017 /* this will be recalculated during process_buildids() */
2021 if (!rec
->timestamp_filename
) {
2022 record__finish_output(rec
);
2024 fd
= record__switch_output(rec
, true);
2027 goto out_delete_session
;
2032 perf_hooks__invoke_record_end();
2034 if (!err
&& !quiet
) {
2036 const char *postfix
= rec
->timestamp_filename
?
2037 ".<timestamp>" : "";
2039 if (rec
->samples
&& !rec
->opts
.full_auxtrace
)
2040 scnprintf(samples
, sizeof(samples
),
2041 " (%" PRIu64
" samples)", rec
->samples
);
2045 fprintf(stderr
, "[ perf record: Captured and wrote %.3f MB %s%s%s",
2046 perf_data__size(data
) / 1024.0 / 1024.0,
2047 data
->path
, postfix
, samples
);
2049 fprintf(stderr
, ", compressed (original %.3f MB, ratio is %.3f)",
2050 rec
->session
->bytes_transferred
/ 1024.0 / 1024.0,
2053 fprintf(stderr
, " ]\n");
2057 #ifdef HAVE_EVENTFD_SUPPORT
2061 zstd_fini(&session
->zstd_data
);
2062 perf_session__delete(session
);
2064 if (!opts
->no_bpf_event
)
2065 evlist__stop_sb_thread(rec
->sb_evlist
);
2069 static void callchain_debug(struct callchain_param
*callchain
)
2071 static const char *str
[CALLCHAIN_MAX
] = { "NONE", "FP", "DWARF", "LBR" };
2073 pr_debug("callchain: type %s\n", str
[callchain
->record_mode
]);
2075 if (callchain
->record_mode
== CALLCHAIN_DWARF
)
2076 pr_debug("callchain: stack dump size %d\n",
2077 callchain
->dump_size
);
2080 int record_opts__parse_callchain(struct record_opts
*record
,
2081 struct callchain_param
*callchain
,
2082 const char *arg
, bool unset
)
2085 callchain
->enabled
= !unset
;
2087 /* --no-call-graph */
2089 callchain
->record_mode
= CALLCHAIN_NONE
;
2090 pr_debug("callchain: disabled\n");
2094 ret
= parse_callchain_record_opt(arg
, callchain
);
2096 /* Enable data address sampling for DWARF unwind. */
2097 if (callchain
->record_mode
== CALLCHAIN_DWARF
)
2098 record
->sample_address
= true;
2099 callchain_debug(callchain
);
2105 int record_parse_callchain_opt(const struct option
*opt
,
2109 return record_opts__parse_callchain(opt
->value
, &callchain_param
, arg
, unset
);
2112 int record_callchain_opt(const struct option
*opt
,
2113 const char *arg __maybe_unused
,
2114 int unset __maybe_unused
)
2116 struct callchain_param
*callchain
= opt
->value
;
2118 callchain
->enabled
= true;
2120 if (callchain
->record_mode
== CALLCHAIN_NONE
)
2121 callchain
->record_mode
= CALLCHAIN_FP
;
2123 callchain_debug(callchain
);
2127 static int perf_record_config(const char *var
, const char *value
, void *cb
)
2129 struct record
*rec
= cb
;
2131 if (!strcmp(var
, "record.build-id")) {
2132 if (!strcmp(value
, "cache"))
2133 rec
->no_buildid_cache
= false;
2134 else if (!strcmp(value
, "no-cache"))
2135 rec
->no_buildid_cache
= true;
2136 else if (!strcmp(value
, "skip"))
2137 rec
->no_buildid
= true;
2142 if (!strcmp(var
, "record.call-graph")) {
2143 var
= "call-graph.record-mode";
2144 return perf_default_config(var
, value
, cb
);
2146 #ifdef HAVE_AIO_SUPPORT
2147 if (!strcmp(var
, "record.aio")) {
2148 rec
->opts
.nr_cblocks
= strtol(value
, NULL
, 0);
2149 if (!rec
->opts
.nr_cblocks
)
2150 rec
->opts
.nr_cblocks
= nr_cblocks_default
;
2158 static int record__parse_affinity(const struct option
*opt
, const char *str
, int unset
)
2160 struct record_opts
*opts
= (struct record_opts
*)opt
->value
;
2165 if (!strcasecmp(str
, "node"))
2166 opts
->affinity
= PERF_AFFINITY_NODE
;
2167 else if (!strcasecmp(str
, "cpu"))
2168 opts
->affinity
= PERF_AFFINITY_CPU
;
2173 static int parse_output_max_size(const struct option
*opt
,
2174 const char *str
, int unset
)
2176 unsigned long *s
= (unsigned long *)opt
->value
;
2177 static struct parse_tag tags_size
[] = {
2178 { .tag
= 'B', .mult
= 1 },
2179 { .tag
= 'K', .mult
= 1 << 10 },
2180 { .tag
= 'M', .mult
= 1 << 20 },
2181 { .tag
= 'G', .mult
= 1 << 30 },
2191 val
= parse_tag_value(str
, tags_size
);
2192 if (val
!= (unsigned long) -1) {
2200 static int record__parse_mmap_pages(const struct option
*opt
,
2202 int unset __maybe_unused
)
2204 struct record_opts
*opts
= opt
->value
;
2206 unsigned int mmap_pages
;
2221 ret
= __evlist__parse_mmap_pages(&mmap_pages
, s
);
2224 opts
->mmap_pages
= mmap_pages
;
2232 ret
= __evlist__parse_mmap_pages(&mmap_pages
, p
+ 1);
2236 opts
->auxtrace_mmap_pages
= mmap_pages
;
2243 static int parse_control_option(const struct option
*opt
,
2245 int unset __maybe_unused
)
2247 struct record_opts
*opts
= opt
->value
;
2249 return evlist__parse_control(str
, &opts
->ctl_fd
, &opts
->ctl_fd_ack
, &opts
->ctl_fd_close
);
2252 static void switch_output_size_warn(struct record
*rec
)
2254 u64 wakeup_size
= evlist__mmap_size(rec
->opts
.mmap_pages
);
2255 struct switch_output
*s
= &rec
->switch_output
;
2259 if (s
->size
< wakeup_size
) {
2262 unit_number__scnprintf(buf
, sizeof(buf
), wakeup_size
);
2263 pr_warning("WARNING: switch-output data size lower than "
2264 "wakeup kernel buffer size (%s) "
2265 "expect bigger perf.data sizes\n", buf
);
2269 static int switch_output_setup(struct record
*rec
)
2271 struct switch_output
*s
= &rec
->switch_output
;
2272 static struct parse_tag tags_size
[] = {
2273 { .tag
= 'B', .mult
= 1 },
2274 { .tag
= 'K', .mult
= 1 << 10 },
2275 { .tag
= 'M', .mult
= 1 << 20 },
2276 { .tag
= 'G', .mult
= 1 << 30 },
2279 static struct parse_tag tags_time
[] = {
2280 { .tag
= 's', .mult
= 1 },
2281 { .tag
= 'm', .mult
= 60 },
2282 { .tag
= 'h', .mult
= 60*60 },
2283 { .tag
= 'd', .mult
= 60*60*24 },
2289 * If we're using --switch-output-events, then we imply its
2290 * --switch-output=signal, as we'll send a SIGUSR2 from the side band
2291 * thread to its parent.
2293 if (rec
->switch_output_event_set
)
2299 if (!strcmp(s
->str
, "signal")) {
2302 pr_debug("switch-output with SIGUSR2 signal\n");
2306 val
= parse_tag_value(s
->str
, tags_size
);
2307 if (val
!= (unsigned long) -1) {
2309 pr_debug("switch-output with %s size threshold\n", s
->str
);
2313 val
= parse_tag_value(s
->str
, tags_time
);
2314 if (val
!= (unsigned long) -1) {
2316 pr_debug("switch-output with %s time threshold (%lu seconds)\n",
2324 rec
->timestamp_filename
= true;
2327 if (s
->size
&& !rec
->opts
.no_buffering
)
2328 switch_output_size_warn(rec
);
2333 static const char * const __record_usage
[] = {
2334 "perf record [<options>] [<command>]",
2335 "perf record [<options>] -- <command> [<options>]",
2338 const char * const *record_usage
= __record_usage
;
2340 static int build_id__process_mmap(struct perf_tool
*tool
, union perf_event
*event
,
2341 struct perf_sample
*sample
, struct machine
*machine
)
2344 * We already have the kernel maps, put in place via perf_session__create_kernel_maps()
2345 * no need to add them twice.
2347 if (!(event
->header
.misc
& PERF_RECORD_MISC_USER
))
2349 return perf_event__process_mmap(tool
, event
, sample
, machine
);
2352 static int build_id__process_mmap2(struct perf_tool
*tool
, union perf_event
*event
,
2353 struct perf_sample
*sample
, struct machine
*machine
)
2356 * We already have the kernel maps, put in place via perf_session__create_kernel_maps()
2357 * no need to add them twice.
2359 if (!(event
->header
.misc
& PERF_RECORD_MISC_USER
))
2362 return perf_event__process_mmap2(tool
, event
, sample
, machine
);
2366 * XXX Ideally would be local to cmd_record() and passed to a record__new
2367 * because we need to have access to it in record__exit, that is called
2368 * after cmd_record() exits, but since record_options need to be accessible to
2369 * builtin-script, leave it here.
2371 * At least we don't ouch it in all the other functions here directly.
2373 * Just say no to tons of global variables, sigh.
2375 static struct record record
= {
2377 .sample_time
= true,
2378 .mmap_pages
= UINT_MAX
,
2379 .user_freq
= UINT_MAX
,
2380 .user_interval
= ULLONG_MAX
,
2384 .default_per_cpu
= true,
2386 .mmap_flush
= MMAP_FLUSH_DEFAULT
,
2387 .nr_threads_synthesize
= 1,
2392 .sample
= process_sample_event
,
2393 .fork
= perf_event__process_fork
,
2394 .exit
= perf_event__process_exit
,
2395 .comm
= perf_event__process_comm
,
2396 .namespaces
= perf_event__process_namespaces
,
2397 .mmap
= build_id__process_mmap
,
2398 .mmap2
= build_id__process_mmap2
,
2399 .ordered_events
= true,
2403 const char record_callchain_help
[] = CALLCHAIN_RECORD_HELP
2404 "\n\t\t\t\tDefault: fp";
2406 static bool dry_run
;
2409 * XXX Will stay a global variable till we fix builtin-script.c to stop messing
2410 * with it and switch to use the library functions in perf_evlist that came
2411 * from builtin-record.c, i.e. use record_opts,
2412 * evlist__prepare_workload, etc instead of fork+exec'in 'perf record',
2415 static struct option __record_options
[] = {
2416 OPT_CALLBACK('e', "event", &record
.evlist
, "event",
2417 "event selector. use 'perf list' to list available events",
2418 parse_events_option
),
2419 OPT_CALLBACK(0, "filter", &record
.evlist
, "filter",
2420 "event filter", parse_filter
),
2421 OPT_CALLBACK_NOOPT(0, "exclude-perf", &record
.evlist
,
2422 NULL
, "don't record events from perf itself",
2424 OPT_STRING('p', "pid", &record
.opts
.target
.pid
, "pid",
2425 "record events on existing process id"),
2426 OPT_STRING('t', "tid", &record
.opts
.target
.tid
, "tid",
2427 "record events on existing thread id"),
2428 OPT_INTEGER('r', "realtime", &record
.realtime_prio
,
2429 "collect data with this RT SCHED_FIFO priority"),
2430 OPT_BOOLEAN(0, "no-buffering", &record
.opts
.no_buffering
,
2431 "collect data without buffering"),
2432 OPT_BOOLEAN('R', "raw-samples", &record
.opts
.raw_samples
,
2433 "collect raw sample records from all opened counters"),
2434 OPT_BOOLEAN('a', "all-cpus", &record
.opts
.target
.system_wide
,
2435 "system-wide collection from all CPUs"),
2436 OPT_STRING('C', "cpu", &record
.opts
.target
.cpu_list
, "cpu",
2437 "list of cpus to monitor"),
2438 OPT_U64('c', "count", &record
.opts
.user_interval
, "event period to sample"),
2439 OPT_STRING('o', "output", &record
.data
.path
, "file",
2440 "output file name"),
2441 OPT_BOOLEAN_SET('i', "no-inherit", &record
.opts
.no_inherit
,
2442 &record
.opts
.no_inherit_set
,
2443 "child tasks do not inherit counters"),
2444 OPT_BOOLEAN(0, "tail-synthesize", &record
.opts
.tail_synthesize
,
2445 "synthesize non-sample events at the end of output"),
2446 OPT_BOOLEAN(0, "overwrite", &record
.opts
.overwrite
, "use overwrite mode"),
2447 OPT_BOOLEAN(0, "no-bpf-event", &record
.opts
.no_bpf_event
, "do not record bpf events"),
2448 OPT_BOOLEAN(0, "strict-freq", &record
.opts
.strict_freq
,
2449 "Fail if the specified frequency can't be used"),
2450 OPT_CALLBACK('F', "freq", &record
.opts
, "freq or 'max'",
2451 "profile at this frequency",
2452 record__parse_freq
),
2453 OPT_CALLBACK('m', "mmap-pages", &record
.opts
, "pages[,pages]",
2454 "number of mmap data pages and AUX area tracing mmap pages",
2455 record__parse_mmap_pages
),
2456 OPT_CALLBACK(0, "mmap-flush", &record
.opts
, "number",
2457 "Minimal number of bytes that is extracted from mmap data pages (default: 1)",
2458 record__mmap_flush_parse
),
2459 OPT_BOOLEAN(0, "group", &record
.opts
.group
,
2460 "put the counters into a counter group"),
2461 OPT_CALLBACK_NOOPT('g', NULL
, &callchain_param
,
2462 NULL
, "enables call-graph recording" ,
2463 &record_callchain_opt
),
2464 OPT_CALLBACK(0, "call-graph", &record
.opts
,
2465 "record_mode[,record_size]", record_callchain_help
,
2466 &record_parse_callchain_opt
),
2467 OPT_INCR('v', "verbose", &verbose
,
2468 "be more verbose (show counter open errors, etc)"),
2469 OPT_BOOLEAN('q', "quiet", &quiet
, "don't print any message"),
2470 OPT_BOOLEAN('s', "stat", &record
.opts
.inherit_stat
,
2471 "per thread counts"),
2472 OPT_BOOLEAN('d', "data", &record
.opts
.sample_address
, "Record the sample addresses"),
2473 OPT_BOOLEAN(0, "phys-data", &record
.opts
.sample_phys_addr
,
2474 "Record the sample physical addresses"),
2475 OPT_BOOLEAN(0, "data-page-size", &record
.opts
.sample_data_page_size
,
2476 "Record the sampled data address data page size"),
2477 OPT_BOOLEAN(0, "sample-cpu", &record
.opts
.sample_cpu
, "Record the sample cpu"),
2478 OPT_BOOLEAN_SET('T', "timestamp", &record
.opts
.sample_time
,
2479 &record
.opts
.sample_time_set
,
2480 "Record the sample timestamps"),
2481 OPT_BOOLEAN_SET('P', "period", &record
.opts
.period
, &record
.opts
.period_set
,
2482 "Record the sample period"),
2483 OPT_BOOLEAN('n', "no-samples", &record
.opts
.no_samples
,
2485 OPT_BOOLEAN_SET('N', "no-buildid-cache", &record
.no_buildid_cache
,
2486 &record
.no_buildid_cache_set
,
2487 "do not update the buildid cache"),
2488 OPT_BOOLEAN_SET('B', "no-buildid", &record
.no_buildid
,
2489 &record
.no_buildid_set
,
2490 "do not collect buildids in perf.data"),
2491 OPT_CALLBACK('G', "cgroup", &record
.evlist
, "name",
2492 "monitor event in cgroup name only",
2494 OPT_INTEGER('D', "delay", &record
.opts
.initial_delay
,
2495 "ms to wait before starting measurement after program start (-1: start with events disabled)"),
2496 OPT_BOOLEAN(0, "kcore", &record
.opts
.kcore
, "copy /proc/kcore"),
2497 OPT_STRING('u', "uid", &record
.opts
.target
.uid_str
, "user",
2500 OPT_CALLBACK_NOOPT('b', "branch-any", &record
.opts
.branch_stack
,
2501 "branch any", "sample any taken branches",
2502 parse_branch_stack
),
2504 OPT_CALLBACK('j', "branch-filter", &record
.opts
.branch_stack
,
2505 "branch filter mask", "branch stack filter modes",
2506 parse_branch_stack
),
2507 OPT_BOOLEAN('W', "weight", &record
.opts
.sample_weight
,
2508 "sample by weight (on special events only)"),
2509 OPT_BOOLEAN(0, "transaction", &record
.opts
.sample_transaction
,
2510 "sample transaction flags (special events only)"),
2511 OPT_BOOLEAN(0, "per-thread", &record
.opts
.target
.per_thread
,
2512 "use per-thread mmaps"),
2513 OPT_CALLBACK_OPTARG('I', "intr-regs", &record
.opts
.sample_intr_regs
, NULL
, "any register",
2514 "sample selected machine registers on interrupt,"
2515 " use '-I?' to list register names", parse_intr_regs
),
2516 OPT_CALLBACK_OPTARG(0, "user-regs", &record
.opts
.sample_user_regs
, NULL
, "any register",
2517 "sample selected machine registers on interrupt,"
2518 " use '--user-regs=?' to list register names", parse_user_regs
),
2519 OPT_BOOLEAN(0, "running-time", &record
.opts
.running_time
,
2520 "Record running/enabled time of read (:S) events"),
2521 OPT_CALLBACK('k', "clockid", &record
.opts
,
2522 "clockid", "clockid to use for events, see clock_gettime()",
2524 OPT_STRING_OPTARG('S', "snapshot", &record
.opts
.auxtrace_snapshot_opts
,
2525 "opts", "AUX area tracing Snapshot Mode", ""),
2526 OPT_STRING_OPTARG(0, "aux-sample", &record
.opts
.auxtrace_sample_opts
,
2527 "opts", "sample AUX area", ""),
2528 OPT_UINTEGER(0, "proc-map-timeout", &proc_map_timeout
,
2529 "per thread proc mmap processing timeout in ms"),
2530 OPT_BOOLEAN(0, "namespaces", &record
.opts
.record_namespaces
,
2531 "Record namespaces events"),
2532 OPT_BOOLEAN(0, "all-cgroups", &record
.opts
.record_cgroup
,
2533 "Record cgroup events"),
2534 OPT_BOOLEAN_SET(0, "switch-events", &record
.opts
.record_switch_events
,
2535 &record
.opts
.record_switch_events_set
,
2536 "Record context switch events"),
2537 OPT_BOOLEAN_FLAG(0, "all-kernel", &record
.opts
.all_kernel
,
2538 "Configure all used events to run in kernel space.",
2539 PARSE_OPT_EXCLUSIVE
),
2540 OPT_BOOLEAN_FLAG(0, "all-user", &record
.opts
.all_user
,
2541 "Configure all used events to run in user space.",
2542 PARSE_OPT_EXCLUSIVE
),
2543 OPT_BOOLEAN(0, "kernel-callchains", &record
.opts
.kernel_callchains
,
2544 "collect kernel callchains"),
2545 OPT_BOOLEAN(0, "user-callchains", &record
.opts
.user_callchains
,
2546 "collect user callchains"),
2547 OPT_STRING(0, "clang-path", &llvm_param
.clang_path
, "clang path",
2548 "clang binary to use for compiling BPF scriptlets"),
2549 OPT_STRING(0, "clang-opt", &llvm_param
.clang_opt
, "clang options",
2550 "options passed to clang when compiling BPF scriptlets"),
2551 OPT_STRING(0, "vmlinux", &symbol_conf
.vmlinux_name
,
2552 "file", "vmlinux pathname"),
2553 OPT_BOOLEAN(0, "buildid-all", &record
.buildid_all
,
2554 "Record build-id of all DSOs regardless of hits"),
2555 OPT_BOOLEAN(0, "timestamp-filename", &record
.timestamp_filename
,
2556 "append timestamp to output filename"),
2557 OPT_BOOLEAN(0, "timestamp-boundary", &record
.timestamp_boundary
,
2558 "Record timestamp boundary (time of first/last samples)"),
2559 OPT_STRING_OPTARG_SET(0, "switch-output", &record
.switch_output
.str
,
2560 &record
.switch_output
.set
, "signal or size[BKMG] or time[smhd]",
2561 "Switch output when receiving SIGUSR2 (signal) or cross a size or time threshold",
2563 OPT_CALLBACK_SET(0, "switch-output-event", &record
.sb_evlist
, &record
.switch_output_event_set
, "switch output event",
2564 "switch output event selector. use 'perf list' to list available events",
2565 parse_events_option_new_evlist
),
2566 OPT_INTEGER(0, "switch-max-files", &record
.switch_output
.num_files
,
2567 "Limit number of switch output generated files"),
2568 OPT_BOOLEAN(0, "dry-run", &dry_run
,
2569 "Parse options then exit"),
2570 #ifdef HAVE_AIO_SUPPORT
2571 OPT_CALLBACK_OPTARG(0, "aio", &record
.opts
,
2572 &nr_cblocks_default
, "n", "Use <n> control blocks in asynchronous trace writing mode (default: 1, max: 4)",
2575 OPT_CALLBACK(0, "affinity", &record
.opts
, "node|cpu",
2576 "Set affinity mask of trace reading thread to NUMA node cpu mask or cpu of processed mmap buffer",
2577 record__parse_affinity
),
2578 #ifdef HAVE_ZSTD_SUPPORT
2579 OPT_CALLBACK_OPTARG('z', "compression-level", &record
.opts
, &comp_level_default
,
2580 "n", "Compressed records using specified level (default: 1 - fastest compression, 22 - greatest compression)",
2581 record__parse_comp_level
),
2583 OPT_CALLBACK(0, "max-size", &record
.output_max_size
,
2584 "size", "Limit the maximum size of the output file", parse_output_max_size
),
2585 OPT_UINTEGER(0, "num-thread-synthesize",
2586 &record
.opts
.nr_threads_synthesize
,
2587 "number of threads to run for event synthesis"),
2589 OPT_CALLBACK(0, "pfm-events", &record
.evlist
, "event",
2590 "libpfm4 event selector. use 'perf list' to list available events",
2591 parse_libpfm_events_option
),
2593 OPT_CALLBACK(0, "control", &record
.opts
, "fd:ctl-fd[,ack-fd] or fifo:ctl-fifo[,ack-fifo]",
2594 "Listen on ctl-fd descriptor for command to control measurement ('enable': enable events, 'disable': disable events,\n"
2595 "\t\t\t 'snapshot': AUX area tracing snapshot).\n"
2596 "\t\t\t Optionally send control command completion ('ack\\n') to ack-fd descriptor.\n"
2597 "\t\t\t Alternatively, ctl-fifo / ack-fifo will be opened and used as ctl-fd / ack-fd.",
2598 parse_control_option
),
2602 struct option
*record_options
= __record_options
;
2604 int cmd_record(int argc
, const char **argv
)
2607 struct record
*rec
= &record
;
2608 char errbuf
[BUFSIZ
];
2610 setlocale(LC_ALL
, "");
2612 #ifndef HAVE_LIBBPF_SUPPORT
2613 # define set_nobuild(s, l, c) set_option_nobuild(record_options, s, l, "NO_LIBBPF=1", c)
2614 set_nobuild('\0', "clang-path", true);
2615 set_nobuild('\0', "clang-opt", true);
2619 #ifndef HAVE_BPF_PROLOGUE
2620 # if !defined (HAVE_DWARF_SUPPORT)
2621 # define REASON "NO_DWARF=1"
2622 # elif !defined (HAVE_LIBBPF_SUPPORT)
2623 # define REASON "NO_LIBBPF=1"
2625 # define REASON "this architecture doesn't support BPF prologue"
2627 # define set_nobuild(s, l, c) set_option_nobuild(record_options, s, l, REASON, c)
2628 set_nobuild('\0', "vmlinux", true);
2633 rec
->opts
.affinity
= PERF_AFFINITY_SYS
;
2635 rec
->evlist
= evlist__new();
2636 if (rec
->evlist
== NULL
)
2639 err
= perf_config(perf_record_config
, rec
);
2643 argc
= parse_options(argc
, argv
, record_options
, record_usage
,
2644 PARSE_OPT_STOP_AT_NON_OPTION
);
2646 perf_quiet_option();
2648 /* Make system wide (-a) the default target. */
2649 if (!argc
&& target__none(&rec
->opts
.target
))
2650 rec
->opts
.target
.system_wide
= true;
2652 if (nr_cgroups
&& !rec
->opts
.target
.system_wide
) {
2653 usage_with_options_msg(record_usage
, record_options
,
2654 "cgroup monitoring only available in system-wide mode");
2658 if (rec
->opts
.kcore
)
2659 rec
->data
.is_dir
= true;
2661 if (rec
->opts
.comp_level
!= 0) {
2662 pr_debug("Compression enabled, disabling build id collection at the end of the session.\n");
2663 rec
->no_buildid
= true;
2666 if (rec
->opts
.record_switch_events
&&
2667 !perf_can_record_switch_events()) {
2668 ui__error("kernel does not support recording context switch events\n");
2669 parse_options_usage(record_usage
, record_options
, "switch-events", 0);
2674 if (switch_output_setup(rec
)) {
2675 parse_options_usage(record_usage
, record_options
, "switch-output", 0);
2680 if (rec
->switch_output
.time
) {
2681 signal(SIGALRM
, alarm_sig_handler
);
2682 alarm(rec
->switch_output
.time
);
2685 if (rec
->switch_output
.num_files
) {
2686 rec
->switch_output
.filenames
= calloc(sizeof(char *),
2687 rec
->switch_output
.num_files
);
2688 if (!rec
->switch_output
.filenames
) {
2695 * Allow aliases to facilitate the lookup of symbols for address
2696 * filters. Refer to auxtrace_parse_filters().
2698 symbol_conf
.allow_aliases
= true;
2702 if (rec
->opts
.affinity
!= PERF_AFFINITY_SYS
) {
2703 rec
->affinity_mask
.nbits
= cpu__max_cpu();
2704 rec
->affinity_mask
.bits
= bitmap_alloc(rec
->affinity_mask
.nbits
);
2705 if (!rec
->affinity_mask
.bits
) {
2706 pr_err("Failed to allocate thread mask for %zd cpus\n", rec
->affinity_mask
.nbits
);
2710 pr_debug2("thread mask[%zd]: empty\n", rec
->affinity_mask
.nbits
);
2713 err
= record__auxtrace_init(rec
);
2720 err
= bpf__setup_stdout(rec
->evlist
);
2722 bpf__strerror_setup_stdout(rec
->evlist
, err
, errbuf
, sizeof(errbuf
));
2723 pr_err("ERROR: Setup BPF stdout failed: %s\n",
2730 if (rec
->no_buildid_cache
|| rec
->no_buildid
) {
2731 disable_buildid_cache();
2732 } else if (rec
->switch_output
.enabled
) {
2734 * In 'perf record --switch-output', disable buildid
2735 * generation by default to reduce data file switching
2736 * overhead. Still generate buildid if they are required
2739 * perf record --switch-output --no-no-buildid \
2740 * --no-no-buildid-cache
2742 * Following code equals to:
2744 * if ((rec->no_buildid || !rec->no_buildid_set) &&
2745 * (rec->no_buildid_cache || !rec->no_buildid_cache_set))
2746 * disable_buildid_cache();
2748 bool disable
= true;
2750 if (rec
->no_buildid_set
&& !rec
->no_buildid
)
2752 if (rec
->no_buildid_cache_set
&& !rec
->no_buildid_cache
)
2755 rec
->no_buildid
= true;
2756 rec
->no_buildid_cache
= true;
2757 disable_buildid_cache();
2761 if (record
.opts
.overwrite
)
2762 record
.opts
.tail_synthesize
= true;
2764 if (rec
->evlist
->core
.nr_entries
== 0 &&
2765 __evlist__add_default(rec
->evlist
, !record
.opts
.no_samples
) < 0) {
2766 pr_err("Not enough memory for event selector list\n");
2770 if (rec
->opts
.target
.tid
&& !rec
->opts
.no_inherit_set
)
2771 rec
->opts
.no_inherit
= true;
2773 err
= target__validate(&rec
->opts
.target
);
2775 target__strerror(&rec
->opts
.target
, err
, errbuf
, BUFSIZ
);
2776 ui__warning("%s\n", errbuf
);
2779 err
= target__parse_uid(&rec
->opts
.target
);
2781 int saved_errno
= errno
;
2783 target__strerror(&rec
->opts
.target
, err
, errbuf
, BUFSIZ
);
2784 ui__error("%s", errbuf
);
2790 /* Enable ignoring missing threads when -u/-p option is defined. */
2791 rec
->opts
.ignore_missing_thread
= rec
->opts
.target
.uid
!= UINT_MAX
|| rec
->opts
.target
.pid
;
2794 if (evlist__create_maps(rec
->evlist
, &rec
->opts
.target
) < 0)
2795 usage_with_options(record_usage
, record_options
);
2797 err
= auxtrace_record__options(rec
->itr
, rec
->evlist
, &rec
->opts
);
2802 * We take all buildids when the file contains
2803 * AUX area tracing data because we do not decode the
2804 * trace because it would take too long.
2806 if (rec
->opts
.full_auxtrace
)
2807 rec
->buildid_all
= true;
2809 if (rec
->opts
.text_poke
) {
2810 err
= record__config_text_poke(rec
->evlist
);
2812 pr_err("record__config_text_poke failed, error %d\n", err
);
2817 if (record_opts__config(&rec
->opts
)) {
2822 if (rec
->opts
.nr_cblocks
> nr_cblocks_max
)
2823 rec
->opts
.nr_cblocks
= nr_cblocks_max
;
2824 pr_debug("nr_cblocks: %d\n", rec
->opts
.nr_cblocks
);
2826 pr_debug("affinity: %s\n", affinity_tags
[rec
->opts
.affinity
]);
2827 pr_debug("mmap flush: %d\n", rec
->opts
.mmap_flush
);
2829 if (rec
->opts
.comp_level
> comp_level_max
)
2830 rec
->opts
.comp_level
= comp_level_max
;
2831 pr_debug("comp level: %d\n", rec
->opts
.comp_level
);
2833 err
= __cmd_record(&record
, argc
, argv
);
2835 bitmap_free(rec
->affinity_mask
.bits
);
2836 evlist__delete(rec
->evlist
);
2838 auxtrace_record__free(rec
->itr
);
2840 evlist__close_control(rec
->opts
.ctl_fd
, rec
->opts
.ctl_fd_ack
, &rec
->opts
.ctl_fd_close
);
2844 static void snapshot_sig_handler(int sig __maybe_unused
)
2846 struct record
*rec
= &record
;
2848 hit_auxtrace_snapshot_trigger(rec
);
2850 if (switch_output_signal(rec
))
2851 trigger_hit(&switch_output_trigger
);
2854 static void alarm_sig_handler(int sig __maybe_unused
)
2856 struct record
*rec
= &record
;
2858 if (switch_output_time(rec
))
2859 trigger_hit(&switch_output_trigger
);