osfmk/man/task_terminate.html

   1 <h2>task_terminate</h2>
   2 <hr>
   3 <p>
   4 <strong>Function</strong> - Terminate the target task and deallocate its resources.
   5 <h3>SYNOPSIS</h3>
   6 <pre>
   7 <strong>kern_return_t   task_terminate</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]
  16 The port for the task to be destroyed.
  17 </dl>
  18 <h3>DESCRIPTION</h3>
  19 <p>
  20 The <strong>task_terminate</strong> function kills task and all its
  21 threads, if any.  The kernel
  22 frees all resources that are in use by the task.  The kernel
  23 destroys any port for
  24 which the task holds the receive right.
  25 <h3>RETURN VALUES</h3>
  26 <p>
  27 Only generic errors apply.
  28 <h3>RELATED INFORMATION</h3>
  29 <p>
  30 Functions:
  31 <a href="task_create.html"><strong>task_create</strong></a>,
  32 <a href="task_suspend.html"><strong>task_suspend</strong></a>,
  33 <a href="task_resume.html"><strong>task_resume</strong></a>,
  34 <a href="thread_terminate.html"><strong>thread_terminate</strong></a>,
  35 <a href="thread_suspend.html"><strong>thread_suspend</strong></a>.