[apple/xnu.git] / osfmk / man / bootstrap_completed.html

<h2>bootstrap_completed</h2>\r<hr>\r<p>\r<strong>Server Interface</strong> - Inform bootstrap server that\rinitialization is complete.\r<h3>SYNOPSIS</h3>\r<pre>\r<strong>kern_return_t   bootstrap_completed</strong>\r                <strong>(mach_port_t</strong>                     <var>bootstrap_port</var>,\r                 <strong>task_t</strong>                                    <var>task</var><strong>);</strong>\r</pre>\r<h3>PARAMETERS</h3>\r<dl>\r<p>\r<dt> <var>bootstrap_port</var> \r<dd>\rThe port representing the calling task's bootstrap server.\r<p>\r<dt> <var>task</var> \r<dd>\rThis parameter represents the calling task.\r</dl>\r<h3>DESCRIPTION</h3>\r<p>\rThis interface allows a given server task to inform the bootstrap\rserver that it is fully initialized and ready to handle requests.\rUpon receiving such notification, the bootstrap server can initialize\rany additional servers that may require services provided by the\rpreviously initialized server.\r<p>\rNote the following:  not all servers that may be invoked by the bootstrap server\rsend this message upon startup.  If the bootstrap server is told to\rwait for this message before spawning further servers (via setting a\rflag in the <strong>bootstrap.conf</strong> file) and the server just invoked never\rsends this message, the bootstrap server will wait forever.\r<h3>NOTES</h3>\r<p>\rCurrently, this interface is used exclusively by the default\rpager server so that the bootstrap server can defer initializing the\rOS server until the default pager is in place.  (In small memory\rconfigurations, an OS server may not be able to initialize\rsuccessfully unless the default pager is ready to handle paging\rrequests.)\r<h3>RETURN VALUES</h3>\r<dl>\r<p>\r<dt> <strong>KERN_SUCCESS</strong>\r<dd>\rThe bootstrap server has updated the calling server's state with\rrespect to bootstrap completion.\r<p>\r<dt> <strong>KERN_INVALID_ARGUMENT</strong>\r<dd>\rThe bootstrap server does not recognize the calling server (the task\rspecified by the <var>task</var> parameter).\r</dl>  \r<h3>RELATED INFORMATION</h3>\r<p>\rFunctions:\r