Github/emacs
2
0
Fork 1
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-23 21:37:34 +00:00
Code Issues Projects Releases Packages Wiki Activity

Explain how to customize the telemetry system.

Browse source 
Copied from Perforce
 Change: 186984
 ServerID: perforce.ravenbrook.com
This commit is contained in:
Gareth Rees 2014-08-25 15:23:12 +01:00
parent 5f1b76b634
commit 4560e91fae
1 changed files with 23 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
mps/manual/source/topic/telemetry.rst
View file

@ -547,3 +547,26 @@ used in queries, for example:
If the ``User`` event category is not turned on in the
:term:`telemetry filter` (via :c:func:`mps_telemetry_control`)
then calling this function has no effect.
.. index::
pair: telemetry; customizing
Customizing the telemetry system
--------------------------------
If you need the telemetry system to support features not described
here (for example, you need to transmit telemetry data over a network
rather than writing it to a file on the local filesystem) then you may
be able to do so by providing your own implementation of the
:ref:`topic-plinth-io`.
When it first needs to output telemetry, the MPS call the plinth
function :c:func:`mps_io_create` to create an I/O stream. It then
calls :c:func:`mps_io_write` to write binary data to the stream
and :c:func:`mps_io_flush` to flush the stream in response to
:c:func:`mps_telemetry_flush`. By providing your own implementations
of these functions, you can direct the telemetry stream wherever you
like.
See :ref:`topic-plinth` for details.