forked from apple/darwin-xnu
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathbootstrap_arguments.html
56 lines (55 loc) · 1.94 KB
/
bootstrap_arguments.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<h2>bootstrap_arguments</h2>
<hr>
<p>
<strong>Function</strong> - Return a set of arguments to the bootstrap task.
<h3>SYNOPSIS</h3>
<pre>
<strong>kern_return_t bootstrap_arguments</strong>
<strong>(mach_port_t</strong> <var>bootstrap</var>,
<strong>task_t</strong> <var>task</var>,
<strong>pointer_t</strong> <var>pointer_t</var>,
<strong>mach_msg_type_number_t</strong> <var>mach_msg_type_number_t</var><strong>);</strong>
</pre>
<h3>PARAMETERS</h3>
<dl>
<p>
<dt> <var>bootstrap</var>
<dd>
[in bootstrap send right]
The bootstrap port for the task, obtained from
<strong>task_get_special_ports</strong>.
<p>
<dt> <var>task</var>
<dd>
[in task send right]
The task port for the task whose argument strings are requested.
<p>
<dt> <var>arguments</var>
<dd>
[pointer to dynamic out array of characters]
The argument strings for the task. This is an array of
<var>argumentCnt</var> bytes, containing NUL characters
separating the strings.
<p>
<dt> <var>argumentsCnt</var>
<dd>
[out pointer to scalar]
Number of bytes contained in <var>arguments</var>.
</dl>
<h3>DESCRIPTION</h3>
<p>
The kernel will respond to the bootstrap task (task 1) with the
arguments and environment specified to the boot loader. The bootstrap
task can act as a server on this interface for the tasks that it
creates in order to pass arguments to them. The <strong>libsa_mach.a</strong>
standalone Mach C runtime startup code uses <strong>bootstrap_arguments</strong> and
<strong>bootstrap_environment</strong> to initialize <var>argc</var>, <var>argv</var>,
and <var>envp</var> for <strong>main</strong>.
<h3>RETURN VALUES</h3>
<p>
Only generic errors apply.
<h3>RELATED INFORMATION</h3>
<p>
Functions:
<a href="bootstrap_ports.html"><strong>bootstrap_ports</strong></a>,
<a href="bootstrap_environment.html"><strong>bootstrap_environment</strong></a>.