Linux Manuals

perf – Performance analysis tools for Linux Synopsisperf [–version] [–help] [OPTIONS] COMMAND [ARGS]Options–debug Setup debug variable (just verbose for now) in value range (0, 10). Use like: –debug verbose # sets verbose = 1 –debug verbose=2 # sets verbose = 2DescriptionPerformance counters for Linux are a new kernel-based subsystem that provide a framework for all…

perf-trace – strace inspired tool Synopsisperf trace perf trace recordDescriptionThis command will show the events associated with the target, initially syscalls, but other system events like pagefaults, task lifetime events, scheduling events, etc. This is a live mode tool in addition to working with perf.data files like the other perf tools. Files can be generated…

perf-top – System profiling tool. Synopsisperf top [-e <EVENT> | –event=EVENT] [<options>]DescriptionThis command generates and displays a performance counter profile in real time. Options-a, –all-cpus System-wide collection. (default) -c <count>, –count=<count> Event period to sample. -C <cpu-list>, –cpu=<cpu> Monitor only on the list of CPUs provided. Multiple CPUs can be provided as a comma-separated list…

perf-timechart – Tool to visualize total system behavior during a workload SynopsisDescriptionThere are two variants of perf timechart: ‘perf timechart record <command>’ to record the system level events of an arbitrary workload. By default timechart records only scheduler and CPU events (task switches, running times, CPU power states, etc), but it’s possible to record IO…

perf-test – Runs sanity tests. Synopsisperf test [<options>] [{list <test-name-fragment>|[<test-name-fragments>|<test-numbers>]}]DescriptionThis command does assorted sanity tests, initially through linked routines but also will look for a directory with more tests in the form of scripts. To get a list of available tests use perf test list, specifying a test name fragment will show all tests that…

perf-stat – Run a command and gather performance counter statistics Synopsisperf stat [-e <EVENT> | –event=EVENT] [-a] <command> perf stat [-e <EVENT> | –event=EVENT] [-a] — <command> [<options>]DescriptionThis command runs a command and gathers performance counter statistics from it. Options<command>… Any command you can specify in a shell. -e, –event= Select the PMU event. Selection…

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…