xref: /xnu-11215/osfmk/man/notify_server.html (revision 186b8fce)
1*e13b1fa5SApple OSS Distributions<h2>notify_server</h2>
2*e13b1fa5SApple OSS Distributions<hr>
3*e13b1fa5SApple OSS Distributions<p>
4*e13b1fa5SApple OSS Distributions<strong>Function</strong> - Handle the next kernel-generated IPC notification.
5*e13b1fa5SApple OSS Distributions<h3>SYNOPSIS</h3>
6*e13b1fa5SApple OSS Distributions<pre>
7*e13b1fa5SApple OSS Distributions<strong>boolean_t	notify_server</strong>
8*e13b1fa5SApple OSS Distributions		<strong>(mach_msg_header_t</strong>	<var>request_msg</var>,
9*e13b1fa5SApple OSS Distributions		<strong>mach_msg_header_t</strong>	<var>reply_ms</var><strong>);</strong>
10*e13b1fa5SApple OSS Distributions</pre>
11*e13b1fa5SApple OSS Distributions<h3>PARAMETERS</h3>
12*e13b1fa5SApple OSS Distributions<dl>
13*e13b1fa5SApple OSS Distributions<p>
14*e13b1fa5SApple OSS Distributions<dt> <var>in_msg</var>
15*e13b1fa5SApple OSS Distributions<dd>
16*e13b1fa5SApple OSS Distributions[pointer to in structure]
17*e13b1fa5SApple OSS DistributionsThe notification message received from the
18*e13b1fa5SApple OSS Distributionskernel.
19*e13b1fa5SApple OSS Distributions<p>
20*e13b1fa5SApple OSS Distributions<dt> <var>out_msg</var>
21*e13b1fa5SApple OSS Distributions<dd>
22*e13b1fa5SApple OSS Distributions[out structure]
23*e13b1fa5SApple OSS DistributionsNot used.
24*e13b1fa5SApple OSS Distributions</dl>
25*e13b1fa5SApple OSS Distributions<h3>DESCRIPTION</h3>
26*e13b1fa5SApple OSS Distributions<p>
27*e13b1fa5SApple OSS DistributionsThe <strong>notify_server</strong> function is the MIG generated server
28*e13b1fa5SApple OSS Distributionshandling function to
29*e13b1fa5SApple OSS Distributionshandle messages from the kernel corresponding to IPC notifications.  Such
30*e13b1fa5SApple OSS Distributionsmessages are delivered to the notification port named in a <strong>mach_msg</strong>
31*e13b1fa5SApple OSS Distributionsor <strong>mach_port_request_notification</strong> call.  The <strong>notify_server</strong>
32*e13b1fa5SApple OSS Distributionsfunction performs all necessary
33*e13b1fa5SApple OSS Distributionsargument handling for this kernel message and calls the appropriate handling
34*e13b1fa5SApple OSS Distributionsfunction.  These functions must be supplied by the caller.
35*e13b1fa5SApple OSS Distributions<h3>RETURN VALUES</h3>
36*e13b1fa5SApple OSS Distributions<dl>
37*e13b1fa5SApple OSS Distributions<p>
38*e13b1fa5SApple OSS Distributions<dt> <strong>TRUE</strong>
39*e13b1fa5SApple OSS Distributions<dd>
40*e13b1fa5SApple OSS DistributionsThe message was handled and the appropriate function was called.
41*e13b1fa5SApple OSS Distributions<p>
42*e13b1fa5SApple OSS Distributions<dt> <strong>FALSE</strong>
43*e13b1fa5SApple OSS Distributions<dd>
44*e13b1fa5SApple OSS DistributionsThe message did not apply to the notification mechanism and no other
45*e13b1fa5SApple OSS Distributionsaction was taken.
46*e13b1fa5SApple OSS Distributions</dl>
47*e13b1fa5SApple OSS Distributions<h3>RELATED INFORMATION</h3>
48*e13b1fa5SApple OSS Distributions<p>
49*e13b1fa5SApple OSS DistributionsFunctions:
50*e13b1fa5SApple OSS Distributions<a href="seqnos_notify_server.html"><strong>seqnos_notify_server<strong></a>,
51*e13b1fa5SApple OSS Distributions<a href="do_mach_notify_dead_name.html"><strong>do_mach_notify_dead_name<strong></a>,
52*e13b1fa5SApple OSS Distributions<a href="do_mach_notify_no_senders.html"><strong>do_mach_notify_no_senders<strong></a>,
53*e13b1fa5SApple OSS Distributions<a href="DMN_port_deleted.html"><strong>do_mach_notify_port_deleted<strong></a>,
54*e13b1fa5SApple OSS Distributions<a href="do_mach_notify_send_once.html"><strong>do_mach_notify_send_once<strong></a>.
55