1 .\"
2 .\" Mach Operating System
3 .\" Copyright (c) 1991,1990 Carnegie Mellon University
4 .\" All Rights Reserved.
5 .\"
6 .\" Permission to use, copy, modify and distribute this software and its
7 .\" documentation is hereby granted, provided that both the copyright
8 .\" notice and this permission notice appear in all copies of the
9 .\" software, derivative works or modified versions, and any portions
10 .\" thereof, and that both notices appear in supporting documentation.
11 .\"
12 .\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
13 .\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
14 .\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
15 .\"
16 .\" Carnegie Mellon requests users of this software to return to
17 .\"
18 .\" Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
19 .\" School of Computer Science
20 .\" Carnegie Mellon University
21 .\" Pittsburgh PA 15213-3890
22 .\"
23 .\" any improvements or extensions that they make and grant Carnegie Mellon
24 .\" the rights to redistribute these changes.
25 .\"
26 .\"
27 .\" HISTORY
28 .\" $Log: memory_object_get_attributes.man,v $
29 .\" Revision 2.5 93/05/10 19:33:52 rvb
30 .\" updated
31 .\" [93/04/21 16:08:40 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:09:50 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:13:07 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:13:49 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:41:03 rpd
41 .\" Created.
42 .\"
43 .TH memory_object_get_attributes 2 12/19/89
44 .CM 4
45 .SH NAME
46 .nf
47 memory_object_get_attributes \- indicate how kernel should handle object
48 .SH SYNOPSIS
49 .nf
50 .ft B
51 #include <mach.h>
52
53 .nf
54 .ft B
55 kern_return_t memory_object_get_attributes(memory_control,
56 object_ready, may_cache_object,
57 copy_strategy)
58 mach_port_t
59 memory_control;
60 boolean_t *object_ready;
61 boolean_t *may_cache_object;
62 memory_object_copy_strategy_t
63 *copy_strategy;
64
65
66 .fi
67 .ft P
68 .SH DESCRIPTION
69
70 .B memory_object_get_attributes
71 retrieves the current attributes
72 associated with the memory object.
73
74 .SH ARGUMENTS
75 .TP 15
76 .B
77 memory_control
78 The port, provided by the kernel
79 in a
80 .B memory_object_init
81 call, to which cache management requests may be issued.
82 .TP 15
83 .B
84 object_ready
85 When set, the kernel may issue new data and unlock requests on the
86 associated memory object.
87 .TP 15
88 .B
89 may_cache_object
90 If set, the kernel may keep data
91 associated with this
92 memory object, even after virtual memory references to it are gone.
93 .TP 15
94 .B
95 copy_strategy
96 How the kernel should copy regions of the associated
97 memory object.
98
99 .SH DIAGNOSTICS
100 .TP 25
101 KERN_SUCCESS
102 This routine does not receive a reply message (and consequently
103 has no return value), so only message transmission errors apply.
104
105 .SH SEE ALSO
106 .B memory_object_set_attributes, memory_object_copy
107
Cache object: d55c6600c06da6c6f94a195470052342
|