/**
 * Lookup for a block of shared memory
 *
 * @param[in] name   Name of the block
 *
 * @return Pointer to the block, or NULL
 */
odp_shm_t odp_shm_lookup(const char *name);



This should be return handler of the block. Not pointer. Please fix it in this patch.

The same thing for odp_shm_reserve().

Maxim.



On 11/07/2014 08:27 PM, Mike Holmes wrote:
Signed-off-by: Mike Holmes <[email protected]>
---
  .../linux-generic/include/api/odp_shared_memory.h   | 21 +++++++++++----------
  1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/platform/linux-generic/include/api/odp_shared_memory.h 
b/platform/linux-generic/include/api/odp_shared_memory.h
index 1a59824..6836b28 100644
--- a/platform/linux-generic/include/api/odp_shared_memory.h
+++ b/platform/linux-generic/include/api/odp_shared_memory.h
@@ -1,4 +1,4 @@
-/* Copyright (c) 2013, Linaro Limited
+/* Copyright (c) 2013-2014, Linaro Limited
   * All rights reserved.
   *
   * SPDX-License-Identifier:     BSD-3-Clause
@@ -61,10 +61,11 @@ typedef struct odp_shm_info_t {
  /**
   * Reserve a contiguous block of shared memory
   *
- * @param name   Name of the block (maximum ODP_SHM_NAME_LEN - 1 chars)
- * @param size   Block size in bytes
- * @param align  Block alignment in bytes
- * @param flags  Shared mem parameter flags (ODP_SHM_*). Default value is 0.
+ * @param[in] name   Name of the block (maximum ODP_SHM_NAME_LEN - 1 chars)
+ * @param[in] size   Block size in bytes
+ * @param[in] align  Block alignment in bytes
+ * @param[in] flags  Shared memory parameter flags (ODP_SHM_*).
+ *                   Default value is 0.
   *
   * @return Pointer to the reserved block, or NULL
   */
@@ -75,7 +76,7 @@ odp_shm_t odp_shm_reserve(const char *name, uint64_t size, 
uint64_t align,
   * Free a contiguous block of shared memory
   *
   * Frees a previously reserved block of shared memory.
- * @note Freeing memory that is in use will result in UNDEFINED behaviour.
+ * @note Freeing memory that is in use will result in UNDEFINED behavior
   *
   * @param[in] shm Block handle
   *
@@ -87,7 +88,7 @@ int odp_shm_free(odp_shm_t shm);
  /**
   * Lookup for a block of shared memory
   *
- * @param name   Name of the block
+ * @param[in] name   Name of the block
   *
   * @return Pointer to the block, or NULL
   */
@@ -97,7 +98,7 @@ odp_shm_t odp_shm_lookup(const char *name);
  /**
   * Shared memory block address
   *
- * @param shm   Block handle
+ * @param[in] shm   Block handle
   *
   * @return Memory block address, or NULL on error
   */
@@ -107,8 +108,8 @@ void *odp_shm_addr(odp_shm_t shm);
  /**
   * Shared memory block info
   *
- * @param shm   Block handle
- * @param info  Block info pointer for output
+ * @param[in]  shm   Block handle
+ * @param[out] info  Block info pointer for output
   *
   * @return 0 on success, otherwise non-zero
   */


_______________________________________________
lng-odp mailing list
[email protected]
http://lists.linaro.org/mailman/listinfo/lng-odp

Reply via email to