0
|
1 |
// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
|
|
2 |
// All rights reserved.
|
|
3 |
// This component and the accompanying materials are made available
|
|
4 |
// under the terms of the License "Eclipse Public License v1.0"
|
|
5 |
// which accompanies this distribution, and is available
|
|
6 |
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
|
|
7 |
//
|
|
8 |
// Initial Contributors:
|
|
9 |
// Nokia Corporation - initial contribution.
|
|
10 |
//
|
|
11 |
// Contributors:
|
|
12 |
//
|
|
13 |
// Description:
|
|
14 |
// \e32\kernel\ssharedio.cpp
|
|
15 |
//
|
|
16 |
//
|
|
17 |
|
|
18 |
#include <kernel/kern_priv.h>
|
|
19 |
#include "execs.h"
|
|
20 |
|
|
21 |
const char* KSharedIoBufferFaultCategory="SharedIoBuffer";
|
|
22 |
#define __SIOB_ASSERT(aCond) \
|
|
23 |
__ASSERT_DEBUG( (aCond), ( \
|
|
24 |
Kern::Printf("Assertion '" #aCond "' failed;\nFile: '" \
|
|
25 |
__FILE__ "' Line: %d\n", __LINE__), \
|
|
26 |
Kern::Fault(KSharedIoBufferFaultCategory, 0)) )
|
|
27 |
|
|
28 |
/** Creates a shared IO buffer.
|
|
29 |
|
|
30 |
This function creates a shared IO buffer of a specified size and attributes.
|
|
31 |
This functions updates iAddress with the address of the buffer in the kernel's
|
|
32 |
address space and it can be used by the kernel even if the shared buffer is
|
|
33 |
unmapped.
|
|
34 |
|
|
35 |
@param aBuffer A pointer which will be set to the address of the created buffer
|
|
36 |
or NULL if the method fails.
|
|
37 |
@param aSize Size of the buffer to be created.
|
|
38 |
@param aAttribs A combination of TMappingAttributes specifying MMU attributes for
|
|
39 |
the buffer like cachability, bufferability
|
|
40 |
|
|
41 |
@return KErrNone, if successful;
|
|
42 |
KErrNoMemory, if there is not enough memory.
|
|
43 |
|
|
44 |
@pre Calling thread must be in a critical section.
|
|
45 |
@pre Interrupts must be enabled.
|
|
46 |
@pre Kernel must be unlocked.
|
|
47 |
@pre No fast mutex can be held.
|
|
48 |
@pre Call in a thread context.
|
|
49 |
|
|
50 |
@post Calling thread is in a critical section.
|
|
51 |
*/
|
|
52 |
EXPORT_C TInt DSharedIoBuffer::New(DSharedIoBuffer*& aBuffer, TUint32 aSize, TUint aAttribs)
|
|
53 |
{
|
|
54 |
CHECK_PRECONDITIONS(MASK_THREAD_CRITICAL,"DSharedIoBuffer::New(DSharedIoBuffer*& aBuffer, TUint32 aSize, TUint aAttribs)");
|
|
55 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::New %x",aSize));
|
|
56 |
aBuffer=new DSharedIoBuffer;
|
|
57 |
if(!aBuffer)
|
|
58 |
return KErrNoMemory;
|
|
59 |
TInt r=aBuffer->DoCreate(aSize,aAttribs);
|
|
60 |
if(r!=KErrNone)
|
|
61 |
{
|
|
62 |
delete aBuffer;
|
|
63 |
aBuffer=NULL;
|
|
64 |
}
|
|
65 |
return r;
|
|
66 |
}
|
|
67 |
|
|
68 |
|
|
69 |
#ifdef __EPOC32__
|
|
70 |
/** Creates a shared IO buffer.
|
|
71 |
|
|
72 |
This function creates a shared IO buffer of a specified size and attributes that
|
|
73 |
will map a specified physical address region, starting at aPhysAddr and of size aSize.
|
|
74 |
This functions updates iAddress with the linear address of the buffer in the kernel's
|
|
75 |
address space and it can be used by the kernel even if the shared buffer is
|
|
76 |
unmapped.
|
|
77 |
|
|
78 |
@param aBuffer A pointer which will be set to the address of the created buffer
|
|
79 |
or NULL if the method fails.
|
|
80 |
@param aPhysAddr Physical address that will be mapped by this buffer. It must be aligned
|
|
81 |
on page boundary.
|
|
82 |
@param aSize Size of the buffer to be created.
|
|
83 |
@param aAttribs A combination of TMappingAttributes specifying MMU attributes for
|
|
84 |
the buffer like cachability, bufferability
|
|
85 |
|
|
86 |
@return KErrNone, if successful;
|
|
87 |
KErrNoMemory, if there is not enough memory;
|
|
88 |
KErrArgument, if aPhysAddr is not page aligned.
|
|
89 |
|
|
90 |
@pre Calling thread must be in a critical section.
|
|
91 |
@pre Interrupts must be enabled.
|
|
92 |
@pre Kernel must be unlocked.
|
|
93 |
@pre No fast mutex can be held.
|
|
94 |
@pre Call in a thread context.
|
|
95 |
|
|
96 |
@post Calling thread is in a critical section.
|
|
97 |
*/
|
|
98 |
EXPORT_C TInt DSharedIoBuffer::New(DSharedIoBuffer*& aBuffer, TPhysAddr aPhysAddr, TUint32 aSize, TUint aAttribs)
|
|
99 |
{
|
|
100 |
CHECK_PRECONDITIONS(MASK_THREAD_CRITICAL,"DSharedIoBuffer::New(DSharedIoBuffer*& aBuffer, TPhysAddr aPhysAddr, TUint32 aSize, TUint aAttribs)");
|
|
101 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::New %x+%x",aPhysAddr,aSize));
|
|
102 |
aBuffer=new DSharedIoBuffer;
|
|
103 |
if(!aBuffer)
|
|
104 |
return KErrNoMemory;
|
|
105 |
TInt r=aBuffer->DoCreate(aPhysAddr,aSize,aAttribs);
|
|
106 |
if(r!=KErrNone)
|
|
107 |
{
|
|
108 |
delete aBuffer;
|
|
109 |
aBuffer=NULL;
|
|
110 |
}
|
|
111 |
return r;
|
|
112 |
}
|
|
113 |
|
|
114 |
#endif // __EPOC32__
|
|
115 |
|
|
116 |
|
|
117 |
DSharedIoBuffer::DSharedIoBuffer()
|
|
118 |
{
|
|
119 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::DSharedIoBuffer %x",this));
|
|
120 |
}
|
|
121 |
|
|
122 |
|
|
123 |
/**
|
|
124 |
Destructor.
|
|
125 |
|
|
126 |
@pre Calling thread must be in a critical section.
|
|
127 |
@pre Interrupts must be enabled.
|
|
128 |
@pre Kernel must be unlocked.
|
|
129 |
@pre No fast mutex can be held.
|
|
130 |
@pre Call in a thread context.
|
|
131 |
*/
|
|
132 |
EXPORT_C DSharedIoBuffer::~DSharedIoBuffer()
|
|
133 |
{
|
|
134 |
CHECK_PRECONDITIONS(MASK_THREAD_CRITICAL,"DSharedIoBuffer::~DSharedIoBuffer");
|
|
135 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::~DSharedIoBuffer %x",this));
|
|
136 |
if(iChunk)
|
|
137 |
iChunk->Close(iUserProcess);
|
|
138 |
if(iUserProcess)
|
|
139 |
iUserProcess->Close(0);
|
|
140 |
}
|
|
141 |
|
|
142 |
|
|
143 |
TInt DSharedIoBuffer::DoCreate(TUint32 aSize, TUint aAttribs)
|
|
144 |
{
|
|
145 |
SChunkCreateInfo c;
|
|
146 |
c.iType = ESharedIo;
|
|
147 |
c.iAtt = TChunkCreate::EDisconnected;
|
|
148 |
c.iGlobal = ETrue;
|
|
149 |
c.iForceFixed = ETrue;
|
|
150 |
c.iMaxSize = aSize;
|
|
151 |
c.iMapAttr = aAttribs;
|
|
152 |
c.iOperations = SChunkCreateInfo::EAdjust;
|
|
153 |
TInt r=K::TheKernelProcess->NewChunk(iChunk, c, iAddress);
|
|
154 |
if(r==KErrNone)
|
|
155 |
r = iChunk->Commit(0, aSize);
|
|
156 |
iSize = aSize;
|
|
157 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::DoCreate returns %d iAddress=%x",r,iAddress));
|
|
158 |
return r;
|
|
159 |
}
|
|
160 |
|
|
161 |
|
|
162 |
TInt DSharedIoBuffer::DoCreate(TUint32 aPhysAddr, TUint32 aSize, TUint aAttribs)
|
|
163 |
{
|
|
164 |
SChunkCreateInfo c;
|
|
165 |
c.iType = ESharedIo;
|
|
166 |
c.iAtt = TChunkCreate::EDisconnected | TChunkCreate::EMemoryNotOwned;
|
|
167 |
c.iGlobal = ETrue;
|
|
168 |
c.iForceFixed = ETrue;
|
|
169 |
c.iMaxSize = aSize;
|
|
170 |
c.iMapAttr = aAttribs;
|
|
171 |
c.iOperations = SChunkCreateInfo::EAdjust;
|
|
172 |
TInt r = K::TheKernelProcess->NewChunk(iChunk, c, iAddress);
|
|
173 |
if(r==KErrNone)
|
|
174 |
r = iChunk->Commit(0, aSize, DChunk::ECommitContiguousPhysical, (TUint32*)aPhysAddr);
|
|
175 |
iSize = aSize;
|
|
176 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::DoCreate returns %d iAddress=%x",r,iAddress));
|
|
177 |
return r;
|
|
178 |
}
|
|
179 |
|
|
180 |
|
|
181 |
/** Translates a user address to a kernel address.
|
|
182 |
|
|
183 |
This functions checks if the interval [aUserAddress,aUserAddress+aSize) lies
|
|
184 |
entirely in the shared buffer. If that's the case, the function returns the
|
|
185 |
kernel linear address corresponding to aUserAddress within the shared buffer.
|
|
186 |
Otherwise it returns NULL.
|
|
187 |
It also returns NULL if the shared IO buffer is not mapped in a process.
|
|
188 |
|
|
189 |
@param aUserAddress User address to be translated.
|
|
190 |
@param aSize Size in bytes after the user address to be checked if in buffer.
|
|
191 |
|
|
192 |
@return Linear kernel address corresponding to the user address if the interval
|
|
193 |
[aUserAddress,aUserAddress+aSize) lies within the buffer or NULL
|
|
194 |
otherwise.
|
|
195 |
*/
|
|
196 |
EXPORT_C TLinAddr DSharedIoBuffer::UserToKernel(TLinAddr aUserAddress, TUint32 aSize)
|
|
197 |
{
|
|
198 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::UserToKernel %x+%x",aUserAddress,aSize));
|
|
199 |
if(aUserAddress<iUserAddress || iUserProcess==NULL ||
|
|
200 |
aUserAddress+aSize>iUserAddress+iSize || aSize>iSize)
|
|
201 |
return NULL;
|
|
202 |
return (TLinAddr)(aUserAddress-iUserAddress+iAddress);
|
|
203 |
}
|
|
204 |
|
|
205 |
|
|
206 |
/** Translates a kernel address into a user address.
|
|
207 |
|
|
208 |
The shared IO buffer must be mapped into a process in order for this
|
|
209 |
function to work. No error checking is performed.
|
|
210 |
|
|
211 |
@param aKernelAddress Kernel linear address to be translated.
|
|
212 |
|
|
213 |
@return The translated linear user address.
|
|
214 |
*/
|
|
215 |
EXPORT_C TLinAddr DSharedIoBuffer::KernelToUser(TLinAddr aKernelAddress)
|
|
216 |
{
|
|
217 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::KernelToUser %x",aKernelAddress));
|
|
218 |
__SIOB_ASSERT(TUint(aKernelAddress-iAddress)<TUint(iSize) && iUserProcess);
|
|
219 |
return (TLinAddr)(aKernelAddress-iAddress+iUserAddress);
|
|
220 |
}
|
|
221 |
|
|
222 |
|
|
223 |
/** Maps the shared IO buffer into a user process.
|
|
224 |
|
|
225 |
The function makes the buffer available for reading and writing to the user
|
|
226 |
process. The iUserAddress will be set with the address of the buffer into
|
|
227 |
the process' address space.
|
|
228 |
It faults the kernel if the shared IO buffer is already mapped into a
|
|
229 |
user process.
|
|
230 |
|
|
231 |
Note that this function is not multithread safe.
|
|
232 |
|
|
233 |
@param aUserProcess The user process where the shared IO buffer will be mapped into.
|
|
234 |
|
|
235 |
@return KErrNone on success.
|
|
236 |
|
|
237 |
@pre Interrupts must be enabled.
|
|
238 |
@pre Kernel must be unlocked.
|
|
239 |
@pre No fast mutex can be held.
|
|
240 |
@pre Call in a thread context.
|
|
241 |
*/
|
|
242 |
EXPORT_C TInt DSharedIoBuffer::UserMap(DProcess* aUserProcess)
|
|
243 |
{
|
|
244 |
CHECK_PRECONDITIONS(MASK_THREAD_STANDARD,"DSharedIoBuffer::UserMap");
|
|
245 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::UserMap %x", aUserProcess));
|
|
246 |
if(iUserProcess)
|
|
247 |
{
|
|
248 |
__KTRACE_OPT(KMMU,Kern::Printf("Already mapped into %x !", iUserProcess));
|
|
249 |
Kern::Fault(KSharedIoBufferFaultCategory,EAlreadyMapped);
|
|
250 |
}
|
|
251 |
NKern::ThreadEnterCS();
|
|
252 |
aUserProcess->Open();
|
|
253 |
TInt r = aUserProcess->WaitProcessLock();
|
|
254 |
if(r==KErrNone)
|
|
255 |
{
|
|
256 |
r=aUserProcess->AddChunk(iChunk,EFalse);
|
|
257 |
if(r==KErrNone)
|
|
258 |
{
|
|
259 |
iUserAddress = (TUint)iChunk->Base(aUserProcess);
|
|
260 |
aUserProcess->Open();
|
|
261 |
iUserProcess = aUserProcess;
|
|
262 |
}
|
|
263 |
aUserProcess->SignalProcessLock();
|
|
264 |
}
|
|
265 |
aUserProcess->Close(0);
|
|
266 |
NKern::ThreadLeaveCS();
|
|
267 |
return r;
|
|
268 |
}
|
|
269 |
|
|
270 |
|
|
271 |
/** Unmaps the shared IO buffer out of a user process.
|
|
272 |
|
|
273 |
This function removes the shared IO buffer from the process' address space.
|
|
274 |
Any further attempts to read or write the buffer by any thread in the user
|
|
275 |
process panics that thread.
|
|
276 |
|
|
277 |
Note that this function is not multithread safe.
|
|
278 |
|
|
279 |
@return KErrNone on success.
|
|
280 |
|
|
281 |
@pre No fast mutex can be held.
|
|
282 |
@pre Call in a thread context.
|
|
283 |
@pre Kernel must be unlocked
|
|
284 |
@pre interrupts enabled
|
|
285 |
*/
|
|
286 |
EXPORT_C TInt DSharedIoBuffer::UserUnmap()
|
|
287 |
{
|
|
288 |
CHECK_PRECONDITIONS(MASK_THREAD_STANDARD,"DSharedIoBuffer::UserUnmap");
|
|
289 |
__KTRACE_OPT(KMMU,Kern::Printf("DSharedIoBuffer::UserUnmap"));
|
|
290 |
DProcess* process = iUserProcess;
|
|
291 |
if(!process)
|
|
292 |
return KErrNone;
|
|
293 |
|
|
294 |
NKern::ThreadEnterCS();
|
|
295 |
|
|
296 |
TInt r = process->WaitProcessLock();
|
|
297 |
if(r==KErrNone)
|
|
298 |
{
|
|
299 |
// Remove from process by open then close
|
|
300 |
iChunk->Open();
|
|
301 |
iChunk->Close(process);
|
|
302 |
process->SignalProcessLock();
|
|
303 |
}
|
|
304 |
|
|
305 |
iUserProcess = NULL;
|
|
306 |
process->Close(0);
|
|
307 |
|
|
308 |
NKern::ThreadLeaveCS();
|
|
309 |
return KErrNone;
|
|
310 |
}
|
|
311 |
|
|
312 |
|