Linux Manuals

perf-script – Read perf.data (created by perf record) and display trace output Synopsisperf script [<options>] perf script [<options>] record <script> [<record-options>] <command> perf script [<options>] report <script> [script-args] perf script [<options>] <script> <required-script-args> [<record-options>] <command> perf script [<options>] <top-script> [script-args]DescriptionThis command reads the input file and displays the trace recorded. There are several variants of…

perf-script-python – Process trace data with a Python script Synopsisperf script [-s [Python]:script[.py] ]DescriptionThis perf script option is used to process perf script data using perf’s built-in Python interpreter. It reads and processes the input file and displays the results of the trace analysis implemented in the given Python script, if any. A Quick ExampleThis…

perf-script-perl – Process trace data with a Perl script Synopsisperf script [-s [Perl]:script[.pl] ]DescriptionThis perf script option is used to process perf script data using perf’s built-in Perl interpreter. It reads and processes the input file and displays the results of the trace analysis implemented in the given Perl script, if any. Starter ScriptsYou can…

perf-sched – Tool to trace/measure scheduler properties (latencies) Synopsisperf sched {record|latency|map|replay|script}DescriptionThere are five variants of perf sched: ‘perf sched record <command>’ to record the scheduling events of an arbitrary workload.‘perf sched latency’ to report the per task scheduling latencies and other scheduling properties of the workload.‘perf sched script’ to see a detailed trace of the…

perf-report – Read perf.data (created by perf record) and display the profile Synopsisperf report [-i <file> | –input=file]DescriptionThis command displays the performance counter profile information recorded via perf record. Options-i, –input= Input file name. (default: perf.data unless stdin is a fifo) -v, –verbose Be more verbose. (show symbol address, etc) -n, –show-nr-samples Show the number…

perf-record – Run a command and record its profile into perf.data Synopsisperf record [-e <EVENT> | –event=EVENT] [-l] [-a] <command> perf record [-e <EVENT> | –event=EVENT] [-l] [-a] — <command> [<options>]DescriptionThis command runs a command and gathers a performance counter profile from it, into perf.data – without displaying anything. This file can then be inspected…

perf-probe – Define new dynamic tracepoints Synopsisperf probe [options] –add=PROBE […] or perf probe [options] PROBE or perf probe [options] –del=[GROUP:]EVENT […] or perf probe –list or perf probe [options] –line=LINE or perf probe [options] –vars=PROBEPOINTDescriptionThis command defines dynamic tracepoint events, by symbol and registers without debuginfo, or by C expressions (C line numbers, C…

perf-mem – Profile memory accesses Synopsisperf mem [<options>] (record [<command>] | report)Description"perf mem -t <TYPE> record" runs a command and gathers memory operation data from it, into perf.data. Perf record options are accepted and are passed through. "perf mem -t <TYPE> report" displays the result. It invokes perf report with the right set of options…

perf-lock – Analyze lock events Synopsisperf lock {record|report|script|info}DescriptionYou can analyze various lock behaviours and statistics with this perf lock command. ‘perf lock record <command>’ records lock events between start and end <command>. And this command produces the file "perf.data" which contains tracing results of lock events.‘perf lock report’ reports statistical data.‘perf lock script’ shows raw…

perf-list – List all symbolic event types Synopsisperf list [hw|sw|cache|tracepoint|pmu|event_glob]DescriptionThis command displays the symbolic event types which can be selected in the various perf commands with the -e option. Event ModifiersEvents can optionally have a modifier by appending a colon and one or more modifiers. Modifiers allow the user to restrict the events to be…

perf-kvm – Tool to trace/measure kvm guest os Synopsisperf kvm [–host] [–guest] [–guestmount=<path> [–guestkallsyms=<path> –guestmodules=<path> | –guestvmlinux=<path>]] {top|record|report|diff|buildid-list} [<options>] perf kvm [–host] [–guest] [–guestkallsyms=<path> –guestmodules=<path> | –guestvmlinux=<path>] {top|record|report|diff|buildid-list|stat} [<options>] ‘perf kvm stat [record|report|live] [<options>]DescriptionThere are a couple of variants of perf kvm: ‘perf kvm [options] top <command>’ to generates and displays a performance counter profile…

perf-kmem – Tool to trace/measure kernel memory(slab) properties Synopsisperf kmem {record|stat} [<options>]DescriptionThere are two variants of perf kmem: ‘perf kmem record <command>’ to record the kmem events of an arbitrary workload.‘perf kmem stat’ to report kernel memory statistics.Options-i <file>, –input=<file> Select the input file (default: perf.data unless stdin is a fifo) –caller Show per-callsite statistics…

perf-inject – Filter to augment the events stream with additional information Synopsisperf inject <options>Descriptionperf-inject reads a perf-record event stream and repipes it to stdout. At any point the processing code can inject other events into the event stream – in this case build-ids (-b option) are read and injected as needed into the event stream….

perf-help – display help information about perf Synopsisperf help [-a|–all] [COMMAND] DescriptionWith no options and no COMMAND given, the synopsis of the perf command and a list of the most commonly used perf commands are printed on the standard output. If the option –all or -a is given, then all available commands are printed on…

perf-evlist – List the event names in a perf.data file Synopsisperf evlist <options>DescriptionThis command displays the names of events sampled in a perf.data file. Options-i, –input= Input file name. (default: perf.data unless stdin is a fifo) -F, –freq= Show just the sample frequency used for each event. -v, –verbose= Show all fields. -g, –group Show…

perf-diff – Read perf.data files and display the differential profile Synopsisperf diff [baseline file] [data file1] [[data file2] … ]DescriptionThis command displays the performance difference amongst two or more perf.data files captured via perf record. If no parameters are passed it will assume perf.data.old and perf.data. The differential profile is displayed only for events matching…

perf-buildid-list – List the buildids in a perf.data file Synopsisperf buildid-list <options>DescriptionThis command displays the buildids found in a perf.data file, so that other tools can be used to fetch packages with matching symbol tables for use by perf report. It can also be used to show the build id of the running kernel or…

perf-buildid-cache – Manage build-id cache. Synopsisperf buildid-cache <options>DescriptionThis command manages the build-id cache. It can add and remove files to/from the cache. In the future it should as well purge older entries, set upper limits for the space used by the cache, etc. Options-a, –add= Add specified file to the cache. -k, –kcore Add specified…

perf-bench – General framework for benchmark suites Synopsisperf bench [<common options>] <subsystem> <suite> [<options>]DescriptionThis perf bench command is a general framework for benchmark suites. Common Options-r, –repeat= Specify amount of times to repeat the run (default 10). -f, –format= Specify format style. Current available format styles are: default Default style. This is mainly for human…

perf-archive – Create archive with object files with build-ids found in perf.data file Synopsisperf archive [file]DescriptionThis command runs perf-buildid-list –with-hits, and collects the files with the buildids found so that analysis of perf.data contents can be possible on another machine. See Alsoperf-record(1), perf-buildid-list(1), perf-report(1)