xref: /xnu-11417.101.15/osfmk/man/bootstrap_completed.html (revision e3723e1f17661b24996789d8afc084c0c3303b26)
1*e3723e1fSApple OSS Distributions<h2>bootstrap_completed</h2>
2*e3723e1fSApple OSS Distributions<hr>
3*e3723e1fSApple OSS Distributions<p>
4*e3723e1fSApple OSS Distributions<strong>Server Interface</strong> - Inform bootstrap server that
5*e3723e1fSApple OSS Distributionsinitialization is complete.
6*e3723e1fSApple OSS Distributions<h3>SYNOPSIS</h3>
7*e3723e1fSApple OSS Distributions<pre>
8*e3723e1fSApple OSS Distributions<strong>kern_return_t   bootstrap_completed</strong>
9*e3723e1fSApple OSS Distributions                <strong>(mach_port_t</strong>                     <var>bootstrap_port</var>,
10*e3723e1fSApple OSS Distributions                 <strong>task_t</strong>                                    <var>task</var><strong>);</strong>
11*e3723e1fSApple OSS Distributions</pre>
12*e3723e1fSApple OSS Distributions<h3>PARAMETERS</h3>
13*e3723e1fSApple OSS Distributions<dl>
14*e3723e1fSApple OSS Distributions<p>
15*e3723e1fSApple OSS Distributions<dt> <var>bootstrap_port</var>
16*e3723e1fSApple OSS Distributions<dd>
17*e3723e1fSApple OSS DistributionsThe port representing the calling task's bootstrap server.
18*e3723e1fSApple OSS Distributions<p>
19*e3723e1fSApple OSS Distributions<dt> <var>task</var>
20*e3723e1fSApple OSS Distributions<dd>
21*e3723e1fSApple OSS DistributionsThis parameter represents the calling task.
22*e3723e1fSApple OSS Distributions</dl>
23*e3723e1fSApple OSS Distributions<h3>DESCRIPTION</h3>
24*e3723e1fSApple OSS Distributions<p>
25*e3723e1fSApple OSS DistributionsThis interface allows a given server task to inform the bootstrap
26*e3723e1fSApple OSS Distributionsserver that it is fully initialized and ready to handle requests.
27*e3723e1fSApple OSS DistributionsUpon receiving such notification, the bootstrap server can initialize
28*e3723e1fSApple OSS Distributionsany additional servers that may require services provided by the
29*e3723e1fSApple OSS Distributionspreviously initialized server.
30*e3723e1fSApple OSS Distributions<p>
31*e3723e1fSApple OSS DistributionsNote the following:  not all servers that may be invoked by the bootstrap server
32*e3723e1fSApple OSS Distributionssend this message upon startup.  If the bootstrap server is told to
33*e3723e1fSApple OSS Distributionswait for this message before spawning further servers (via setting a
34*e3723e1fSApple OSS Distributionsflag in the <strong>bootstrap.conf</strong> file) and the server just invoked never
35*e3723e1fSApple OSS Distributionssends this message, the bootstrap server will wait forever.
36*e3723e1fSApple OSS Distributions<h3>NOTES</h3>
37*e3723e1fSApple OSS Distributions<p>
38*e3723e1fSApple OSS DistributionsCurrently, this interface is used exclusively by the default
39*e3723e1fSApple OSS Distributionspager server so that the bootstrap server can defer initializing the
40*e3723e1fSApple OSS DistributionsOS server until the default pager is in place.  (In small memory
41*e3723e1fSApple OSS Distributionsconfigurations, an OS server may not be able to initialize
42*e3723e1fSApple OSS Distributionssuccessfully unless the default pager is ready to handle paging
43*e3723e1fSApple OSS Distributionsrequests.)
44*e3723e1fSApple OSS Distributions<h3>RETURN VALUES</h3>
45*e3723e1fSApple OSS Distributions<dl>
46*e3723e1fSApple OSS Distributions<p>
47*e3723e1fSApple OSS Distributions<dt> <strong>KERN_SUCCESS</strong>
48*e3723e1fSApple OSS Distributions<dd>
49*e3723e1fSApple OSS DistributionsThe bootstrap server has updated the calling server's state with
50*e3723e1fSApple OSS Distributionsrespect to bootstrap completion.
51*e3723e1fSApple OSS Distributions<p>
52*e3723e1fSApple OSS Distributions<dt> <strong>KERN_INVALID_ARGUMENT</strong>
53*e3723e1fSApple OSS Distributions<dd>
54*e3723e1fSApple OSS DistributionsThe bootstrap server does not recognize the calling server (the task
55*e3723e1fSApple OSS Distributionsspecified by the <var>task</var> parameter).
56*e3723e1fSApple OSS Distributions</dl>
57*e3723e1fSApple OSS Distributions<h3>RELATED INFORMATION</h3>
58*e3723e1fSApple OSS Distributions<p>
59*e3723e1fSApple OSS DistributionsFunctions:
60