Changeset 15718 in vbox for trunk/include

Timestamp:

Dec 22, 2008 3:49:25 PM (16 years ago)

Author:

vboxsync

Message:

RTR0MemObjLockUser: Replaced the warnings with more useful information.

File:

• trunk/include/iprt/memobj.h (modified) (1 diff)

trunk/include/iprt/memobj.h

@@ -150 +150 @@
  * @param   R0Process       The process to lock pages in. NIL_R0PROCESS is an alias for the current one.
  *
- * @remark  RTR0MemGetAddressR3() and RTR0MemGetAddress() will return the rounded down address.
- * @remark  On Linux, this should never be used on heap memory, as pages locked down in this
- *          way will be missing from the child's virtual address space after a fork() call.  This
- *          is currently irreversible, and applies even if the fork takes place after the virtual
- *          memory has been unlocked again.
+ * @remarks RTR0MemGetAddressR3() and RTR0MemGetAddress() will return therounded
+ *          down address.
+ * @remarks Linux: This API requires that the memory begin locked is in a memory
+ *          mapping that is not required in any forked off child process. This
+ *          is not intented as permanent restriction, feel free to help out
+ *          lifting it.
  */
 RTR0DECL(int) RTR0MemObjLockUser(PRTR0MEMOBJ pMemObj, RTR3PTR R3Ptr, size_t cb, RTR0PROCESS R0Process);