summaryrefslogtreecommitdiffstats
path: root/testing/mozbase/docs/mozgeckoprofiler.rst
diff options
context:
space:
mode:
Diffstat (limited to 'testing/mozbase/docs/mozgeckoprofiler.rst')
-rw-r--r--testing/mozbase/docs/mozgeckoprofiler.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/testing/mozbase/docs/mozgeckoprofiler.rst b/testing/mozbase/docs/mozgeckoprofiler.rst
new file mode 100644
index 0000000000..8e1ae6090d
--- /dev/null
+++ b/testing/mozbase/docs/mozgeckoprofiler.rst
@@ -0,0 +1,21 @@
+:mod:`mozgeckoprofiler.rst` --- Gecko Profiler utilities
+========================================================
+
+This module contains various utilities to work with the Firefox Profiler, Gecko's
+built-in performance profiler. Gecko itself records the profiles, and can dump them
+out to file once the browser shuts down. This package takes those files, symbolicates
+them (turns raw memory addresses into function or symbol names), and provides utilities
+like opening up a locally stored profile in the Firefox Profiler interface. This
+is done by serving the profiles locally, and opening a custom url in profiler.firefox.com.
+
+:mod:`mozgeckoprofiler.rst` --- File origins in mozgeckoprofiler
+----------------------------------------------------------------
+The symbolication files were originally imported from the following repos,
+with permission from their respective authors. However, since then the code has
+been updated for usage within mozbase.
+
+https://github.com/vdjeric/Snappy-Symbolication-Server/
+https://github.com/mstange/analyze-tryserver-profiles/
+
+The dump_syms_mac binary was copied from the objdir of a Firefox build on Mac. It's a
+byproduct of the regular Firefox build process and gets generated in objdir/dist/host/bin/.