xref: /xnu-10002.81.5/osfmk/man/DP_object_create.html (revision 5e3eaea39dcf651e66cb99ba7d70e32cc4a99587)
1*5e3eaea3SApple OSS Distributions<h2>default_pager_object_create</h2>
2*5e3eaea3SApple OSS Distributions<hr>
3*5e3eaea3SApple OSS Distributions<p>
4*5e3eaea3SApple OSS Distributions<strong>Server Interface</strong> - Initialize a non-persistent memory object suitable for sharing between tasks.
5*5e3eaea3SApple OSS Distributions<h3>SYNOPSIS</h3>
6*5e3eaea3SApple OSS Distributions<pre>
7*5e3eaea3SApple OSS Distributions<strong>kern_return_t   default_pager_object_create</strong>
8*5e3eaea3SApple OSS Distributions                <strong>(mach_port_t</strong>                              <var>pager</var>,
9*5e3eaea3SApple OSS Distributions                 <strong>memory_object_t</strong>                 <var>*memory_object</var>,
10*5e3eaea3SApple OSS Distributions                 <strong>vm_size_t</strong>                          <var>object_size</var><strong>);</strong>
11*5e3eaea3SApple OSS Distributions
12*5e3eaea3SApple OSS Distributions
13*5e3eaea3SApple OSS Distributions<strong>kern_return_t   seqnos_default_pager_object_create</strong>
14*5e3eaea3SApple OSS Distributions                <strong>(mach_port_t</strong>                              <var>pager</var>,
15*5e3eaea3SApple OSS Distributions                 <strong>mach_port_seqno_t</strong>                        <var>seqno</var>,
16*5e3eaea3SApple OSS Distributions                 <strong>memory_object_t</strong>                 <var>*memory_object</var>,
17*5e3eaea3SApple OSS Distributions                 <strong>vm_size_t</strong>                          <var>object_size</var><strong>);</strong>
18*5e3eaea3SApple OSS Distributions</pre>
19*5e3eaea3SApple OSS Distributions<h3>PARAMETERS</h3>
20*5e3eaea3SApple OSS Distributions<dl>
21*5e3eaea3SApple OSS Distributions<p>
22*5e3eaea3SApple OSS Distributions<dt> <var>pager</var>
23*5e3eaea3SApple OSS Distributions<dd>
24*5e3eaea3SApple OSS Distributions[in default-pager (receive) right]
25*5e3eaea3SApple OSS DistributionsThe default memory manager service
26*5e3eaea3SApple OSS Distributionsport.
27*5e3eaea3SApple OSS Distributions<p>
28*5e3eaea3SApple OSS Distributions<dt> <var>seqno</var>
29*5e3eaea3SApple OSS Distributions<dd>
30*5e3eaea3SApple OSS Distributions[in scalar]
31*5e3eaea3SApple OSS DistributionsThe sequence number of this message relative to the <var>pager</var>
32*5e3eaea3SApple OSS Distributionsport.
33*5e3eaea3SApple OSS Distributions<p>
34*5e3eaea3SApple OSS Distributions<dt> <var>memory_object</var>
35*5e3eaea3SApple OSS Distributions<dd>
36*5e3eaea3SApple OSS Distributions[out memory-object send right]
37*5e3eaea3SApple OSS DistributionsA memory object port (with full access) for the memory object.
38*5e3eaea3SApple OSS Distributions<p>
39*5e3eaea3SApple OSS Distributions<dt> <var>object_size</var>
40*5e3eaea3SApple OSS Distributions<dd>
41*5e3eaea3SApple OSS Distributions[in scalar]
42*5e3eaea3SApple OSS DistributionsThe maximum size for the memory object.
43*5e3eaea3SApple OSS Distributions</dl>
44*5e3eaea3SApple OSS Distributions<h3>DESCRIPTION</h3>
45*5e3eaea3SApple OSS Distributions<p>
46*5e3eaea3SApple OSS DistributionsA <strong>default_pager_object_create</strong> function is called as
47*5e3eaea3SApple OSS Distributionsthe result of a message
48*5e3eaea3SApple OSS Distributionsrequesting that the default memory manager create and return a (shared) memory
49*5e3eaea3SApple OSS Distributionsobject which is suitable for use with <strong>vm_map</strong>.  This memory object has
50*5e3eaea3SApple OSS Distributionsthe same properties as does a memory object provided by
51*5e3eaea3SApple OSS Distributions<strong>vm_allocate</strong>: its initial
52*5e3eaea3SApple OSS Distributionscontents are zero and the backing contents are temporary in that they do not
53*5e3eaea3SApple OSS Distributionspersist after the memory object is destroyed.  The memory object
54*5e3eaea3SApple OSS Distributionsis suitable for use
55*5e3eaea3SApple OSS Distributionsas non-permanent shared memory.  The kernel does not make this call itself
56*5e3eaea3SApple OSS Distributions(which is why it can be a synchronous call); this request is only issued by
57*5e3eaea3SApple OSS Distributions(privileged) tasks holding the default memory manager port.
58*5e3eaea3SApple OSS DistributionsThis call should be
59*5e3eaea3SApple OSS Distributionscontrasted with the kernel's <strong>memory_object_create</strong> message, in which
60*5e3eaea3SApple OSS Distributionsthe memory cache object is already created and the identity of the abstract
61*5e3eaea3SApple OSS Distributionsmemory object is made known to the default manager.
62*5e3eaea3SApple OSS Distributions<h3>RETURN VALUES</h3>
63*5e3eaea3SApple OSS Distributions<p>
64*5e3eaea3SApple OSS DistributionsOnly generic errors apply.
65*5e3eaea3SApple OSS Distributions<h3>RELATED INFORMATION</h3>
66*5e3eaea3SApple OSS Distributions<p>
67*5e3eaea3SApple OSS DistributionsFunctions:
68*5e3eaea3SApple OSS Distributions<a href="vm_map.html"><strong>vm_map</strong></a>,
69*5e3eaea3SApple OSS Distributions<a href="HD_memory_manager.html"><strong>host_default_memory_manager</strong></a>,
70*5e3eaea3SApple OSS Distributions<a href="memory_object_create.html"><strong>memory_object_create</strong></a>,
71*5e3eaea3SApple OSS Distributions<a href="MO_default_server.html"><strong>memory_object_default_server</strong></a>,
72*5e3eaea3SApple OSS Distributions<a href="SMO_default_server.html"><strong>seqnos_memory_object_default_server</strong></a>.
73