xref: /xnu-8796.101.5/osfmk/man/task_resume.html (revision aca3beaa3dfbd42498b42c5e5ce20a938e6554e5)
1<h2>task_resume</h2>
2<hr>
3<p>
4<strong>Function</strong> - Decrement the target task's suspend count.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t   task_resume</strong>
8                <strong>(task_t</strong>         <var>task</var><strong>);</strong>
9</pre>
10<h3>PARAMETERS</h3>
11<dl>
12<p>
13<dt> <var>task</var>
14<dd>
15[in task send right]
16The port to the task to be resumed.
17</dl>
18<h3>DESCRIPTION</h3>
19<p>
20The <strong>task_resume</strong> function decrements the suspend count
21for <var>task</var>.  If the task's suspend count goes to zero, the
22function resumes any suspended threads within the task.  To resume
23a given thread, the thread's own suspend count must also be zero.
24<h3>NOTES</h3>
25<p>
26An attempt to lower the suspend count below zero is ignored.
27<h3>RETURN VALUES</h3>
28<p>
29Only generic errors apply.
30<h3>RELATED INFORMATION</h3>
31<p>
32Functions:
33<a href="task_create.html"><strong>task_create</strong></a>,
34<a href="task_info.html"><strong>task_info</strong></a>,
35<a href="task_suspend.html"><strong>task_suspend</strong></a>,
36<a href="task_terminate.html"><strong>task_terminate</strong></a>,
37<a href="thread_info.html"><strong>thread_info</strong></a>,
38<a href="thread_resume.html"><strong>thread_resume</strong></a>,
39<a href="thread_suspend.html"><strong>thread_suspend</strong></a>.
40