linux/tools/perf/Documentation
Arnaldo Carvalho de Melo d32de87e73 perf trace: Allow configuring default for perf_event_attr.inherit
I.f. if children should inherit the parent perf_event configuration,
i.e. if we should trace children as well or just the parent.

The default is to follow children, to disable this and have a behaviour
similar to strace, set this config option or use the --no_inherit 'perf
trace' option.

E.g.:

Default:

  # perf config trace.no_inherit
  # trace -e clone,*sleep time sleep 1
     0.000 time/21107 clone(clone_flags: CHILD_CLEARTID|CHILD_SETTID|0x11, newsp: 0, child_tidptr: 0x7f7b8f9ae810) = 21108 (time)
         ? time/21108  ... [continued]: clone()
     0.691 sleep/21108 nanosleep(rqtp: 0x7ffed01d0540, rmtp: 0                               ) = 0
  0.00user 0.00system 0:01.00elapsed 0%CPU (0avgtext+0avgdata 1988maxresident)k
  0inputs+0outputs (0major+76minor)pagefaults 0swaps
  #

Disable it:

  # trace -e clone,*sleep time sleep 1
     0.000 clone(clone_flags: CHILD_CLEARTID|CHILD_SETTID|0x11, newsp: 0, child_tidptr: 0x7ff41e100810) = 21414 (time)
  0.00user 0.00system 0:01.00elapsed 0%CPU (0avgtext+0avgdata 1964maxresident)k
  0inputs+0outputs (0major+76minor)pagefaults 0swaps
  #

Notice that since there is just one thread, the "comm/TID" column is
suppressed.

Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Luis Cláudio Gonçalves <lclaudio@redhat.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Wang Nan <wangnan0@huawei.com>
Link: https://lkml.kernel.org/n/tip-thd8s16pagyza71ufi5vjlan@git.kernel.org
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
2018-12-18 12:24:01 -03:00
..
android.txt
asciidoc.conf
asciidoctor-extensions.rb
build-xed.txt perf script: Add --insn-trace for instruction decoding 2018-10-24 15:29:50 -03:00
Build.txt
callchain-overhead-calculation.txt
examples.txt
intel-bts.txt
intel-pt.txt perf scripts python: call-graph-from-sql.py: Rename to exported-sql-viewer.py 2018-10-23 14:26:44 -03:00
itrace.txt perf script: Make itrace script default to all calls 2018-10-24 15:29:54 -03:00
jit-interface.txt
jitdump-specification.txt
Makefile perf Documentation: Fix out-of-tree asciidoctor man page generation 2018-09-18 10:17:16 -03:00
manpage-1.72.xsl
manpage-base.xsl
manpage-bold-literal.xsl
manpage-normal.xsl
manpage-suppress-sp.xsl
perf-annotate.txt perf annotate: Add --percent-type option 2018-08-08 15:55:53 -03:00
perf-archive.txt
perf-bench.txt perf bench: Add epoll_ctl(2) benchmark 2018-11-21 22:39:55 -03:00
perf-buildid-cache.txt
perf-buildid-list.txt
perf-c2c.txt
perf-config.txt perf trace: Allow configuring default for perf_event_attr.inherit 2018-12-18 12:24:01 -03:00
perf-data.txt
perf-diff.txt
perf-evlist.txt
perf-ftrace.txt
perf-help.txt
perf-inject.txt
perf-kallsyms.txt
perf-kmem.txt
perf-kvm.txt
perf-list.txt perf tools Documentation: Fix diverse typos 2018-12-17 14:56:36 -03:00
perf-lock.txt
perf-mem.txt
perf-probe.txt
perf-record.txt perf record: Extend trace writing to multi AIO 2018-12-17 14:55:11 -03:00
perf-report.txt perf tools Documentation: Fix diverse typos 2018-12-17 14:56:36 -03:00
perf-sched.txt
perf-script-perl.txt
perf-script-python.txt perf script python: Add dict fields introduction to Documentation 2018-06-06 15:40:10 -03:00
perf-script.txt perf tools: Support 'srccode' output 2018-12-17 14:57:07 -03:00
perf-stat.txt perf tools Documentation: Fix diverse typos 2018-12-17 14:56:36 -03:00
perf-test.txt
perf-timechart.txt
perf-top.txt perf top: Allow passing a kallsyms file 2018-12-17 14:54:40 -03:00
perf-trace.txt perf trace: Allow selecting use the use of the ordered_events code 2018-12-18 12:23:55 -03:00
perf-version.txt
perf.data-file-format.txt perf tools: Fix perf.data format description of NRCPUS header 2018-05-30 15:40:26 -03:00
perf.txt
perfconfig.example
tips.txt