Google Git
Sign in
android / platform / system / extras / 8918090d772da97c4505cb1e28aec785e3cc2bd5 / . / simpleperf
tree: 47012b75146dae1394b27c6fee86889a8bf95e98 [path history] [tgz]
  1. app_api/
  2. demo/
  3. doc/
  4. include/
  5. nonlinux_support/
  6. runtest/
  7. rust/
  8. scripts/
  9. simpleperf_app_runner/
  10. testdata/
  11. .clang-format ⇨ ../.clang-format-2
  12. CtsSimpleperfTestCases_testdata ⇨ testdata/
  13. .gitignore
  14. Android.bp
  15. Android.mk
  16. build_id.h
  17. callchain.h
  18. CallChainJoiner.cpp
  19. CallChainJoiner.h
  20. CallChainJoiner_test.cpp
  21. cmd_api.cpp
  22. cmd_api_impl.h
  23. cmd_api_test.cpp
  24. cmd_debug_unwind.cpp
  25. cmd_debug_unwind_test.cpp
  26. cmd_dumprecord.cpp
  27. cmd_dumprecord_test.cpp
  28. cmd_help.cpp
  29. cmd_inject.cpp
  30. cmd_inject_impl.h
  31. cmd_inject_test.cpp
  32. cmd_kmem.cpp
  33. cmd_kmem_test.cpp
  34. cmd_list.cpp
  35. cmd_list_test.cpp
  36. cmd_merge.cpp
  37. cmd_merge_test.cpp
  38. cmd_monitor.cpp
  39. cmd_monitor_test.cpp
  40. cmd_record.cpp
  41. cmd_record_impl.h
  42. cmd_record_test.cpp
  43. cmd_report.cpp
  44. cmd_report_sample.cpp
  45. cmd_report_sample.proto
  46. cmd_report_sample_test.cpp
  47. cmd_report_test.cpp
  48. cmd_stat.cpp
  49. cmd_stat_impl.h
  50. cmd_stat_test.cpp
  51. cmd_trace_sched.cpp
  52. cmd_trace_sched_test.cpp
  53. command.cpp
  54. command.h
  55. command_test.cpp
  56. cpu_hotplug_test.cpp
  57. dso.cpp
  58. dso.h
  59. dso_test.cpp
  60. environment.cpp
  61. environment.h
  62. environment_test.cpp
  63. etm_branch_list.proto
  64. ETMConstants.h
  65. ETMDecoder.cpp
  66. ETMDecoder.h
  67. ETMRecorder.cpp
  68. ETMRecorder.h
  69. event_attr.cpp
  70. event_attr.h
  71. event_fd.cpp
  72. event_fd.h
  73. event_selection_set.cpp
  74. event_selection_set.h
  75. event_type.cpp
  76. event_type.h
  77. event_type_table.h
  78. generate_event_type_table.py
  79. get_test_data.h
  80. gtest_main.cpp
  81. IOEventLoop.cpp
  82. IOEventLoop.h
  83. IOEventLoop_test.cpp
  84. JITDebugReader.cpp
  85. JITDebugReader.h
  86. kallsyms.cpp
  87. kallsyms.h
  88. kallsyms_test.cpp
  89. main.cpp
  90. MapRecordReader.cpp
  91. MapRecordReader.h
  92. MapRecordReader_test.cpp
  93. NOTICE
  94. OfflineUnwinder.cpp
  95. OfflineUnwinder.h
  96. OfflineUnwinder_impl.h
  97. OfflineUnwinder_test.cpp
  98. OWNERS
  99. perf_event.h
  100. perf_regs.cpp
  101. perf_regs.h
  102. perf_regs_test.cpp
  103. ProbeEvents.cpp
  104. ProbeEvents.h
  105. ProbeEvents_test.cpp
  106. profcollect.cpp
  107. read_apk.cpp
  108. read_apk.h
  109. read_apk_test.cpp
  110. read_dex_file.cpp
  111. read_dex_file.h
  112. read_dex_file_test.cpp
  113. read_elf.cpp
  114. read_elf.h
  115. read_elf_test.cpp
  116. read_symbol_map.cpp
  117. read_symbol_map.h
  118. read_symbol_map_test.cpp
  119. README.md
  120. record.cpp
  121. record.h
  122. record_equal_test.h
  123. record_file.h
  124. record_file.proto
  125. record_file_format.h
  126. record_file_reader.cpp
  127. record_file_test.cpp
  128. record_file_writer.cpp
  129. record_lib_interface.cpp
  130. record_lib_test.cpp
  131. record_test.cpp
  132. RecordFilter.cpp
  133. RecordFilter.h
  134. RecordFilter_test.cpp
  135. RecordReadThread.cpp
  136. RecordReadThread.h
  137. RecordReadThread_test.cpp
  138. report_lib_interface.cpp
  139. report_utils.cpp
  140. report_utils.h
  141. report_utils_test.cpp
  142. sample_tree.h
  143. sample_tree_test.cpp
  144. SampleComparator.h
  145. SampleDisplayer.h
  146. TEST_MAPPING
  147. test_util.cpp
  148. test_util.h
  149. thread_tree.cpp
  150. thread_tree.h
  151. thread_tree_test.cpp
  152. tracing.cpp
  153. tracing.h
  154. tracing_test.cpp
  155. utils.cpp
  156. utils.h
  157. utils_test.cpp
  158. workload.cpp
  159. workload.h
  160. workload_test.cpp
