[rtems commit] rtems: Document rtems_semaphore_obtain() errors

[Sebastian Huber]

Module:    rtems
Branch:    master
Commit:    00f9faf2de9c0437ca9734c0c02f2b03d4cac7c8
Changeset: http://git.rtems.org/rtems/commit/?id=00f9faf2de9c0437ca9734c0c02f2b03d4cac7c8

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Fri Apr 16 15:22:04 2021 +0200

rtems: Document rtems_semaphore_obtain() errors

---

 cpukit/include/rtems/rtems/sem.h | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/cpukit/include/rtems/rtems/sem.h b/cpukit/include/rtems/rtems/sem.h
index ec3b6c6..22f5b3f 100644
--- a/cpukit/include/rtems/rtems/sem.h
+++ b/cpukit/include/rtems/rtems/sem.h
@@ -468,8 +468,15 @@ rtems_status_code rtems_semaphore_delete( rtems_id id );
  * @retval ::RTEMS_INVALID_ID There was no semaphore associated with the
  *   identifier specified by ``id``.
  *
+ * @retval ::RTEMS_NOT_DEFINED The semaphore uses a priority ceiling and there
+ *   was no priority ceiling defined for the home scheduler of the calling
+ *   task.
+ *
  * @retval ::RTEMS_UNSATISFIED The semaphore could not be obtained immediately.
  *
+ * @retval ::RTEMS_INVALID_PRIORITY The semaphore uses a priority ceiling and
+ *   the calling task had a current priority less than the priority ceiling.
+ *
  * @retval ::RTEMS_INCORRECT_STATE Acquiring of the local, binary semaphore by
  *   the calling task would have cased a deadlock.
  *