<h2>memory_object_change_attributes</h2>

<strong>Function</strong> - Modify caller-specified subset of attributes representing target memory object.

<h3>SYNOPSIS</h3>

<strong>kern_return_t memory_object_change_attributes</strong>

<strong>(memory_object_control_t</strong> <var>memory_control</var>,

<strong>memory_object_flavor_t</strong> <var>flavor</var>,

<strong>memory_object_info_t</strong> <var>attributes</var>,

<strong>attributes</strong> <var>attributes_count</var>,

<strong>mach_port_t</strong> <var>reply_to</var><strong>);</strong>

<h3>PARAMETERS</h3>

<dt> <var>memory_control</var>

[in memory-cache-control send right]

The memory cache control port

to be used by the memory manager for cache management requests.

This port is provided by the kernel in a <strong>memory_object_init</strong>

or <strong>memory_object_create</strong> call.

<dt> <var>flavor</var>

[in scalar]

The type of information to be changed. Valid values are:

<dt> <strong>MEMORY_OBJECT_PERFORMANCE_INFO</strong>

Performance related attributes such as the cache indicator and

the cluster size. <var>attributes</var> should specify a structure of type

<strong>memory_object_perf_info</strong>.

<dt> <strong>MEMORY_OBJECT_BEHAVIOR_INFO</strong>

Behavior related attributes such as the copy strategy and sync

invalidate flag. <var>attributes</var> should specify a structure of type

<strong>memory_object_behavior_info</strong>.

<dt> <strong>MEMORY_OBJECT_ATTRIBUTES_INFO</strong>

Behavior and performance related attributes such as the copy strategy,

cache indicator, and cluster size. <var>attributes</var> should specify a structure of type

<strong>memory_object_attr_info</strong>.

<dt> <var>attributes</var>

[pointer to in structure]

New attributes.

<dt> <var>attributes_count</var>

[in scalar]

The size of the buffer (in natural-sized units).

<dt> <var>reply_port</var>

[in reply receive (to be converted to send) right]

A port to which a

reply (<strong>memory_object_change_completed</strong>) is to be sent indicating the

completion of the attribute change. Such a reply would be useful if the

cache attribute is turned off, since such a change, if the memory object

is no longer mapped, may result in the object being terminated.

<h3>DESCRIPTION</h3>

The <strong>memory_object_change_attributes</strong> function sets various

attributes of the

specified memory object.

<h3>RETURN VALUES</h3>

Only generic errors apply.

<h3>RELATED INFORMATION</h3>

Functions:

<a href="MO_change_completed.html"><strong>memory_object_change_completed</strong></a>,

<a href="MO_get_attributes.html"><strong>memory_object_get_attributes</strong></a>,

<a href="memory_object_create.html"><strong>memory_object_create</strong></a>.

Data Structures:

<a href="memory_object_perf_info.html"><strong>memory_object_perf_info</strong></a>,

<a href="memory_object_attr_info.html"><strong>memory_object_attr_info</strong></a>.