[commit: ghc] master: users-guide: Fix formatting of eventlog format documentation (fcd919f)
git at git.haskell.org
git at git.haskell.org
Fri Nov 2 00:34:32 UTC 2018
Repository : ssh://git@git.haskell.org/ghc
On branch : master
Link : http://ghc.haskell.org/trac/ghc/changeset/fcd919f991452cc0d42805fca6e549c2efeb0dde/ghc
>---------------------------------------------------------------
commit fcd919f991452cc0d42805fca6e549c2efeb0dde
Author: Ben Gamari <bgamari.foss at gmail.com>
Date: Thu Nov 1 18:31:33 2018 -0400
users-guide: Fix formatting of eventlog format documentation
Test Plan: Read it
Reviewers: mpickering
Reviewed By: mpickering
Subscribers: rwbarton, carter
Differential Revision: https://phabricator.haskell.org/D5264
>---------------------------------------------------------------
fcd919f991452cc0d42805fca6e549c2efeb0dde
docs/users_guide/eventlog-formats.rst | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/docs/users_guide/eventlog-formats.rst b/docs/users_guide/eventlog-formats.rst
index 9910d4d..6fd7d89 100644
--- a/docs/users_guide/eventlog-formats.rst
+++ b/docs/users_guide/eventlog-formats.rst
@@ -29,6 +29,7 @@ Beginning of sample stream
A single fixed-width event emitted during program start-up describing the samples that follow.
* ``EVENT_HEAP_PROF_BEGIN``
+
* ``Word8``: Profile ID
* ``Word64``: Sampling period in nanoseconds
* ``Word32``: Sample break-down type. One of,
@@ -55,6 +56,7 @@ Cost centre definitions
A variable-length packet produced once for each cost centre,
* ``EVENT_HEAP_PROF_COST_CENTRE``
+
* ``Word32``: cost centre number
* ``String``: label
* ``String``: module
@@ -74,6 +76,7 @@ We mark the beginning of a new sample with an ``EVENT_HEAP_PROF_SAMPLE_BEGIN``
event,
* ``EVENT_HEAP_PROF_SAMPLE_BEGIN``
+
* ``Word64``: sample number
A heap residency census will follow. Since events may only be up to 2^16^ bytes
@@ -88,7 +91,9 @@ Cost-centre break-down
A variable-length packet encoding a heap profile sample broken down by,
* cost-centre (``-hc``)
+
* ``EVENT_HEAP_PROF_SAMPLE_COST_CENTRE``
+
* ``Word8``: Profile ID
* ``Word64``: heap residency in bytes
* ``Word8``: stack depth
@@ -99,11 +104,13 @@ String break-down
^^^^^^^^^^^^^^^^^
A variable-length event encoding a heap sample broken down by,
+
* type description (``-hy``)
* closure description (``-hd``)
* module (``-hm``)
* ``EVENT_HEAP_PROF_SAMPLE_STRING``
+
* ``Word8``: Profile ID
* ``Word64``: heap residency in bytes
* ``String``: type or closure description, or module name
More information about the ghc-commits
mailing list