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