.. _concept-mapping:

=======
Mapping
=======

Overview
========

.. index::
   pair: Mapping; Shared-memory buffer
   pair: Mapping; MWMR channel
   pair: Mapping; Lock
   triple: Mapping; Synchronization; Barrier
   pair: Mapping; Task
   pair: Mapping; Tcg

DSX Mapping step is an explicit and exhaustive mapping of all the
application resources on relevant hardware components.

Use must map the place where software objects lie:

* for :ref:`Locks <desc-mapping-lock>`, the lock structure itself

* for :ref:`Mwmr channels <desc-mapping-mwmr>`, the description
  structure, the buffer, and the lock if relevant

* for :ref:`Barriers <desc-mapping-barrier>`, the barrier structure
  itself

* for :ref:`Memspaces <desc-mapping-memspace>`, the memory buffer

* for :ref:`Tasks <desc-mapping-task>`, either:

  * a general purpose processor for running, and memory components for
    stack and status buffers

  * a dedicated coprocessor and its MWMR controller

* for each :ref:`Processor <desc-mapping-cpu>`, scheduler memory
  buffers

* for the complete :ref:`application <desc-mapping-tcg>`, some memory
  buffer to store descriptions or state data.

Optionally for Tasks, Processors and the complete Application, user
can also select a logging component for logs output.

Complete description API is explained in its :ref:`own chapter <desc-mapping>`.