xref: /xnu-8792.81.2/osfmk/man/task_resume.html (revision 19c3b8c28c31cb8130e034cfb5df6bf9ba342d90)
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