Remove unused pkg dependancy

[platform/upstream/iotivity.git] / resource / csdk / connectivity / common / inc / camutex.h

diff --git a/resource/csdk/connectivity/common/inc/camutex.h b/resource/csdk/connectivity/common/inc/camutex.h
index e138006..5a1c00f 100644 (file)
--- a/resource/csdk/connectivity/common/inc/camutex.h
+++ b/resource/csdk/connectivity/common/inc/camutex.h
@@ -24,8 +24,8 @@
  * This file provides APIs related to mutex and semaphores.
  */
 
-#ifndef _CAMUTEX_H_
-#define _CAMUTEX_H_
+#ifndef CA_MUTEX_H_
+#define CA_MUTEX_H_
 
 #include "cacommon.h"
 
@@ -38,13 +38,13 @@ typedef struct ca_mutex_internal *ca_mutex;
 typedef struct ca_cond_internal *ca_cond;
 
 /**
- * Enums for ca_cond_wait_for return values
+ * Enums for ca_cond_wait_for return values.
  */
 typedef enum
 {
-   CA_WAIT_SUCCESS = 0,    /**< Condition Signal */
-   CA_WAIT_INVAL = -1,     /**< Invalid Condition */
-   CA_WAIT_TIMEDOUT = -2   /**< Condition Timed Out */
+   CA_WAIT_SUCCESS = 0,    /**< Condition Signal. */
+   CA_WAIT_INVAL = -1,     /**< Invalid Condition. */
+   CA_WAIT_TIMEDOUT = -2   /**< Condition Timed Out. */
 } CAWaitResult_t;
 
 /**
@@ -58,25 +58,15 @@ ca_mutex ca_mutex_new(void);
 /**
  * Lock the mutex.
  *
- * @param  mutex  The mutex to be locked
+ * @param  mutex  The mutex to be locked.
  *
  */
 void ca_mutex_lock(ca_mutex mutex);
 
 /**
- * Checks if the mutex can be locked.
- *
- * @param  mutex  The mutex to be locked
- *
- * @return  true if the mutex is not locked currently, otherwise false.
- *
- */
-bool ca_mutex_trylock(ca_mutex mutex);
-
-/**
  * Unlock the mutex.
  *
- * @param  mutex  The mutex to be unlocked
+ * @param  mutex  The mutex to be unlocked.
  *
  */
 void ca_mutex_unlock(ca_mutex mutex);
@@ -84,7 +74,7 @@ void ca_mutex_unlock(ca_mutex mutex);
 /**
  * Free the mutex.
  *
- * @param  mutex  The mutex to be freed
+ * @param  mutex  The mutex to be freed.
  *
  */
 bool ca_mutex_free(ca_mutex mutex);
@@ -92,49 +82,49 @@ bool ca_mutex_free(ca_mutex mutex);
 /**
  * Creates new condition.
  *
- * @return  Reference to newly created @ca_cond, otherwise NULL.
+ * @return  Reference to newly created ::ca_cond, otherwise NULL.
  *
  */
 ca_cond ca_cond_new(void);
 
 /**
- * One of threads is woken up if multiple threads are waiting for @cond.
+ * One of threads is woken up if multiple threads are waiting for cond.
  *
- * @param  cond  The condtion to be signaled
+ * @param  cond  The condtion to be signaled.
  *
  */
 void ca_cond_signal(ca_cond cond);
 
 /**
- * All of threads are woken up if multiple threads are waiting for @cond.
+ * All of threads are woken up if multiple threads are waiting for cond.
  *
- * @param  cond  The condtion to be signaled
+ * @param  cond  The condtion to be signaled.
  *
  */
 void ca_cond_broadcast(ca_cond cond);
 
 /**
- * Waits until this thread woken up on @cond.
+ * Waits until this thread woken up on cond.
  *
- * @param  cond  The condtion to be wait for to signal
- * @param  mutex  The mutex which is currently locked from calling thread
+ * @param  cond  The condtion to be wait for to signal.
+ * @param  mutex  The mutex which is currently locked from calling thread.
  *
  */
 void ca_cond_wait(ca_cond cond, ca_mutex mutex);
 
 /**
- * Waits until this thread woken up on @cond,
+ * Waits until this thread woken up on cond,
  * but not longer than the interval specified by microseconds.
  * The mutex is unlocked before falling asleep and locked again before resuming.
  * If microseconds is 0, ca_cond_wait_for() acts like ca_cond_wait().
  *
- * @param  cond  The condtion to be wait for to signal
- * @param  mutex  The mutex which is currently locked from calling thread
- * @param  microseconds  relative time for waiting, microseconds
+ * @param  cond  The condtion to be wait for to signal.
+ * @param  mutex  The mutex which is currently locked from calling thread.
+ * @param  microseconds  relative time for waiting, microseconds.
  *
- * @return CA_WAIT_SUCCESS if the condition was signaled.
- *         CA_WAIT_TIMEDDOUT if wait period exceeded
- *         CA_WAIT_INVAL for invalid parameters
+ * @return ::CA_WAIT_SUCCESS if the condition was signaled,
+ *         ::CA_WAIT_TIMEDOUT if wait period exceeded,
+ *         ::CA_WAIT_INVAL for invalid parameters.
  *
  */
 CAWaitResult_t ca_cond_wait_for(ca_cond cond, ca_mutex mutex, uint64_t microseconds);
@@ -142,7 +132,7 @@ CAWaitResult_t ca_cond_wait_for(ca_cond cond, ca_mutex mutex, uint64_t microseco
 /**
  * Free the condition.
  *
- * @param  cond  The condition to be freed
+ * @param  cond  The condition to be freed.
  *
  */
 void ca_cond_free(ca_cond cond);
@@ -151,5 +141,4 @@ void ca_cond_free(ca_cond cond);
 } /* extern "C" */
 #endif /* __cplusplus */
 
-#endif /*__UMUTEX_H_ */
-
+#endif /* CA_MUTEX_H_ */