osfmk/man/MO_change_completed.html

   1 <h2>memory_object_change_completed</h2>
   2 <hr>
   3 <p>
   4 <strong>Server Interface</strong> - Notify memory manager that kernel has updated memory object attributes as requested.
   5 <h3>SYNOPSIS</h3>
   6 <pre>
   7 <strong>kern_return_t   memory_object_change_completed</strong>
   8                 <strong>(memory_object_t</strong>                     <var>reply_port</var>,
   9                  <strong>memory_object_control_t</strong>         <var>memory_control</var>,
  10                  <strong>memory_object_flavor_t</strong>                  <var>flavor</var><strong>);</strong>
  11
  12
  13 <strong>kern_return_t   seqnos_memory_object_change_completed</strong>
  14                 <strong>(memory_object_t</strong>                     <var>reply_port</var>,
  15                  <strong>mach_port_seqno_t</strong>                        <var>seqno</var>,
  16                  <strong>memory_object_control_t</strong>         <var>memory_control</var>,
  17                  <strong>memory_object_flavor_t</strong>                  <var>flavor</var><strong>);</strong>
  18 </pre>
  19 <h3>PARAMETERS</h3>
  20 <dl>
  21 <p>
  22 <dt> <var>reply_port</var>
  23 <dd>
  24 [in reply (receive) right]
  25 The port supplied in the corresponding
  26 <strong>memory_object_change_attributes</strong> call.
  27 <p>
  28 <dt> <var>seqno</var>
  29 <dd>
  30 [in scalar]
  31 The sequence number of this message relative to the port
  32 named in the <strong>memory_object_change_attributes</strong> call.
  33 <p>
  34 <dt> <var>memory_control</var>
  35 <dd>
  36 [in memory-cache-control send right]
  37 The memory cache control port
  38 to be used for a response by the memory manager.  If the memory
  39 object has been supplied to more than one kernel, this parameter
  40 identifies the kernel that is making the call.
  41 <p>
  42 <dt> <var>flavor</var>
  43 <dd>
  44 [in scalar]
  45 The flavor of attributes changed by the corresponding
  46 <strong>memory_object_change_attributes</strong> call.
  47 </dl>
  48 <h3>DESCRIPTION</h3>
  49 <p>
  50 A <strong>memory_object_change_completed</strong> function is called
  51 as the result of a
  52 kernel message confirming the kernel's action in response to a
  53 <strong>memory_object_change_attributes</strong> call from the memory manager.
  54 <p>
  55 When the kernel completes the requested changes, it calls
  56 <strong>memory_object_change_completed</strong> (asynchronously) using
  57 the port explicitly provided in
  58 the <strong>memory_object_change_attributes</strong> call.
  59 <h3>RETURN VALUES</h3>
  60 <p>
  61 Only generic errors apply.
  62 <h3>RELATED INFORMATION</h3>
  63 <p>
  64 Functions:
  65 <a href="MO_change_attributes.html"><strong>memory_object_change_attributes</strong></a>,
  66 <a href="memory_object_server.html"><strong>memory_object_server</strong></a>,
  67 <a href="SMO_server.html"><strong>seqnos_memory_object_server</strong></a>.