[*] Updated/added FutexBarrier comments and updated AuThreadings README
This commit is contained in:
parent
e4fa5d549e
commit
30b0fce882
@ -4,11 +4,20 @@
|
||||
# Features
|
||||
* Thread synchronization primitives: condition ex, condition mutex, condition variable, critical section, event, mutex, rwlock, semaphore, and spinlock
|
||||
* All primitives include a trylock and a nanosecond-resolution timed lock methods
|
||||
* SleepNs function supporting higher resolution sleep available than in most APIs (^1)
|
||||
* Enchanced Win32 support with increased yield resolution and optimization around internal XP, internal Win8, and UWP APIs
|
||||
* All lock-like primitives can be used with a AuFlexibleConditionVariable (noting AuConditionVariable binds to a single AuCondMutex)
|
||||
* WakeOnAddress support on every operating system regardless of kernel support
|
||||
* WakeOnAddress with various wake operations (eNotEqual, eEqual, eLessThanCompare, eGreaterThanCompare, eLessThanOrEqualsCompare, eGreaterThanOrEqualsCompare) of any size under 32 bytes
|
||||
* Reference futex primitives: AuInitOnce, AuInitOnceSmall, AuFutexBarrier, AuFutexCond, AuFutexMutex, AuFutexSemaphore, FutexWaitable\*NoVTbl\*\*Movable\*Smallest (AuFutexMutexSmallest)
|
||||
* No primitive will ever waste time syscalling or otherwise waking if not required
|
||||
* Single core (thread check), Intel SMT (rdtsc), AARCH64 (rdtsc emu via CNTVCT_EL0), Intel Alderlake (umonitor/tpause), and AMD 2016+ (monitorx) optimized/aware spinning optimizations with in-process and CPU heuristics
|
||||
* ...known good performance and low kernel stated CPU usage% on Windows 7, Windows 11, and Linux spanning a diverse range of processors.
|
||||
* Timeline semaphores / completion barriers are supported via AuFutexSemaphore::LockUntilAtleastAbsNS/AcquireUntilAtleastAbsNS
|
||||
* RWLock supports read-to-write upgrades when the decision to esclate is made based upon a shared resource, plus CheckSelfThreadIsWriter check
|
||||
* RWLocks are read criticial section based and all writer threads are allowed to enter read critical sections. In addition, AuRWRenterableLock allows for write reentrancy.
|
||||
* Enchanced Win32 support with increased yield resolution and optimization around internal XP, internal Win8, and UWP APIs
|
||||
* SleepNs function supporting higher resolution sleep available than in most APIs (^1)
|
||||
* Thread Object per native OS thread
|
||||
* Thread spawning with TLS handles and shutdown routines dispatched under pseudo fibers
|
||||
* Thread spawning with TLS handles and shutdown routines ~~dispatched under pseudo fibers. TODO: reimpl thread 'features' and NT-like APCs ~~
|
||||
* Update thread affinity, throttle, name, and related attributes
|
||||
* Lock Util: AU_LOCK_GUARD(pointer/reference/shared ptr)
|
||||
* Lock Util: AU_TRY_LOCK_GUARD[...](pointer/reference/shared ptr)
|
||||
|
@ -21,12 +21,18 @@ namespace Aurora::Threading::Waitables
|
||||
|
||||
AU_NO_COPY_NO_MOVE(FutexBarrier);
|
||||
|
||||
/**
|
||||
* @brief alert: one thread ready or task complete, wait until the work group is ready
|
||||
*/
|
||||
inline bool Enter()
|
||||
{
|
||||
bool bTimeout {};
|
||||
return this->Park(bTimeout, true, 0);
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* @brief alert: one thread ready or task complete, wait until the work group is ready with an optional timeout
|
||||
*/
|
||||
inline AuPair<bool /* bSuccess */, bool /* bTimeOut */>
|
||||
EnterTimed(AuUInt64 uTimeoutAbsNS)
|
||||
{
|
||||
@ -35,6 +41,9 @@ namespace Aurora::Threading::Waitables
|
||||
return AuMakePair(bSuccess, bTimeout);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief alert: one thread ready or task complete, wait until the work group is ready with an optional timeout, call callOnce on a single thread
|
||||
*/
|
||||
inline AuPair<bool /* bSuccess */, bool /* bTimeOut */>
|
||||
EnterTimedEx(AuUInt64 uTimeoutAbsNS,
|
||||
AuVoidFunc callOnce)
|
||||
@ -47,16 +56,25 @@ namespace Aurora::Threading::Waitables
|
||||
return AuMakePair(bSuccess, bTimeout);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief alert: one thread ready or task complete
|
||||
*/
|
||||
inline bool TryEnter()
|
||||
{
|
||||
return this->TryEnterNoSpin();
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Has barrier met FutexBarrier(uExpectThreads) ?
|
||||
*/
|
||||
inline bool TryWait()
|
||||
{
|
||||
return this->TryChkNoSpin();
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Wait until the barrier has met FutexBarrier(uExpectThreads)
|
||||
*/
|
||||
inline bool Wait(AuUInt64 uTimeoutAbsNS = 0)
|
||||
{
|
||||
bool bTimeout {};
|
||||
|
Loading…
Reference in New Issue
Block a user