[rtems-docs commit] c-user: Document rtems_task_set_scheduler() errors

[Sebastian Huber]

Module:    rtems-docs
Branch:    master
Commit:    7ded5943e4bf6bf5834a93fb55cb69cc5f218654
Changeset: http://git.rtems.org/rtems-docs/commit/?id=7ded5943e4bf6bf5834a93fb55cb69cc5f218654

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Wed May 12 15:05:37 2021 +0200

c-user: Document rtems_task_set_scheduler() errors

---

 c-user/task/directives.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/c-user/task/directives.rst b/c-user/task/directives.rst
index 2bfb8af..aa90484 100644
--- a/c-user/task/directives.rst
+++ b/c-user/task/directives.rst
@@ -1702,12 +1702,32 @@ This directive sets the :term:`home scheduler` to the scheduler specified by
     ``scheduler_id``.
 
 :c:macro:`RTEMS_INVALID_PRIORITY`
-    There task priority specified in ``priority`` was invalid with respect to
-    the scheduler specified by ``scheduler_id``.
+    The :term:`task priority` specified by ``priority`` was invalid with
+    respect to the scheduler specified by ``scheduler_id``.
 
 :c:macro:`RTEMS_INVALID_ID`
     There was no task associated with the identifier specified by ``task_id``.
 
+:c:macro:`RTEMS_RESOURCE_IN_USE`
+    The task specified by ``task_id`` was enqueued on a :term:`wait queue`.
+
+:c:macro:`RTEMS_RESOURCE_IN_USE`
+    The task specified by ``task_id`` had a :term:`current priority` which
+    consisted of more than the :term:`real priority`.
+
+:c:macro:`RTEMS_RESOURCE_IN_USE`
+    The task specified by ``task_id`` had a :term:`helping scheduler`.
+
+:c:macro:`RTEMS_RESOURCE_IN_USE`
+    The task specified by ``task_id`` was pinned.
+
+:c:macro:`RTEMS_UNSATISFIED`
+    The scheduler specified by ``scheduler_id`` owned no processor.
+
+:c:macro:`RTEMS_UNSATISFIED`
+    The scheduler specified by ``scheduler_id`` did not support the affinity
+    set of the task specified by ``task_id``.
+
 :c:macro:`RTEMS_ILLEGAL_ON_REMOTE_OBJECT`
     The task resided on a remote node.