gecko/build/docs/mozinfo.rst
Gregory Szorc 94e5fda7a5 Bug 958561 - Measure Sync with Firefox Health Report; r=rnewman
Metrics for Sync have been added to Firefox Health Report. If Sync is
not configured, we'll report that fact and the supported and preferred
Sync protocols (1.1 or 1.5).

If Sync is configured, we report the daily counts of sync attempts and
how many are successful vs errored. We also report daily counts of the
device types attached to the account.

--HG--
extra : rebase_source : 77170b323706a85cbe1542ac993ebdc1dba3b505
extra : amend_source : 7802e80b4fc94937fbe3f67505b447bfb048732d
2014-02-05 08:08:14 -08:00

156 lines
3.4 KiB
ReStructuredText

.. _mozinfo:
=======
mozinfo
=======
``mozinfo`` is a solution for representing a subset of build
configuration and run-time data.
``mozinfo`` data is typically accessed through a ``mozinfo.json`` file
which is written to the :term:`object directory` during build
configuration. The code for writing this file lives in
:py:mod:`mozbuild.mozinfo`.
``mozinfo.json`` is an object/dictionary of simple string values.
The attributes in ``mozinfo.json`` are used for many purposes. One use
is to filter tests for applicability to the current build. For more on
this, see :ref:`test_manifests`.
.. _mozinfo_attributes:
mozinfo.json Attributes
=================================
``mozinfo`` currently records the following attributes.
appname
The application being built.
Value comes from ``MOZ_APP_NAME`` from ``config.status``.
Optional.
asan
Whether address sanitization is enabled.
Values are ``true`` and ``false``.
Always defined.
bin_suffix
The file suffix for binaries produced with this build.
Values may be an empty string, as not all platforms have a binary
suffix.
Always defined.
bits
The number of bits in the CPU this build targets.
Values are typically ``32`` or ``64``.
Universal Mac builds do not have this key defined.
Unkown processor architectures (see ``processor`` below) may not have
this key defined.
Optional.
buildapp
The path to the XUL application being built.
For desktop Firefox, this is ``browser``. For Fennec, it's
``mobile/android``. For B2G, it's ``b2g``.
crashreporter
Whether the crash reporter is enabled for this build.
Values are ``true`` and ``false``.
Always defined.
datareporting
Whether data reporting (MOZ_DATA_REPORTING) is enabled for this build.
Values are ``true`` and ``false``.
Always defined.
debug
Whether this is a debug build.
Values are ``true`` and ``false``.
Always defined.
healthreport
Whether the Health Report feature is enabled.
Values are ``true`` and ``false``.
Always defined.
mozconfig
The path of the :ref:`mozconfig file <mozconfig>` used to produce this build.
Optional.
os
The operating system the build is produced for. Values for tier-1
supported platforms are ``linux``, ``win``, ``mac``, ``b2g``, and
``android``. For other platforms, the value is the lowercase version
of the ``OS_TARGET`` variable from ``config.status``.
Always defined.
processor
Information about the processor architecture this build targets.
Values come from ``TARGET_CPU``, however some massaging may be
performed.
If the build is a universal build on Mac (it targets both 32-bit and
64-bit), the value is ``universal-x86-x86_64``.
If the value starts with ``arm``, the value is ``arm``.
If the value starts with a string of the form ``i[3-9]86]``, the
value is ``x86``.
Always defined.
tests_enabled
Whether tests are enabled for this build.
Values are ``true`` and ``false``.
Always defined.
toolkit
The widget toolkit in case. The value comes from the
``MOZ_WIDGET_TOOLKIT`` ``config.status`` variable.
Always defined.
topsrcdir
The path to the source directory the build came from.
Always defined.
wave
Whether Wave audio support is enabled.
Values are ``true`` and ``false``.
Always defined.
webm
Whether WebM support is enabled.
Values are ``true`` and ``false``.
Always defined.