summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>1999-10-07 16:26:13 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>1999-10-07 16:26:13 +0000
commit5ad8673727e5c82321057e5e536077d9d6a1b4a7 (patch)
treeaff042d9e47c3a2908dd7e29030af07b998c3329 /doc
parentCleaned up use of $(PROJECT) instead of hard-coding c_user. (diff)
downloadrtems-5ad8673727e5c82321057e5e536077d9d6a1b4a7.tar.bz2
Added rtems_task_is_suspended.
Diffstat (limited to 'doc')
-rw-r--r--doc/user/task.t42
1 files changed, 42 insertions, 0 deletions
diff --git a/doc/user/task.t b/doc/user/task.t
index 09d114f4cb..a1a949e9d8 100644
--- a/doc/user/task.t
+++ b/doc/user/task.t
@@ -22,6 +22,7 @@ by the task manager are:
@item @code{@value{DIRPREFIX}task_delete} - Delete a task
@item @code{@value{DIRPREFIX}task_suspend} - Suspend a task
@item @code{@value{DIRPREFIX}task_resume} - Resume a task
+@item @code{@value{DIRPREFIX}task_is_suspended} - Determine if a task is Suspended
@item @code{@value{DIRPREFIX}task_set_priority} - Set task priority
@item @code{@value{DIRPREFIX}task_mode} - Change current task's mode
@item @code{@value{DIRPREFIX}task_get_note} - Get task notepad entry
@@ -496,6 +497,8 @@ suspension and leaves the task in the blocked state.
Suspending a task which is already suspended or resuming a
task which is not suspended is considered an error.
+The @code{@value{DIRPREFIX}task_is_suspended} can be used to
+determine if a task is currently suspended.
@subsection Delaying the Currently Executing Task
@@ -1028,6 +1031,45 @@ If the task specified by id is not suspended, then the
@page
+@subsection TASK_IS_SUSPENDED - Determine if a task is Suspended
+
+@subheading CALLING SEQUENCE:
+
+@ifset is-C
+@c @findex rtems_task_is_suspended
+@example
+rtems_status_code rtems_task_is_suspended(
+ rtems_id id
+);
+@end example
+@end ifset
+
+@ifset is-Ada
+@example
+procedure Task_Is_Suspended (
+ ID : in RTEMS.ID;
+ Result : out RTEMS.Status_Codes
+);
+@end example
+@end ifset
+
+@subheading DIRECTIVE STATUS CODES:
+@code{@value{RPREFIX}SUCCESSFUL} - task is not suspended@*
+@code{@value{RPREFIX}ALREADY_SUSPENDED} - task is not suspended@*
+@code{@value{RPREFIX}INVALID_ID} - task id invalid@*
+@code{@value{RPREFIX}ILLEGAL_ON_REMOTE_OBJECT} - not supported on remote tasks
+
+@subheading DESCRIPTION:
+
+This directive returns a status code indicating whether or
+not the specified task is currently suspended.
+
+@subheading NOTES:
+
+This operation is not currently supported on remote tasks.
+
+@page
+
@subsection TASK_SET_PRIORITY - Set task priority
@subheading CALLING SEQUENCE: