More minor coding convention fixes
[ipc/ipcdev.git] / packages / ti / ipc / GateMP.h
index ed86259869a5ae1eef36a6907f97338480a6ed09..356ee9b3573073f8948b573cbc2c03eb4631342a 100644 (file)
  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
-/** ============================================================================
- *  @file       GateMP.h
+/**
+ *  @file       ti/ipc/GateMP.h
  *
  *  @brief      Multiple processor gate that provides local and remote context
  *              protection.
  *
+ *  @note       GateMP is currently only available for SYS/BIOS.
+ *
  *  A GateMP instance can be used to enforce both local and remote context
  *  context protection.  That is, entering a GateMP can prevent preemption by
  *  another thread running on the same processor and simultaneously prevent a
  *  to protect reads/writes to a shared resource, such as shared memory.
  *
  *  Creating a GateMP requires supplying the following configuration
- *      - Instance name (see #GateMP_Params::name)
- *      - Region id (see #GateMP_Params::regionId)
+ *      - Instance name (see #GateMP_Params.name)
+ *      - Region id (see #GateMP_Params.regionId)
+ *
  *  In addition, the following parameters should be configured as necessary:
  *      - The level of local protection (interrupt, thread, tasklet, process
- *        or none) can be configured using the #GateMP_Params::localProtect
+ *        or none) can be configured using the #GateMP_Params.localProtect
  *        config parameter.
  *      - The type of remote system gate that can be used.  Most devices will
  *        typically have a single type of system gate so this configuration
- *        should typically be left alone.  See #GateMP_Params::remoteProtect for
+ *        should typically be left alone.  See #GateMP_Params.remoteProtect for
  *        more information.
 
- *  Once created GateMP allows the gate to be opened on another processor
+ *  Once created, GateMP allows the gate to be opened on another processor
  *  using GateMP_open() and the name that was used in GateMP_create().
  *
  *  A GateMP can be entered and left using GateMP_enter() and GateMP_leave()
  *  @code
  *  #include <ti/ipc/GateMP.h>
  *  @endcode
- *
- *
- *  @version        0.00.01
- *
- *  ============================================================================
  */
 
 #ifndef ti_ipc_GateMP__include
@@ -95,64 +93,64 @@ extern "C" {
 /*!
  *  @brief  The resource is still in use
  */
-#define GateMP_S_BUSY               2
+#define GateMP_S_BUSY               (2)
 
 /*!
  *  @brief  The module has been already setup
  */
-#define GateMP_S_ALREADYSETUP       1
+#define GateMP_S_ALREADYSETUP       (1)
 
 /*!
  *  @brief  Operation is successful.
  */
-#define GateMP_S_SUCCESS            0
+#define GateMP_S_SUCCESS            (0)
 
 /*!
  *  @brief  Generic failure.
  */
-#define GateMP_E_FAIL              -1
+#define GateMP_E_FAIL              (-1)
 
 /*!
  *  @brief  Argument passed to function is invalid.
  */
-#define GateMP_E_INVALIDARG        -2
+#define GateMP_E_INVALIDARG        (-2)
 
 /*!
  *  @brief  Operation resulted in memory failure.
  */
-#define GateMP_E_MEMORY            -3
+#define GateMP_E_MEMORY            (-3)
 
 /*!
  *  @brief  The specified entity already exists.
  */
-#define GateMP_E_ALREADYEXISTS     -4
+#define GateMP_E_ALREADYEXISTS     (-4)
 
 /*!
  *  @brief  Unable to find the specified entity.
  */
-#define GateMP_E_NOTFOUND          -5
+#define GateMP_E_NOTFOUND          (-5)
 
 /*!
  *  @brief  Operation timed out.
  */
-#define GateMP_E_TIMEOUT           -6
+#define GateMP_E_TIMEOUT           (-6)
 
 /*!
  *  @brief  Module is not initialized.
  */
-#define GateMP_E_INVALIDSTATE      -7
+#define GateMP_E_INVALIDSTATE      (-7)
 
 /*!
  *  @brief  A failure occurred in an OS-specific call  */
-#define GateMP_E_OSFAILURE         -8
+#define GateMP_E_OSFAILURE         (-8)
 
 /*!
  *  @brief  Specified resource is not available  */
-#define GateMP_E_RESOURCE          -9
+#define GateMP_E_RESOURCE          (-9)
 
 /*!
  *  @brief  Operation was interrupted. Please restart the operation  */
-#define GateMP_E_RESTART           -10
+#define GateMP_E_RESTART           (-10)
 
 /* =============================================================================
  *  Structures & Enums
@@ -165,18 +163,6 @@ extern "C" {
  *  Each member corresponds to a specific local processor gates used for
  *  local protection.
  *
- *  In Linux user mode, the following are the mapping for the constants
- *      - INTERRUPT -> [N/A]
- *      - TASKLET   -> [N/A]
- *      - THREAD    -> GateMutex
- *      - PROCESS   -> GateMutex
- *
- *  In Linux kernel mode, the following are the mapping for the constants
- *      - INTERRUPT -> [Interrupts disabled]
- *      - TASKLET   -> GateMutex
- *      - THREAD    -> GateMutex
- *      - PROCESS   -> GateMutex
- *
  *  For SYS/BIOS users, the following are the mappings for the constants
  *      - INTERRUPT -> GateAll: disables interrupts, Swis and Tasks
  *      - TASKLET   -> GateSwi: disables Swis and Tasks
@@ -209,7 +195,7 @@ typedef enum GateMP_LocalProtect {
  *  Each enum value corresponds to the following remote protection levels:
  *      - NONE      -> No remote protection (the GateMP instance will
  *                     exclusively offer local protection configured in
- *                     #GateMP_Params::localProtect
+ *                     #GateMP_Params.localProtect
  *      - SYSTEM    -> Use the SYSTEM remote protection level (default for
  *                     remote protection
  *      - CUSTOM1   -> Use the CUSTOM1 remote protection level
@@ -218,7 +204,7 @@ typedef enum GateMP_LocalProtect {
 typedef enum GateMP_RemoteProtect {
     GateMP_RemoteProtect_NONE     = 0,
     /*!< No remote protection (the GateMP instance will exclusively
-     *  offer local protection configured in #GateMP_Params::localProtect)
+     *  offer local protection configured in #GateMP_Params.localProtect)
      */
 
     GateMP_RemoteProtect_SYSTEM   = 1,
@@ -271,7 +257,7 @@ typedef struct GateMP_Params {
      *  it must be from a valid SharedRegion and the regionId is ignored.
      *  If sharedAddr is null, then shared memory for a new instance is
      *  allocated from the heap belonging to the region identified by
-     *  #GateMP_Params::regionId.  The amount of shared memory allocated
+     *  #GateMP_Params.regionId.  The amount of shared memory allocated
      *  can be determined by calling GateMP_sharedMemReq().
      */
     /*! @endcond */