X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..refs/heads/master:/osfmk/man/MO_change_attributes.html diff --git a/osfmk/man/MO_change_attributes.html b/osfmk/man/MO_change_attributes.html old mode 100755 new mode 100644 index 1bca01076..26f2b4f5a --- a/osfmk/man/MO_change_attributes.html +++ b/osfmk/man/MO_change_attributes.html @@ -1 +1,88 @@ -

memory_object_change_attributes


Function - Modify caller-specified subset of attributes representing target memory object.

SYNOPSIS

kern_return_t   memory_object_change_attributes
                (memory_object_control_t         memory_control,
                 memory_object_flavor_t                  flavor,
                 memory_object_info_t                attributes,
                 attributes                    attributes_count,
                 mach_port_t                           reply_to);

PARAMETERS

memory_control
[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 memory_object_init or memory_object_create call.

flavor
[in scalar] The type of information to be changed. Valid values are:

MEMORY_OBJECT_PERFORMANCE_INFO
Performance related attributes such as the cache indicator and the cluster size. attributes should specify a structure of type memory_object_perf_info.

MEMORY_OBJECT_BEHAVIOR_INFO
Behavior related attributes such as the copy strategy and sync invalidate flag. attributes should specify a structure of type memory_object_behavior_info.

MEMORY_OBJECT_ATTRIBUTES_INFO
Behavior and performance related attributes such as the copy strategy, cache indicator, and cluster size. attributes should specify a structure of type memory_object_attr_info.

attributes
[pointer to in structure] New attributes.

attributes_count
[in scalar] The size of the buffer (in natural-sized units).

reply_port
[in reply receive (to be converted to send) right] A port to which a reply (memory_object_change_completed) 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.

DESCRIPTION

The memory_object_change_attributes function sets various attributes of the specified memory object.

RETURN VALUES

Only generic errors apply.

RELATED INFORMATION

Functions: memory_object_change_completed, memory_object_get_attributes, memory_object_create.

Data Structures: memory_object_perf_info, memory_object_attr_info. \ No newline at end of file +

memory_object_change_attributes

+
+

+Function - Modify caller-specified subset of attributes representing target memory object. +

SYNOPSIS

+
+kern_return_t   memory_object_change_attributes
+                (memory_object_control_t         memory_control,
+                 memory_object_flavor_t                  flavor,
+                 memory_object_info_t                attributes,
+                 attributes                    attributes_count,
+                 mach_port_t                           reply_to);
+
+

PARAMETERS

+
+

+

memory_control +
+[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 memory_object_init + or memory_object_create call. +

+

flavor +
+[in scalar] +The type of information to be changed. Valid values are: +
+

+

MEMORY_OBJECT_PERFORMANCE_INFO +
+Performance related attributes such as the cache indicator and +the cluster size. attributes should specify a structure of type +memory_object_perf_info. +

+

MEMORY_OBJECT_BEHAVIOR_INFO +
+Behavior related attributes such as the copy strategy and sync +invalidate flag. attributes should specify a structure of type +memory_object_behavior_info. +

+

MEMORY_OBJECT_ATTRIBUTES_INFO +
+Behavior and performance related attributes such as the copy strategy, +cache indicator, and cluster size. attributes should specify a structure of type +memory_object_attr_info. +
+

+

attributes +
+[pointer to in structure] +New attributes. +

+

attributes_count +
+[in scalar] +The size of the buffer (in natural-sized units). +

+

reply_port +
+[in reply receive (to be converted to send) right] +A port to which a +reply (memory_object_change_completed) 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. +
+

DESCRIPTION

+

+The memory_object_change_attributes function sets various +attributes of the +specified memory object. +

RETURN VALUES

+

+Only generic errors apply. +

RELATED INFORMATION

+

+Functions: +memory_object_change_completed, +memory_object_get_attributes, +memory_object_create. +

+Data Structures: +memory_object_perf_info, +memory_object_attr_info. + +