[apple/xnu.git] / osfmk / man / mach_task_self.html

<h2>mach_task_self</h2>\r<hr>\r<p>\r<strong>System Trap</strong> - Return a send right to the caller's task_self port.\r<h3>SYNOPSIS</h3>\r<pre>\r<strong>#include&ltmach/mach_traps.h&gt</strong>\r\r<strong>mach_port_t   mach_task_self (void)</strong>\r</pre>\r<h3>PARAMETERS</h3>\r<p>\rNone.\r<h3>DESCRIPTION</h3>\r<p>\rThe <strong>mach_task_self</strong> function returns send rights to\rthe task's kernel port.\r<h3>NOTES</h3>\r<p>\rThis function call is redefined in the <strong>mach_init.h</strong> file\rto return the caller's <strong>mach_task_self_</strong> environment variable,\rwhich is cached on behalf of the caller's task at runtime.\r(The <strong>mach_init.h</strong> file is itself included via the\r<strong>mach.h</strong> file.\r<h3>RETURN VALUES</h3>\r<p>\rOnly generic errors apply.\r<h3>RELATED INFORMATION</h3>\r<p>\rFunctions:\r<a href="task_set_special_port.html"><strong>task_set_special_port</strong></a>.\r