xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList > 模板类 参考

部分中断尝试上锁模式下的自旋锁RAII机制守卫 更多...

#include <Spinlock.hxx>

类 xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList > 继承关系图:

xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList > 的协作图:

Public 成员函数
	TryLkIrqsGrd (Spinlock *spinlock)
	构造自旋锁的RAII机制守卫
	TryLkIrqsGrd (Spinlock &spinlock)
	构造自旋锁的RAII机制守卫
	~TryLkIrqsGrd ()
	析构自旋锁的RAII机制守卫
xwer_t	getRc ()
	获取上锁结果错误码
Public 成员函数 继承自 xwos::lock::Spinlock::LkIrqsGrd< TIrqList... >
	LkIrqsGrd (Spinlock *spinlock)
	构造自旋锁的RAII机制守卫
	LkIrqsGrd (Spinlock &spinlock)
	构造自旋锁的RAII机制守卫
	~LkIrqsGrd ()
	析构自旋锁的RAII机制守卫
void	unlock ()
	解锁自旋锁
enum LockStatus	getStatus ()
	获取锁状态
xwer_t	wait (sync::Cond *cond)
	等待条件量
xwer_t	wait (sync::Cond &cond)
	等待条件量
xwer_t	wait (sync::Cond *cond, xwtm_t to)
	限时等待条件量
xwer_t	wait (sync::Cond &cond, xwtm_t to)
	限时等待条件量

Private 属性
xwer_t	mRc

额外继承的成员函数
Protected 成员函数 继承自 xwos::lock::Spinlock::LkIrqsGrd< TIrqList... >
	LkIrqsGrd ()
Protected 属性 继承自 xwos::lock::Spinlock::LkIrqsGrd< TIrqList... >
Spinlock *	mSpinlock
enum LockStatus	mStatus
xwirq_t	mIrqs [sizeof...(TIrqList)]
xwreg_t	mIrqFlags [sizeof...(TIrqList)]

详细描述

template<xwirq_t... TIrqList>
class xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList >

部分中断尝试上锁模式下的自旋锁RAII机制守卫

• 构造函数关闭并保存 TIrqList 列表内的中断，关闭当前CPU调度器的抢占， 上锁自旋锁。
• 上锁失败不会自旋等待，会开启当前CPU调度器的抢占， 用保存的中断标志恢复 TIrqList 列表内的中断， 并在 mRc 中返回 -EAGAIN 。
• 析构函数解锁自旋锁，开启当前CPU调度器的抢占， 用保存的中断标志恢复 TIrqList 列表内的中断。

  注解

• 上下文：线程、TIrqList 列表中的中断

在文件 Spinlock.hxx 第 998 行定义.

构造及析构函数说明

TryLkIrqsGrd() [1/2]

template<xwirq_t... TIrqList>

xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList >::TryLkIrqsGrd ( Spinlock *  spinlock )

inline

构造自旋锁的RAII机制守卫

参数

[in]

spinlock

自旋锁对象指针

<No error

在文件 Spinlock.hxx 第 1008 行定义.

            : LkIrqsGrd<TIrqList...>()
        {
            LkIrqsGrd<TIrqList...>::mSpinlock = spinlock;
            if (nullptr != LkIrqsGrd<TIrqList...>::mSpinlock) {
                mRc = xwos_splk_trylock_irqssv(
                    &LkIrqsGrd<TIrqList...>::mSpinlock->mLock,
                    LkIrqsGrd<TIrqList...>::mIrqs, LkIrqsGrd<TIrqList...>::mIrqFlags,
                    sizeof...(TIrqList));
                if (XWOK != mRc) {
                    LkIrqsGrd<TIrqList...>::mSpinlock = nullptr;
                } else {
                    LkIrqsGrd<TIrqList...>::mStatus =
                        Spinlock::LockStatus::SpinlockLocked;
                }
            }
        }

函数调用图:

TryLkIrqsGrd() [2/2]

template<xwirq_t... TIrqList>

xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList >::TryLkIrqsGrd ( Spinlock &  spinlock )

inline

构造自旋锁的RAII机制守卫

参数

[in]

spinlock

自旋锁对象引用

<No error

在文件 Spinlock.hxx 第 1030 行定义.

            : LkIrqsGrd<TIrqList...>()
        {
            LkIrqsGrd<TIrqList...>::mSpinlock = spinlock;
            if (nullptr != LkIrqsGrd<TIrqList...>::mSpinlock) {
                mRc = xwos_splk_trylock_irqssv(
                    &LkIrqsGrd<TIrqList...>::mSpinlock->mLock,
                    LkIrqsGrd<TIrqList...>::mIrqs, LkIrqsGrd<TIrqList...>::mIrqFlags,
                    sizeof...(TIrqList));
                if (XWOK != mRc) {
                    LkIrqsGrd<TIrqList...>::mSpinlock = nullptr;
                } else {
                    LkIrqsGrd<TIrqList...>::mStatus =
                        Spinlock::LockStatus::SpinlockLocked;
                }
            }
        }

函数调用图:

~TryLkIrqsGrd()

template<xwirq_t... TIrqList>

xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList >::~TryLkIrqsGrd ( )

inline

析构自旋锁的RAII机制守卫

在文件 Spinlock.hxx 第 1051 行定义.

{}

成员函数说明

getRc()

template<xwirq_t... TIrqList>

xwer_t xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList >::getRc ( )

inline

获取上锁结果错误码

返回

错误码

返回值

XWOK	没有错误
-EAGAIN	获得自旋锁失败

在文件 Spinlock.hxx 第 1059 行定义.

{ return mRc; }

结构体成员变量说明

mRc

template<xwirq_t... TIrqList>

xwer_t xwos::lock::Spinlock::TryLkIrqsGrd< TIrqList >::mRc

private

尝试上锁的结果

在文件 Spinlock.hxx 第 1001 行定义.

---

该类的文档由以下文件生成:

• xwos/cxx/lock/Spinlock.hxx