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_provided.man,v $
29 .\" Revision 2.5 93/05/10 19:33:33 rvb
30 .\" updated
31 .\" [93/04/21 16:08:17 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:09:04 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:12:46 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:13:07 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:39:59 rpd
41 .\" Created.
42 .\"
43 .TH memory_object_data_provided 2 12/18/89
44 .CM 4
45 .SH NAME
46 .nf
47 memory_object_data_provided \- gives kernel 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_provided(memory_control,
56 offset, data, data_count, lock_value)
57 mach_port_t
58 memory_control;
59 vm_offset_t offset;
60 vm_offset_t data;
61 vm_size_t data_count;
62 vm_prot_t lock_value;
63
64
65
66 .fi
67 .ft P
68 .SH DESCRIPTION
69 .B memory_object_data_provided
70 supplies the kernel with data for the
71 specified memory object. Ordinarily, memory managers should only provide data in
72 reponse to
73 .B memory_object_data_request
74 calls from the kernel.
75 The
76 .B lock_value
77 specifies what type of access will
78 .B not
79 be allowed
80 to the data range. The lock values must be one or more of the set:
81 .B VM_PROT_NONE, VM_PROT_READ, VM_PROT_WRITE, VM_PROT_EXECUTE
82 and
83 .B VM_PROT_ALL
84 as defined in
85 .B <mach/vm_prot.h>
86 .
87
88 .SH ARGUMENTS
89 .TP 15
90 .B
91 memory_control
92 The port, provided by the kernel
93 in a
94 .B memory_object_init
95 call, to which cache management requests may be issued.
96 .TP 15
97 .B
98 offset
99 An offset within a memory object, in bytes. This must be
100 page aligned.
101 .TP 15
102 .B
103 data
104 Data that is being provided to the kernel. This is a pointer
105 to the data.
106 .TP 15
107 .B
108 data_count
109 The amount of data to be provided. Must be an integral number
110 of memory object pages.
111 .TP 15
112 .B
113 lock_value
114 A protection value indicating those forms of access that should
115 .B not
116 be permitted to the specified cached data.
117
118 .SH DIAGNOSTICS
119 .TP 25
120 KERN_SUCCESS
121 This routine does not receive a reply message (and consequently
122 has no return value), so only message transmission errors apply.
123
124 .SH SEE ALSO
125 .B memory_object_data_request, memory_object_data_error, memory_object_lock_request
126
Cache object: 0ba3a760047f13612080056ac40f8563
|