[reactos.git] / reactos / media / doc / locks.txt
1 Next-Gen (NT 5.2) Executive Locks in NTOSKRNL.
2 ------------------------------
3 1a. Rundown Protection
4 USED IN: Thread/Process Ps* Code.
5 EXAMPLES: NtSetInformationProcess/Thread, PspCreateThread/Process, PspSuspend/ResumeThread...
6 REPLACES: Unlocked access and/or PsLock/UnlockProcess.
7 ROS STATUS: Implemented. Code needs cleanup. Not yet tested. Not yet used.
9 1b. Cache-Aware Rundown Protection
10 USED IN: Unknown. Functions exported for drivers.
11 EXAMPLES: None.
12 REPLACES: Nothing.
13 ROS STATUS: Unimplemented.
15 2. Guarded Mutex
16 USED IN: Configuration Manager, MCB Functions (FsRtl), Binary Hive Module (Hv), PnP (Notifications), LPC, Jobs (Ps), Device Map (Ob), and Memory Management (Address Space/Virtual Memory).
17 EXAMPLES: Too many.
18 REPLACES: Anything that used FAST_MUTEX.
19 ROS STATUS: Implemented, slightly tested; appears to still contain a bug.
21 3. Fast Referencing
22 USED IN: Tokens.
23 EXAMPLES: R: PsReferencePrimary/EffectiveToken. D: Failure code of anything that calls those two functions.
24 REPLACES: Normal referencing.
25 ROS STATUS: Hackplemented stubs.
27 4a. Pushlocks
28 USED IN: Configuration Manager (Cm), Handle Table (Ex), Binary Hive Module (Hv), Memory Management (Address Space/Virtual Memory), Object Namespace (Directories/Names) (Ob), Impersonation (Ps).
29 EXAMPLES: Too many.
30 REPLACES: Anything that used ERESOURCE.
31 ROS STATUS: Implemented (missing Block/([Timed]Wait)Unblock) and slightly tested.
33 4b. Cache-Aware Pushlocks
34 USED IN: AWE (Mm).
35 EXAMPLES: None.
36 REPLACES: Executive Resources.
37 ROS STATUS: Unimplemented.
39 TODO: Kernel Locks (Queued and In-Stack Spinlocks)