1*e13b1fa5SApple OSS Distributions<h2>bootstrap_environment</h2> 2*e13b1fa5SApple OSS Distributions<hr> 3*e13b1fa5SApple OSS Distributions<p> 4*e13b1fa5SApple OSS Distributions<strong>Function</strong> - Return to the bootstrap task an array of strings specifying the task's environment. 5*e13b1fa5SApple OSS Distributions<h3>SYNOPSIS</h3> 6*e13b1fa5SApple OSS Distributions<pre> 7*e13b1fa5SApple OSS Distributions<strong>kern_return_t bootstrap_environment</strong> 8*e13b1fa5SApple OSS Distributions <strong>(mach_port_t</strong> <var>bootstrap</var>, 9*e13b1fa5SApple OSS Distributions <strong>task_t</strong> <var>task</var>, 10*e13b1fa5SApple OSS Distributions <strong>pointer_t</strong> <var>pointer_t</var>, 11*e13b1fa5SApple OSS Distributions <strong>mach_msg_type_number_t</strong> <var>mach_msg_type_number_t</var><strong>);</strong> 12*e13b1fa5SApple OSS Distributions</pre> 13*e13b1fa5SApple OSS Distributions<h3>PARAMETERS</h3> 14*e13b1fa5SApple OSS Distributions<dl> 15*e13b1fa5SApple OSS Distributions<p> 16*e13b1fa5SApple OSS Distributions<dt> <var>bootstrap</var> 17*e13b1fa5SApple OSS Distributions<dd> 18*e13b1fa5SApple OSS Distributions[in bootstrap send right] 19*e13b1fa5SApple OSS DistributionsThe bootstrap port for the task, obtained from 20*e13b1fa5SApple OSS Distributions<strong>task_get_special_ports</strong>. 21*e13b1fa5SApple OSS Distributions<p> 22*e13b1fa5SApple OSS Distributions<dt> <var>task</var> 23*e13b1fa5SApple OSS Distributions<dd> 24*e13b1fa5SApple OSS Distributions[in task send right] 25*e13b1fa5SApple OSS DistributionsThe task port for the task whose argument strings are requested. 26*e13b1fa5SApple OSS Distributions<p> 27*e13b1fa5SApple OSS Distributions<dt> <var>environment</var> 28*e13b1fa5SApple OSS Distributions<dd> 29*e13b1fa5SApple OSS Distributions[pointer to dynamic out array of characters] 30*e13b1fa5SApple OSS DistributionsThe environment strings for the task. This is an array of 31*e13b1fa5SApple OSS Distributions\*V*_environmentCnt_\*O bytes, containing NUL characters 32*e13b1fa5SApple OSS Distributionsseparating the strings. 33*e13b1fa5SApple OSS Distributions<p> 34*e13b1fa5SApple OSS Distributions<dt> <var>environmentCnt</var> 35*e13b1fa5SApple OSS Distributions<dd> 36*e13b1fa5SApple OSS Distributions[out pointer to scalar] 37*e13b1fa5SApple OSS DistributionsNumber of bytes contained in <var>_environment_</var>. 38*e13b1fa5SApple OSS Distributions</dl> 39*e13b1fa5SApple OSS Distributions<h3>DESCRIPTION</h3> 40*e13b1fa5SApple OSS DistributionsThe kernel will respond to the bootstrap task (task 1) with the 41*e13b1fa5SApple OSS Distributionsarguments and environment specified to the boot loader. The bootstrap 42*e13b1fa5SApple OSS Distributionstask can act as a server on this interface for the tasks that it 43*e13b1fa5SApple OSS Distributionscreates in order to pass an environment to them. The \*Llibsa_mach.a\*O 44*e13b1fa5SApple OSS Distributionsstandalone Mach C runtime startup code uses <strong>bootstrap_arguments</strong> and 45*e13b1fa5SApple OSS Distributions<strong>bootstrap_environment</strong> to initialize <var>argc</var>, <var>argv</var>, 46*e13b1fa5SApple OSS Distributionsand <var>envp</var> for <strong>main</strong>. 47*e13b1fa5SApple OSS Distributions<h3>RETURN VALUES</h3> 48*e13b1fa5SApple OSS Distributions<p> 49*e13b1fa5SApple OSS DistributionsOnly generic errors apply. 50*e13b1fa5SApple OSS Distributions<h3>RELATED INFORMATION</h3> 51*e13b1fa5SApple OSS Distributions<p> 52*e13b1fa5SApple OSS DistributionsFunctions: 53*e13b1fa5SApple OSS Distributions<a href="bootstrap_ports.html"><strong>bootstrap_ports</strong></a>, 54*e13b1fa5SApple OSS Distributions<a href="bootstrap_arguments.html"><strong>bootstrap_arguments</strong></a>. 55*e13b1fa5SApple OSS Distributions 56*e13b1fa5SApple OSS Distributions 57