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