From 5ad8673727e5c82321057e5e536077d9d6a1b4a7 Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Thu, 7 Oct 1999 16:26:13 +0000
Subject: Added rtems_task_is_suspended.

---
 doc/user/task.t | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

(limited to 'doc')

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:
-- 
cgit v1.2.3