perf record: Add --all-cgroups option

[linux-block.git] / tools / perf / Documentation / perf-record.txt

diff --git a/tools/perf/Documentation/perf-record.txt b/tools/perf/Documentation/perf-record.txt
index b23a4012a6064eed3e8353068f79c0fdd67972d2..b3f3b3f1c161d23e6a81a1ce6a173b3920e52260 100644 (file)
--- a/tools/perf/Documentation/perf-record.txt
+++ b/tools/perf/Documentation/perf-record.txt
@@ -237,16 +237,22 @@ OPTIONS
        option and remains only for backward compatibility.  See --event.
 
 -g::
-       Enables call-graph (stack chain/backtrace) recording.
+       Enables call-graph (stack chain/backtrace) recording for both
+       kernel space and user space.
 
 --call-graph::
        Setup and enable call-graph (stack chain/backtrace) recording,
-       implies -g.  Default is "fp".
+       implies -g.  Default is "fp" (for user space).
 
-       Allows specifying "fp" (frame pointer) or "dwarf"
-       (DWARF's CFI - Call Frame Information) or "lbr"
-       (Hardware Last Branch Record facility) as the method to collect
-       the information used to show the call graphs.
+       The unwinding method used for kernel space is dependent on the
+       unwinder used by the active kernel configuration, i.e
+       CONFIG_UNWINDER_FRAME_POINTER (fp) or CONFIG_UNWINDER_ORC (orc)
+
+       Any option specified here controls the method used for user space.
+
+       Valid options are "fp" (frame pointer), "dwarf" (DWARF's CFI -
+       Call Frame Information) or "lbr" (Hardware Last Branch Record
+       facility).
 
        In some systems, where binaries are build with gcc
        --fomit-frame-pointer, using the "fp" method will produce bogus
@@ -385,7 +391,10 @@ displayed with the weight and local_weight sort keys.  This currently works for
 abort events and some memory events in precise mode on modern Intel CPUs.
 
 --namespaces::
-Record events of type PERF_RECORD_NAMESPACES.
+Record events of type PERF_RECORD_NAMESPACES.  This enables 'cgroup_id' sort key.
+
+--all-cgroups::
+Record events of type PERF_RECORD_CGROUP.  This enables 'cgroup' sort key.
 
 --transaction::
 Record transaction flags for transaction related events.
@@ -589,4 +598,4 @@ appended unit character - B/K/M/G
 
 SEE ALSO
 --------
-linkperf:perf-stat[1], linkperf:perf-list[1]
+linkperf:perf-stat[1], linkperf:perf-list[1], linkperf:perf-intel-pt[1]