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机制守卫
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 第 863 行定义.

构造及析构函数说明

TryLkIrqsGrd() [1/2]

template<xwirq_t ... TIrqList>

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

(

Spinlock *

spinlock

)

构造自旋锁的RAII机制守卫

参数

[in]

spinlock

自旋锁对象指针

在文件 Spinlock.cxx 第 427 行定义.

    : 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

)

构造自旋锁的RAII机制守卫

参数

[in]

spinlock

自旋锁对象引用

在文件 Spinlock.cxx 第 445 行定义.

    : 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 第 885 行定义.

{}

成员函数说明

getRc()

template<xwirq_t ... TIrqList>

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

inline

获取上锁结果错误码

返回

错误码

返回值

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

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

{ return mRc; }

结构体成员变量说明

mRc

template<xwirq_t ... TIrqList>

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

private

尝试上锁的结果

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

---

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

• xwos/cxx/lock/Spinlock.hxx
• xwos/cxx/lock/Spinlock.cxx