services/docs/datareporting.rst

Thu, 22 Jan 2015 13:21:57 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 22 Jan 2015 13:21:57 +0100
branch
TOR_BUG_9701
changeset 15
b8a032363ba2
permissions
-rw-r--r--

Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6

michael@0 1 .. _data_reporting_service:
michael@0 2
michael@0 3 ======================
michael@0 4 Data Reporting Service
michael@0 5 ======================
michael@0 6
michael@0 7 ``/services/datareporting`` contains files related to an XPCOM service
michael@0 8 that collects and reports data within Gecko applications.
michael@0 9
michael@0 10 The important files in this directory are:
michael@0 11
michael@0 12 DataReportingService.js
michael@0 13 An XPCOM service that coordinates collection and reporting of data.
michael@0 14
michael@0 15 policy.jsm
michael@0 16 A module containing the logic for coordinating and driving collection
michael@0 17 and upload of data.
michael@0 18
michael@0 19 sessions.jsm
michael@0 20 Records Gecko application session history. This is loaded as part of
michael@0 21 the XPCOM service because it needs to capture state from very early in
michael@0 22 the application lifecycle. Bug 841561 tracks implementing this in C++.
michael@0 23
michael@0 24 There is other code in the tree that collects and uploads data. The
michael@0 25 original intent of this directory and XPCOM service was to serve as a
michael@0 26 focal point for the coordination of all this activity so that it could
michael@0 27 all be done consistently and properly. This vision may or may not be fully
michael@0 28 realized.

mercurial