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_data_initialize.man,v $
29 .\" Revision 2.5 93/05/10 19:33:30 rvb
30 .\" updated
31 .\" [93/04/21 16:08:14 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:08:53 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:12:43 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:13:02 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:39:43 rpd
41 .\" Created.
42 .\"
43 .TH memory_object_data_initialize 2 12/22/89
44 .CM 4
45 .SH NAME
46 .nf
47 memory_object_data_initialize \- provides initial data for memory 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_data_initialize(memory_object,memory_control,
56 offset, data, data_count)
57 mach_port_t memory_object;
58 mach_port_t
59 memory_control;
60 vm_offset_t offset;
61 vm_offset_t data;
62 vm_size_t data_count;
63
64
65
66 .fi
67 .ft P
68 .SH DESCRIPTION
69 .B memory_object_data_initialize
70 provides the memory manager with initial data for
71 a kernel-created memory object. If the memory manager already has been
72 supplied data (by a previous
73 .B memory_object_data_initialize
74 or
75 .B memory_object_data_write
76 ),
77 then this data should be ignored. Otherwise, this call behaves
78 exactly as does
79 .B memory_object_data_write
80 . This call will only be made
81 on memory objects created by the kernel via
82 .B memory_object_create
83
84 and thus will only be made to default memory managers. This call will not
85 be made on objects created via
86 .B memory_object_copy
87 .
88
89 .SH ARGUMENTS
90 .TP 15
91 .B
92 .B memory_object
93 The port that represents the memory object data, as
94 supplied by the kernel in a
95 .B memory_object_create
96 call.
97 .TP 15
98 .B
99 .B memory_control
100 The request port to which a response is
101 requested. [In the event that a memory object has been supplied
102 to more than one the kernel that has made the request.]
103 .TP 15
104 .B
105 .B offset
106 The offset within a memory object to which this call refers.
107 This will be page aligned.
108 .TP 15
109 .B
110 .B data
111 Data which has been modified while cached in physical memory.
112 .TP 15
113 .B
114 .B data_count
115 The amount of data to be written, in bytes. This will be
116 an integral number of memory object pages.
117
118 .SH DIAGNOSTICS
119 .TP 25
120 .B KERN_SUCCESS
121 Since this routine is called by the kernel, which does not
122 wait for a reply message, this value is ignored.
123
124 .SH SEE ALSO
125 .B memory_object_data_write, memory_object_create
126
127
Cache object: 322c9ac863cc85d35373f1c11b1e0856
|