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_write.man,v $
29 .\" Revision 2.5 93/05/10 19:33:47 rvb
30 .\" updated
31 .\" [93/04/21 16:08:33 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:09:37 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:13:01 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:13:32 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:40:50 rpd
41 .\" Created.
42 .\"
43 .TH memory_object_data_write 2 12/19/89
44 .CM 4
45 .SH NAME
46 .nf
47 memory_object_data_write \- write data to paging 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_write(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_offeset_t data;
62 vm_size_t data_count;
63
64
65 .fi
66 .ft P
67 .SH DESCRIPTION
68 .B memory_object_data_write
69 provides the memory manager with data that has been
70 modified while cached in physical memory. Once the memory manager no longer
71 needs this data (e.g., it has been written to another storage medium),
72 it should be deallocated using
73 .B vm_deallocate
74 .
75
76 .SH ARGUMENTS
77 .TP 15
78 .B
79 .B memory_object
80 The port that represents the memory object data, as
81 supplied to the kernel in a
82 .B vm_map
83 call.
84 .TP 15
85 .B
86 .B memory_control
87 The request port to which a response is
88 requested. [In the event that a memory object has been supplied
89 to more than one the kernel that has made the request.]
90 .TP 15
91 .B
92 .B offset
93 The offset within a memory object to which this call refers.
94 This will be page aligned.
95 .TP 15
96 .B
97 .B data
98 Data which has been modified while cached in physical memory.
99 .TP 15
100 .B
101 .B data_count
102 The amount of data to be written, in bytes.
103 This will be an integral number of memory object pages.
104
105 .SH DIAGNOSTICS
106 .TP 25
107 .B KERN_SUCCESS
108 Since this routine is called by the kernel, which does not
109 wait for a reply message, this value is ignored.
110
111 .SH SEE ALSO
112 .B vm_deallocate
113
Cache object: d8bda8d6014f435833b7d5113f3669c3
|