1*e13b1fa5SApple OSS Distributions<h2>bootstrap_arguments</h2>
2*e13b1fa5SApple OSS Distributions<hr>
3*e13b1fa5SApple OSS Distributions<p>
4*e13b1fa5SApple OSS Distributions<strong>Function</strong> - Return a set of arguments to the bootstrap task.
5*e13b1fa5SApple OSS Distributions<h3>SYNOPSIS</h3>
6*e13b1fa5SApple OSS Distributions<pre>
7*e13b1fa5SApple OSS Distributions<strong>kern_return_t   bootstrap_arguments</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>arguments</var>
28*e13b1fa5SApple OSS Distributions<dd>
29*e13b1fa5SApple OSS Distributions[pointer to dynamic out array of characters]
30*e13b1fa5SApple OSS DistributionsThe argument strings for the task. This is an array of
31*e13b1fa5SApple OSS Distributions<var>argumentCnt</var> bytes, containing NUL characters
32*e13b1fa5SApple OSS Distributionsseparating the strings.
33*e13b1fa5SApple OSS Distributions<p>
34*e13b1fa5SApple OSS Distributions<dt> <var>argumentsCnt</var>
35*e13b1fa5SApple OSS Distributions<dd>
36*e13b1fa5SApple OSS Distributions[out pointer to scalar]
37*e13b1fa5SApple OSS DistributionsNumber of bytes contained in <var>arguments</var>.
38*e13b1fa5SApple OSS Distributions</dl>
39*e13b1fa5SApple OSS Distributions<h3>DESCRIPTION</h3>
40*e13b1fa5SApple OSS Distributions<p>
41*e13b1fa5SApple OSS DistributionsThe kernel will respond to the bootstrap task (task 1) with the
42*e13b1fa5SApple OSS Distributionsarguments and environment specified to the boot loader. The bootstrap
43*e13b1fa5SApple OSS Distributionstask can act as a server on this interface for the tasks that it
44*e13b1fa5SApple OSS Distributionscreates in order to pass arguments to them. The <strong>libsa_mach.a</strong>
45*e13b1fa5SApple OSS Distributionsstandalone Mach C runtime startup code uses <strong>bootstrap_arguments</strong> and
46*e13b1fa5SApple OSS Distributions<strong>bootstrap_environment</strong> to initialize <var>argc</var>, <var>argv</var>,
47*e13b1fa5SApple OSS Distributionsand <var>envp</var> for <strong>main</strong>.
48*e13b1fa5SApple OSS Distributions<h3>RETURN VALUES</h3>
49*e13b1fa5SApple OSS Distributions<p>
50*e13b1fa5SApple OSS DistributionsOnly generic errors apply.
51*e13b1fa5SApple OSS Distributions<h3>RELATED INFORMATION</h3>
52*e13b1fa5SApple OSS Distributions<p>
53*e13b1fa5SApple OSS DistributionsFunctions:
54*e13b1fa5SApple OSS Distributions<a href="bootstrap_ports.html"><strong>bootstrap_ports</strong></a>,
55*e13b1fa5SApple OSS Distributions<a href="bootstrap_environment.html"><strong>bootstrap_environment</strong></a>.
56*e13b1fa5SApple OSS Distributions
57