simpleperf/README.md

Simpleperf

This file is documentation for simpleperf maintainers. There is also user documentation.

Building new prebuilts

To snap the aosp-simpleperf-release branch to ToT AOSP main and kick off a build, use this coastguard page and choose “aosp-simpleperf-release” from the “Branch” dropdown. Then click “Submit build requests”. You'll get emails keeping you up to date with the progress of the snap and the build.

Updating the prebuilts

Once you have the build id (a 7-digit number) and the build is complete, run the update script from within the system/extras/simpleperf directory:

$ ./scripts/update.py --build 1234567

This will create a new change that you can repo upload, then approve and submit as normal.

For testing, I usually only run python host tests as below:

$ ./scripts/test/test.py --only-host-test

To test all scripts, please use python 3.8+ and install below packages:

$ pip install bokeh jinja2 pandas protobuf textable

Updating the prebuilts in prebuilts/simpleperf

Download ndk branch.

$ repo init -u persistent-https://android.git.corp.google.com/platform/manifest -b master-ndk
$ repo sync

In prebuilts/simpleperf, run update.py:

$ ./update.py --build <bid>

Then manually edit ChangeLog. This will create a new change that you can repo upload, then approve and submit as normal.

For testing, we need to test if the scripts run on darwin/linux/windows for different android versions. I usually split it to four parts:

  1. Test on android emulators running on linux x86_64 host, for android version N/O/P/Q/R/S/current.
$ ./test/test.py -d <devices> -r 3

The scripts support android >= N. But it's easier to test old versions on emulators. So I only test android N on emulators.

Currently, the tests have problems in clean up. So tests on emulator may fail and take too long to run. And there are a few known failed cases. Hopefully they will be fixed soon.

  1. Test on android devices connected to linux x86_64 host, for android version O/P/Q/R/S/current.
$ ./test/test.py -d <devices> -r 3
  1. Test on an android device connected to darwin x86_64 host, for one of android version O/P/Q/R/S/current.
$ ./test/test.py -d <devices> -r 1
  1. Test on an android device connected to darwin x86_64 host, for one of android version O/P/Q/R/S/current.
$ ./test/test.py -d <devices> -r 1

To check simpleperf contents released in ndk, we can build ndk package.

$ <top_dir>/ndk/checkbuild.py --package --system linux --module simpleperf

The ndk package is generated in out/ directory.