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_unlock.man,v $
29 .\" Revision 2.5 93/05/10 19:33:44 rvb
30 .\" updated
31 .\" [93/04/21 16:08:30 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:09:25 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:12:57 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:13:28 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:40:43 rpd
41 .\" Created.
42 .\"
43 .TH memory_object_data_unlock 2 12/19/89
44 .CM 4
45 .SH NAME
46 .nf
47 memory_object_data_unlock \- request to unlock 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_unlock(memory_object, memory_control,
56 offset, length, desired_access)
57 mach_port_t memory_object;
58 mach_port_t
59 memory_control;
60 vm_offset_t offset;
61 vm_size_t length;
62 vm_prot_t desired_access;
63
64
65 .fi
66 .ft P
67 .SH DESCRIPTION
68
69 .B memory_object_data_unlock
70 is a request that the memory manager permit at least
71 the desired access to the specified data cached by the kernel.
72 A call to
73 .B memory_object_lock_request
74 is expected in response.
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 length
98 The number of bytes of data, starting at
99 .B offset
100 , to which this
101 call refers. This will be an integral number of memory object pages.
102 .TP 15
103 .B
104 .B desired_access
105 A protection value describing the memory access modes which
106 must be permitted on the specified cached data. One or more of:
107 .B VM_PROT_READ, VM_PROT_WRITE
108 or
109 .B VM_PROT_EXECUTE
110 .
111
112 .SH DIAGNOSTICS
113 .TP 25
114 .B KERN_SUCCESS
115 Since this routine is called by the kernel, which does not
116 wait for a reply message, this value is ignored.
117
118 .SH SEE ALSO
119 .B memory_object_lock_request,memory_object_lock_completed
120
Cache object: e7c8a26fd14681ddbb7842ff029ae038
|