summaryrefslogtreecommitdiffstats
path: root/documentation/profile-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/profile-manual')
-rw-r--r--documentation/profile-manual/intro.rst4
-rw-r--r--documentation/profile-manual/usage.rst118
2 files changed, 61 insertions, 61 deletions
diff --git a/documentation/profile-manual/intro.rst b/documentation/profile-manual/intro.rst
index 86310cf318..3179125524 100644
--- a/documentation/profile-manual/intro.rst
+++ b/documentation/profile-manual/intro.rst
@@ -43,7 +43,7 @@ an ``sdk`` image, perhaps one of::
43Alternatively, you can add ``tools-profile`` to the :term:`EXTRA_IMAGE_FEATURES` line in 43Alternatively, you can add ``tools-profile`` to the :term:`EXTRA_IMAGE_FEATURES` line in
44your ``local.conf`` file:: 44your ``local.conf`` file::
45 45
46 EXTRA_IMAGE_FEATURES = "debug-tweaks tools-profile" 46 EXTRA_IMAGE_FEATURES:append = " tools-profile"
47 47
48If you use the ``tools-profile`` method, you don't need to build an sdk image --- 48If you use the ``tools-profile`` method, you don't need to build an sdk image ---
49the tracing and profiling tools will be included in non-sdk images as well e.g.:: 49the tracing and profiling tools will be included in non-sdk images as well e.g.::
@@ -69,7 +69,7 @@ packages (xxx-dbg) which you can manually install as needed.
69To generate debug info for packages, you can add ``dbg-pkgs`` to 69To generate debug info for packages, you can add ``dbg-pkgs`` to
70:term:`EXTRA_IMAGE_FEATURES` in ``local.conf``. For example:: 70:term:`EXTRA_IMAGE_FEATURES` in ``local.conf``. For example::
71 71
72 EXTRA_IMAGE_FEATURES = "debug-tweaks tools-profile dbg-pkgs" 72 EXTRA_IMAGE_FEATURES:append = " dbg-pkgs"
73 73
74Additionally, in order to generate the right type of debug info, we also need to 74Additionally, in order to generate the right type of debug info, we also need to
75set :term:`PACKAGE_DEBUG_SPLIT_STYLE` in the ``local.conf`` file:: 75set :term:`PACKAGE_DEBUG_SPLIT_STYLE` in the ``local.conf`` file::
diff --git a/documentation/profile-manual/usage.rst b/documentation/profile-manual/usage.rst
index 2f82137538..d17b256d0f 100644
--- a/documentation/profile-manual/usage.rst
+++ b/documentation/profile-manual/usage.rst
@@ -308,7 +308,7 @@ install the debugging information for the BusyBox package.
308To generate the debug info for the packages in the image, we can add 308To generate the debug info for the packages in the image, we can add
309``dbg-pkgs`` to :term:`EXTRA_IMAGE_FEATURES` in ``local.conf``. For example:: 309``dbg-pkgs`` to :term:`EXTRA_IMAGE_FEATURES` in ``local.conf``. For example::
310 310
311 EXTRA_IMAGE_FEATURES = "debug-tweaks tools-profile dbg-pkgs" 311 EXTRA_IMAGE_FEATURES:append = " dbg-pkgs"
312 312
313Additionally, in order to generate the type of debugging information that perf 313Additionally, in order to generate the type of debugging information that perf
314understands, we also need to set :term:`PACKAGE_DEBUG_SPLIT_STYLE` 314understands, we also need to set :term:`PACKAGE_DEBUG_SPLIT_STYLE`
@@ -1058,13 +1058,13 @@ section::
1058 name: do_fork 1058 name: do_fork
1059 ID: 944 1059 ID: 944
1060 format: 1060 format:
1061 field:unsigned short common_type; offset:0; size:2; signed:0; 1061 field:unsigned short common_type; offset:0; size:2; signed:0;
1062 field:unsigned char common_flags; offset:2; size:1; signed:0; 1062 field:unsigned char common_flags; offset:2; size:1; signed:0;
1063 field:unsigned char common_preempt_count; offset:3; size:1; signed:0; 1063 field:unsigned char common_preempt_count; offset:3; size:1; signed:0;
1064 field:int common_pid; offset:4; size:4; signed:1; 1064 field:int common_pid; offset:4; size:4; signed:1;
1065 field:int common_padding; offset:8; size:4; signed:1; 1065 field:int common_padding; offset:8; size:4; signed:1;
1066 1066
1067 field:unsigned long __probe_ip; offset:12; size:4; signed:0; 1067 field:unsigned long __probe_ip; offset:12; size:4; signed:0;
1068 1068
1069 print fmt: "(%lx)", REC->__probe_ip 1069 print fmt: "(%lx)", REC->__probe_ip
1070 1070
@@ -1550,17 +1550,17 @@ like ftrace to display the event as text. The format of the
1550 name: kmalloc 1550 name: kmalloc
1551 ID: 313 1551 ID: 313
1552 format: 1552 format:
1553 field:unsigned short common_type; offset:0; size:2; signed:0; 1553 field:unsigned short common_type; offset:0; size:2; signed:0;
1554 field:unsigned char common_flags; offset:2; size:1; signed:0; 1554 field:unsigned char common_flags; offset:2; size:1; signed:0;
1555 field:unsigned char common_preempt_count; offset:3; size:1; signed:0; 1555 field:unsigned char common_preempt_count; offset:3; size:1; signed:0;
1556 field:int common_pid; offset:4; size:4; signed:1; 1556 field:int common_pid; offset:4; size:4; signed:1;
1557 field:int common_padding; offset:8; size:4; signed:1; 1557 field:int common_padding; offset:8; size:4; signed:1;
1558 1558
1559 field:unsigned long call_site; offset:16; size:8; signed:0; 1559 field:unsigned long call_site; offset:16; size:8; signed:0;
1560 field:const void * ptr; offset:24; size:8; signed:0; 1560 field:const void * ptr; offset:24; size:8; signed:0;
1561 field:size_t bytes_req; offset:32; size:8; signed:0; 1561 field:size_t bytes_req; offset:32; size:8; signed:0;
1562 field:size_t bytes_alloc; offset:40; size:8; signed:0; 1562 field:size_t bytes_alloc; offset:40; size:8; signed:0;
1563 field:gfp_t gfp_flags; offset:48; size:4; signed:0; 1563 field:gfp_t gfp_flags; offset:48; size:4; signed:0;
1564 1564
1565 print fmt: "call_site=%lx ptr=%p bytes_req=%zu bytes_alloc=%zu gfp_flags=%s", REC->call_site, REC->ptr, REC->bytes_req, REC->bytes_alloc, 1565 print fmt: "call_site=%lx ptr=%p bytes_req=%zu bytes_alloc=%zu gfp_flags=%s", REC->call_site, REC->ptr, REC->bytes_req, REC->bytes_alloc,
1566 (REC->gfp_flags) ? __print_flags(REC->gfp_flags, "|", {(unsigned long)(((( gfp_t)0x10u) | (( gfp_t)0x40u) | (( gfp_t)0x80u) | (( 1566 (REC->gfp_flags) ? __print_flags(REC->gfp_flags, "|", {(unsigned long)(((( gfp_t)0x10u) | (( gfp_t)0x40u) | (( gfp_t)0x80u) | ((
@@ -1872,7 +1872,7 @@ Practically speaking, that means you need to do the following:
1872 1872
1873- Or build a non-SDK image but include the profiling tools 1873- Or build a non-SDK image but include the profiling tools
1874 (edit ``local.conf`` and add ``tools-profile`` to the end of 1874 (edit ``local.conf`` and add ``tools-profile`` to the end of
1875 :term:``EXTRA_IMAGE_FEATURES`` variable):: 1875 :term:`EXTRA_IMAGE_FEATURES` variable)::
1876 1876
1877 $ bitbake core-image-sato 1877 $ bitbake core-image-sato
1878 1878
@@ -2355,29 +2355,29 @@ first part of the filenames::
2355 8,32 1 0 58.516990819 0 m N cfq3551 put_queue 2355 8,32 1 0 58.516990819 0 m N cfq3551 put_queue
2356 2356
2357 CPU0 (sdc): 2357 CPU0 (sdc):
2358 Reads Queued: 0, 0KiB Writes Queued: 331, 26,284KiB 2358 Reads Queued: 0, 0KiB Writes Queued: 331, 26,284KiB
2359 Read Dispatches: 0, 0KiB Write Dispatches: 485, 40,484KiB 2359 Read Dispatches: 0, 0KiB Write Dispatches: 485, 40,484KiB
2360 Reads Requeued: 0 Writes Requeued: 0 2360 Reads Requeued: 0 Writes Requeued: 0
2361 Reads Completed: 0, 0KiB Writes Completed: 511, 41,000KiB 2361 Reads Completed: 0, 0KiB Writes Completed: 511, 41,000KiB
2362 Read Merges: 0, 0KiB Write Merges: 13, 160KiB 2362 Read Merges: 0, 0KiB Write Merges: 13, 160KiB
2363 Read depth: 0 Write depth: 2 2363 Read depth: 0 Write depth: 2
2364 IO unplugs: 23 Timer unplugs: 0 2364 IO unplugs: 23 Timer unplugs: 0
2365 CPU1 (sdc): 2365 CPU1 (sdc):
2366 Reads Queued: 0, 0KiB Writes Queued: 249, 15,800KiB 2366 Reads Queued: 0, 0KiB Writes Queued: 249, 15,800KiB
2367 Read Dispatches: 0, 0KiB Write Dispatches: 42, 1,600KiB 2367 Read Dispatches: 0, 0KiB Write Dispatches: 42, 1,600KiB
2368 Reads Requeued: 0 Writes Requeued: 0 2368 Reads Requeued: 0 Writes Requeued: 0
2369 Reads Completed: 0, 0KiB Writes Completed: 16, 1,084KiB 2369 Reads Completed: 0, 0KiB Writes Completed: 16, 1,084KiB
2370 Read Merges: 0, 0KiB Write Merges: 40, 276KiB 2370 Read Merges: 0, 0KiB Write Merges: 40, 276KiB
2371 Read depth: 0 Write depth: 2 2371 Read depth: 0 Write depth: 2
2372 IO unplugs: 30 Timer unplugs: 1 2372 IO unplugs: 30 Timer unplugs: 1
2373 2373
2374 Total (sdc): 2374 Total (sdc):
2375 Reads Queued: 0, 0KiB Writes Queued: 580, 42,084KiB 2375 Reads Queued: 0, 0KiB Writes Queued: 580, 42,084KiB
2376 Read Dispatches: 0, 0KiB Write Dispatches: 527, 42,084KiB 2376 Read Dispatches: 0, 0KiB Write Dispatches: 527, 42,084KiB
2377 Reads Requeued: 0 Writes Requeued: 0 2377 Reads Requeued: 0 Writes Requeued: 0
2378 Reads Completed: 0, 0KiB Writes Completed: 527, 42,084KiB 2378 Reads Completed: 0, 0KiB Writes Completed: 527, 42,084KiB
2379 Read Merges: 0, 0KiB Write Merges: 53, 436KiB 2379 Read Merges: 0, 0KiB Write Merges: 53, 436KiB
2380 IO unplugs: 53 Timer unplugs: 1 2380 IO unplugs: 53 Timer unplugs: 1
2381 2381
2382 Throughput (R/W): 0KiB/s / 719KiB/s 2382 Throughput (R/W): 0KiB/s / 719KiB/s
2383 Events (sdc): 6,592 entries 2383 Events (sdc): 6,592 entries
@@ -2500,29 +2500,29 @@ And run blkparse on the host system using the device name::
2500 8,32 1 0 177.266696560 0 m N cfq1267 put_queue 2500 8,32 1 0 177.266696560 0 m N cfq1267 put_queue
2501 2501
2502 CPU0 (sdc): 2502 CPU0 (sdc):
2503 Reads Queued: 0, 0KiB Writes Queued: 270, 21,708KiB 2503 Reads Queued: 0, 0KiB Writes Queued: 270, 21,708KiB
2504 Read Dispatches: 59, 2,628KiB Write Dispatches: 495, 39,964KiB 2504 Read Dispatches: 59, 2,628KiB Write Dispatches: 495, 39,964KiB
2505 Reads Requeued: 0 Writes Requeued: 0 2505 Reads Requeued: 0 Writes Requeued: 0
2506 Reads Completed: 90, 2,752KiB Writes Completed: 543, 41,596KiB 2506 Reads Completed: 90, 2,752KiB Writes Completed: 543, 41,596KiB
2507 Read Merges: 0, 0KiB Write Merges: 9, 344KiB 2507 Read Merges: 0, 0KiB Write Merges: 9, 344KiB
2508 Read depth: 2 Write depth: 2 2508 Read depth: 2 Write depth: 2
2509 IO unplugs: 20 Timer unplugs: 1 2509 IO unplugs: 20 Timer unplugs: 1
2510 CPU1 (sdc): 2510 CPU1 (sdc):
2511 Reads Queued: 688, 2,752KiB Writes Queued: 381, 20,652KiB 2511 Reads Queued: 688, 2,752KiB Writes Queued: 381, 20,652KiB
2512 Read Dispatches: 31, 124KiB Write Dispatches: 59, 2,396KiB 2512 Read Dispatches: 31, 124KiB Write Dispatches: 59, 2,396KiB
2513 Reads Requeued: 0 Writes Requeued: 0 2513 Reads Requeued: 0 Writes Requeued: 0
2514 Reads Completed: 0, 0KiB Writes Completed: 11, 764KiB 2514 Reads Completed: 0, 0KiB Writes Completed: 11, 764KiB
2515 Read Merges: 598, 2,392KiB Write Merges: 88, 448KiB 2515 Read Merges: 598, 2,392KiB Write Merges: 88, 448KiB
2516 Read depth: 2 Write depth: 2 2516 Read depth: 2 Write depth: 2
2517 IO unplugs: 52 Timer unplugs: 0 2517 IO unplugs: 52 Timer unplugs: 0
2518 2518
2519 Total (sdc): 2519 Total (sdc):
2520 Reads Queued: 688, 2,752KiB Writes Queued: 651, 42,360KiB 2520 Reads Queued: 688, 2,752KiB Writes Queued: 651, 42,360KiB
2521 Read Dispatches: 90, 2,752KiB Write Dispatches: 554, 42,360KiB 2521 Read Dispatches: 90, 2,752KiB Write Dispatches: 554, 42,360KiB
2522 Reads Requeued: 0 Writes Requeued: 0 2522 Reads Requeued: 0 Writes Requeued: 0
2523 Reads Completed: 90, 2,752KiB Writes Completed: 554, 42,360KiB 2523 Reads Completed: 90, 2,752KiB Writes Completed: 554, 42,360KiB
2524 Read Merges: 598, 2,392KiB Write Merges: 97, 792KiB 2524 Read Merges: 598, 2,392KiB Write Merges: 97, 792KiB
2525 IO unplugs: 72 Timer unplugs: 1 2525 IO unplugs: 72 Timer unplugs: 1
2526 2526
2527 Throughput (R/W): 15KiB/s / 238KiB/s 2527 Throughput (R/W): 15KiB/s / 238KiB/s
2528 Events (sdc): 9,301 entries 2528 Events (sdc): 9,301 entries
generated by cgit v1.2.3-54-g00ecf (git 2.39.0) at 2025-07-05 21:14:19 +0000