1*1031c584SApple OSS Distributions<h2>task_set_emulation_vector</h2> 2*1031c584SApple OSS Distributions<hr> 3*1031c584SApple OSS Distributions<p> 4*1031c584SApple OSS Distributions<strong>Function</strong> - Establish the target task's user-level system call handlers. 5*1031c584SApple OSS Distributions<h3>SYNOPSIS</h3> 6*1031c584SApple OSS Distributions<pre> 7*1031c584SApple OSS Distributions<strong>kern_return_t task_set_emulation_vector</strong> 8*1031c584SApple OSS Distributions <strong>(task_t</strong> <var>task</var>, 9*1031c584SApple OSS Distributions <strong>int</strong> <var>vector_start</var>, 10*1031c584SApple OSS Distributions <strong>emulation_vector_t</strong> <var>emulation_vector</var>, 11*1031c584SApple OSS Distributions <strong>mach_msg_type_number_t</strong> <var>emulation_vector_count</var><strong>);</strong> 12*1031c584SApple OSS Distributions</pre> 13*1031c584SApple OSS Distributions<h3>PARAMETERS</h3> 14*1031c584SApple OSS Distributions<dl> 15*1031c584SApple OSS Distributions<p> 16*1031c584SApple OSS Distributions<dt> <var>task</var> 17*1031c584SApple OSS Distributions<dd> 18*1031c584SApple OSS Distributions[in task send right] 19*1031c584SApple OSS DistributionsThe port for the task for which to establish the 20*1031c584SApple OSS Distributionssystem call handler. 21*1031c584SApple OSS Distributions<p> 22*1031c584SApple OSS Distributions<dt> <var>vector_start</var> 23*1031c584SApple OSS Distributions<dd> 24*1031c584SApple OSS Distributions[in scalar] 25*1031c584SApple OSS DistributionsThe syscall number corresponding to the first element of 26*1031c584SApple OSS Distributions<var>emulation_vector</var>. 27*1031c584SApple OSS Distributions<p> 28*1031c584SApple OSS Distributions<dt> <var>emulation_vector</var> 29*1031c584SApple OSS Distributions<dd> 30*1031c584SApple OSS Distributions[pointer to in array of <strong>vm_address_t</strong>] 31*1031c584SApple OSS DistributionsAn array of routine entrypoints 32*1031c584SApple OSS Distributionsfor the system calls starting with syscall number <var>vector_start</var>. 33*1031c584SApple OSS Distributions<p> 34*1031c584SApple OSS Distributions<dt> <var>emulation_vector_count</var> 35*1031c584SApple OSS Distributions<dd> 36*1031c584SApple OSS Distributions[in scalar] 37*1031c584SApple OSS DistributionsThe number of elements in <var>emulation_vector</var>. 38*1031c584SApple OSS Distributions</dl> 39*1031c584SApple OSS Distributions<h3>DESCRIPTION</h3> 40*1031c584SApple OSS Distributions<p> 41*1031c584SApple OSS DistributionsThe <strong>task_set_emulation_vector</strong> function establishes 42*1031c584SApple OSS Distributionsa handler within the task 43*1031c584SApple OSS Distributionsfor a set of system calls. When a thread executes a system call 44*1031c584SApple OSS Distributionswith one of these 45*1031c584SApple OSS Distributionsnumbers, the system call will be redirected to the corresponding 46*1031c584SApple OSS Distributionsroutine within 47*1031c584SApple OSS Distributionsthe task's address space. 48*1031c584SApple OSS Distributions<p> 49*1031c584SApple OSS DistributionsThese emulation handler addresses are inherited by child processes. 50*1031c584SApple OSS Distributions<h3>NOTES</h3> 51*1031c584SApple OSS Distributions<p> 52*1031c584SApple OSS DistributionsThis interface is machine word length specific because of the 53*1031c584SApple OSS Distributionsvirtual addresses 54*1031c584SApple OSS Distributionsin the <var>emulation_vector</var> parameter. 55*1031c584SApple OSS Distributions<h3>RETURN VALUES</h3> 56*1031c584SApple OSS Distributions<p> 57*1031c584SApple OSS DistributionsOnly generic errors apply. 58*1031c584SApple OSS Distributions<h3>RELATED INFORMATION</h3> 59*1031c584SApple OSS Distributions<p> 60*1031c584SApple OSS DistributionsFunctions: 61*1031c584SApple OSS Distributions<a href="task_get_emulation_vector.html"><strong>task_get_emulation_vector</strong></a>. 62