xref: /xnu-11215.61.5/osfmk/man/thread_resume.html (revision 4f1223e81cd707a65cc109d0b8ad6653699da3c4)
1*4f1223e8SApple OSS Distributions<h2>thread_resume</h2>
2*4f1223e8SApple OSS Distributions<hr>
3*4f1223e8SApple OSS Distributions<p>
4*4f1223e8SApple OSS Distributions<strong>Function</strong> - Resume a thread.
5*4f1223e8SApple OSS Distributions<h3>SYNOPSIS</h3>
6*4f1223e8SApple OSS Distributions<pre>
7*4f1223e8SApple OSS Distributions<strong>kern_return_t   thread_resume</strong>
8*4f1223e8SApple OSS Distributions                <strong>(thread_act_t</strong>                     <var>target_thread</var><strong>);</strong>
9*4f1223e8SApple OSS Distributions</pre>
10*4f1223e8SApple OSS Distributions<h3>PARAMETERS</h3>
11*4f1223e8SApple OSS Distributions<dl>
12*4f1223e8SApple OSS Distributions<p>
13*4f1223e8SApple OSS Distributions<dt> <var>target_thread</var>
14*4f1223e8SApple OSS Distributions<dd>
15*4f1223e8SApple OSS Distributions[in thread send right]
16*4f1223e8SApple OSS DistributionsThe thread to be resumed.
17*4f1223e8SApple OSS Distributions</dl>
18*4f1223e8SApple OSS Distributions<h3>DESCRIPTION</h3>
19*4f1223e8SApple OSS Distributions<p>
20*4f1223e8SApple OSS DistributionsThe <strong>thread_resume</strong> function decrements the suspend count
21*4f1223e8SApple OSS Distributionsfor <var>target_thread</var>
22*4f1223e8SApple OSS Distributionsby one.  The thread is resumed if its suspend count goes to zero.
23*4f1223e8SApple OSS DistributionsIf the suspend
24*4f1223e8SApple OSS Distributionscount is still positive, <strong>thread_resume</strong> must be repeated
25*4f1223e8SApple OSS Distributionsuntil the count reaches
26*4f1223e8SApple OSS Distributionszero.
27*4f1223e8SApple OSS Distributions<h3>NOTES</h3>
28*4f1223e8SApple OSS Distributions<p>
29*4f1223e8SApple OSS DistributionsAn attempt to lower the suspend count below zero is ignored.
30*4f1223e8SApple OSS Distributions<h3>RETURN VALUES</h3>
31*4f1223e8SApple OSS Distributions<p>
32*4f1223e8SApple OSS DistributionsOnly generic errors apply.
33*4f1223e8SApple OSS Distributions<h3>RELATED INFORMATION</h3>
34*4f1223e8SApple OSS Distributions<p>
35*4f1223e8SApple OSS DistributionsFunctions:
36*4f1223e8SApple OSS Distributions<a href="task_resume.html"><strong>task_resume</strong></a>,
37*4f1223e8SApple OSS Distributions<a href="task_suspend.html"><strong>task_suspend</strong></a>,
38*4f1223e8SApple OSS Distributions<a href="thread_create.html"><strong>thread_create</strong></a>,
39*4f1223e8SApple OSS Distributions<a href="thread_info.html"><strong>thread_info</strong></a>,
40*4f1223e8SApple OSS Distributions<a href="thread_suspend.html"><strong>thread_suspend</strong></a>,
41*4f1223e8SApple OSS Distributions<a href="thread_terminate.html"><strong>thread_terminate</strong></a>.
42