顺序锁的协作图:

结构体
struct	xwos_sqlk
	XWOS API：顺序锁更多...

宏定义
#define	XWOS_SQLK_INITIALIZER { .ossql = XWOSDL_SQLK_INITIALIZER, }
	XWOS API：顺序锁的初始值

#define	XWOS_SQLK_GRANULARITY XWOSDL_SQLK_GRANULARITY
	操作系统抽象层：顺序锁顺序值的粒度

函数
static void	xwos_sqlk_init (struct xwos_sqlk *sql)
	XWOS API：初始化顺序锁

static xwsq_t	xwos_sqlk_rd_begin (struct xwos_sqlk *sql)
	XWOS API：开启共享读临界区

static bool	xwos_sqlk_rd_retry (struct xwos_sqlk *sql, xwsq_t start)
	XWOS API：关闭共享读临界区，并检查是否需要重试

static xwsq_t	xwos_sqlk_get_seq (struct xwos_sqlk *sql)
	XWOS API：获取顺序锁的顺序值

static void	xwos_sqlk_rdex_lock (struct xwos_sqlk *sql)
	XWOS API：开启独占读临界区

static xwer_t	xwos_sqlk_rdex_trylock (struct xwos_sqlk *sql)
	XWOS API：尝试开启独占读临界区

static void	xwos_sqlk_rdex_unlock (struct xwos_sqlk *sql)
	XWOS API：关闭独占读临界区

static void	xwos_sqlk_rdex_lock_cpuirq (struct xwos_sqlk *sql)
	XWOS API：开启独占读临界区，并关闭本地CPU的中断

static xwer_t	xwos_sqlk_rdex_trylock_cpuirq (struct xwos_sqlk *sql)
	XWOS API：尝试开启独占读临界区，并关闭本地CPU的中断

static void	xwos_sqlk_rdex_unlock_cpuirq (struct xwos_sqlk *sql)
	XWOS API：关闭独占读临界区，并开启本地CPU的中断

static void	xwos_sqlk_rdex_lock_cpuirqsv (struct xwos_sqlk sql, xwreg_t cpuirq)
	XWOS API：开启独占读临界区，保存本地CPU的中断标志并关闭

static xwer_t	xwos_sqlk_rdex_trylock_cpuirqsv (struct xwos_sqlk sql, xwreg_t cpuirq)
	XWOS API：尝试开启独占读临界区，保存本地CPU的中断标志并关闭

static void	xwos_sqlk_rdex_unlock_cpuirqrs (struct xwos_sqlk *sql, xwreg_t cpuirq)
	XWOS API：关闭独占读临界区，恢复本地CPU的中断标志

static void	xwos_sqlk_rdex_lock_irqs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwsz_t num)
	XWOS API：开启独占读临界区，并关闭部分中断

static xwer_t	xwos_sqlk_rdex_trylock_irqs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwsz_t num)
	XWOS API：尝试开启独占读临界区，并关闭部分中断

static void	xwos_sqlk_rdex_unlock_irqs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwsz_t num)
	XWOS API：关闭独占读临界区，并开启部分中断

static void	xwos_sqlk_rdex_lock_irqssv (struct xwos_sqlk *sql, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：开启独占读临界区，保存部分中断的中断标志并关闭

static xwer_t	xwos_sqlk_rdex_trylock_irqssv (struct xwos_sqlk *sql, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：尝试开启独占读临界区，保存部分中断的中断标志并关闭

static void	xwos_sqlk_rdex_unlock_irqsrs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：关闭独占读临界区，恢复部分中断的中断标志

static void	xwos_sqlk_rdex_lock_bh (struct xwos_sqlk *sql)
	XWOS API：开启独占读临界区，关闭本地CPU的中断底半部

static xwer_t	xwos_sqlk_rdex_trylock_bh (struct xwos_sqlk *sql)
	XWOS API：尝试开启独占读临界区，关闭本地CPU的中断底半部

static void	xwos_sqlk_rdex_unlock_bh (struct xwos_sqlk *sql)
	XWOS API：关闭独占读临界区，开启本地CPU的中断底半部

static void	xwos_sqlk_wr_lock (struct xwos_sqlk *sql)
	XWOS API：开启写临界区

static xwer_t	xwos_sqlk_wr_trylock (struct xwos_sqlk *sql)
	XWOS API：尝试开启写临界区

static void	xwos_sqlk_wr_unlock (struct xwos_sqlk *sql)
	XWOS API：关闭写临界区

static void	xwos_sqlk_wr_lock_cpuirq (struct xwos_sqlk *sql)
	XWOS API：开启写临界区，并关闭本地CPU的中断

static xwer_t	xwos_sqlk_wr_trylock_cpuirq (struct xwos_sqlk *sql)
	XWOS API：尝试开启写临界区，并关闭本地CPU的中断

static void	xwos_sqlk_wr_unlock_cpuirq (struct xwos_sqlk *sql)
	XWOS API：关闭写临界区，并开启本地CPU的中断

static void	xwos_sqlk_wr_lock_cpuirqsv (struct xwos_sqlk sql, xwreg_t cpuirq)
	XWOS API：开启写临界区，保存本地CPU的中断标志并关闭

static xwer_t	xwos_sqlk_wr_trylock_cpuirqsv (struct xwos_sqlk sql, xwreg_t cpuirq)
	XWOS API：尝试开启写临界区，保存本地CPU的中断标志并关闭

static void	xwos_sqlk_wr_unlock_cpuirqrs (struct xwos_sqlk *sql, xwreg_t cpuirq)
	XWOS API：关闭写临界区，恢复本地CPU的中断标志

static void	xwos_sqlk_wr_lock_irqs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwsz_t num)
	XWOS API：开启写临界区，并关闭部分中断

static xwer_t	xwos_sqlk_wr_trylock_irqs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwsz_t num)
	XWOS API：尝试开启写临界区，并关闭部分中断

static void	xwos_sqlk_wr_unlock_irqs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwsz_t num)
	XWOS API：关闭写临界区，并开启部分中断

static void	xwos_sqlk_wr_lock_irqssv (struct xwos_sqlk *sql, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：开启写临界区，保存部分中断的中断标志并关闭

static xwer_t	xwos_sqlk_wr_trylock_irqssv (struct xwos_sqlk *sql, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：尝试开启写临界区，保存部分中断的中断标志并关闭

static void	xwos_sqlk_wr_unlock_irqsrs (struct xwos_sqlk *sql, const xwirq_t irqs[], xwreg_t flags[], xwsz_t num)
	XWOS API：关闭写临界区，恢复部分中断的中断标志

static void	xwos_sqlk_wr_lock_bh (struct xwos_sqlk *sql)
	XWOS API：开启写临界区，关闭本地CPU的中断底半部

static xwer_t	xwos_sqlk_wr_trylock_bh (struct xwos_sqlk *sql)
	XWOS API：尝试开启写临界区，关闭本地CPU的中断底半部

static void	xwos_sqlk_wr_unlock_bh (struct xwos_sqlk *sql)
	XWOS API：关闭写临界区，开启本地CPU的中断底半部

详细描述

技术参考手册：顺序锁

顺序锁的初始化

xwos_sqlk_init() ：静态初始化

非独占读

xwos_sqlk_rd_begin() ：开启共享读临界区
xwos_sqlk_rd_retry() ：关闭共享读临界区，并检查是否需要重试
xwos_sqlk_get_seq() ：获取顺序锁的顺序值

独占读

保护线程上下文之间的独占读临界区
- xwos_sqlk_rdex_lock() ：上锁，关闭抢占
- xwos_sqlk_rdex_trylock() ：尝试上锁，关闭抢占
- xwos_sqlk_rdex_unlock() ：解锁，开启抢占
保护任意上下文之间的独占读临界区
- xwos_sqlk_rdex_lock_cpuirq() ：上锁，关闭抢占、CPU中断
- xwos_sqlk_rdex_trylock_cpuirq() ：尝试上锁，关闭抢占、CPU中断
- xwos_sqlk_rdex_unlock_cpuirq() ：解锁，开启抢占、CPU中断
保护任意上下文之间的嵌套独占读临界区
- xwos_sqlk_rdex_lock_cpuirqsv() ：上锁，关闭抢占，保存CPU中断标志并关闭
- xwos_sqlk_rdex_trylock_cpuirqsv() ：尝试上锁，关闭抢占，保存CPU中断标志并关闭
- xwos_sqlk_rdex_unlock_cpuirqrs() ：解锁，开启抢占，恢复CPU中断
保护线程和 指定中断 上下文之间的独占读临界区
- xwos_sqlk_rdex_lock_irqs() ：上锁，关闭抢占，关闭部分中断
- xwos_sqlk_rdex_trylock_irqs() ：尝试上锁，关闭抢占，关闭部分中断
- xwos_sqlk_rdex_unlock_irqs() ：解锁，开启抢占、开启部分中断
保护线程和 指定中断 上下文之间的嵌套独占读临界区
- xwos_sqlk_rdex_lock_irqssv() ：上锁，关闭抢占，保存部分中断标志并关闭
- xwos_sqlk_rdex_trylock_irqssv() ：尝试上锁，关闭抢占，保存部分中断标志并关闭
- xwos_sqlk_rdex_unlock_irqsrs() ：解锁，开启抢占、恢复部分中断
保护线程和 中断底半部 上下文之间的独占读临界区
- xwos_sqlk_rdex_lock_bh() ：上锁，关闭抢占、中断底半部
- xwos_sqlk_rdex_trylock_bh() ：尝试上锁，关闭抢占、中断底半部
- xwos_sqlk_rdex_unlock_bh() ：解锁，开启抢占、中断底半部

写

保护线程上下文之间的读写临界区
- xwos_sqlk_wr_lock() ：上锁，关闭抢占
- xwos_sqlk_wr_trylock() ：尝试上锁，关闭抢占
- xwos_sqlk_wr_unlock() ：解锁，开启抢占
保护任意上下文之间的读写临界区
- xwos_sqlk_wr_lock_cpuirq() ：上锁，关闭抢占、CPU中断
- xwos_sqlk_wr_trylock_cpuirq() ：尝试上锁，关闭抢占、CPU中断
- xwos_sqlk_wr_unlock_cpuirq() ：解锁，开启抢占、CPU中断
保护任意上下文之间的嵌套读写临界区
- xwos_sqlk_wr_lock_cpuirqsv() ：上锁，关闭抢占，保存CPU中断标志并关闭
- xwos_sqlk_wr_trylock_cpuirqsv() ：尝试上锁，关闭抢占，保存CPU中断标志并关闭
- xwos_sqlk_wr_unlock_cpuirqrs() ：解锁，开启抢占，恢复CPU中断
保护线程和 指定中断 上下文之间的读写临界区
- xwos_sqlk_wr_lock_irqs() ：上锁，关闭抢占，关闭部分中断
- xwos_sqlk_wr_trylock_irqs() ：尝试上锁，关闭抢占，关闭部分中断
- xwos_sqlk_wr_unlock_irqs() ：解锁，开启抢占、开启部分中断
保护线程和 指定中断 上下文之间的嵌套读写临界区
- xwos_sqlk_wr_lock_irqssv() ：上锁，关闭抢占，保存部分中断标志并关闭
- xwos_sqlk_wr_trylock_irqssv() ：尝试上锁，关闭抢占，保存部分中断标志并关闭
- xwos_sqlk_wr_unlock_irqsrs() ：解锁，开启抢占、恢复部分中断
保护线程和 中断底半部 上下文之间的读写临界区
- xwos_sqlk_wr_lock_bh() ：上锁，关闭抢占、中断底半部
- xwos_sqlk_wr_trylock_bh() ：尝试上锁，关闭抢占、中断底半部
- xwos_sqlk_wr_unlock_bh() ：解锁，开启抢占、中断底半部

C++

C++头文件： xwos/osal/lock/seqlock.hxx

宏定义说明

◆ XWOS_SQLK_GRANULARITY

#define XWOS_SQLK_GRANULARITY XWOSDL_SQLK_GRANULARITY

操作系统抽象层：顺序锁顺序值的粒度

在文件 seqlock.h 第 124 行定义.

◆ XWOS_SQLK_INITIALIZER

#define XWOS_SQLK_INITIALIZER { .ossql = XWOSDL_SQLK_INITIALIZER, }

XWOS API：顺序锁的初始值

在文件 seqlock.h 第 119 行定义.

函数说明

◆ xwos_sqlk_get_seq()

static xwsq_t xwos_sqlk_get_seq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：获取顺序锁的顺序值

参数

[in] sql 顺序锁的指针

注解

上下文：任意

在文件 seqlock.h 第 175 行定义.

{
        return xwosdl_sqlk_get_seq(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_init()

static void xwos_sqlk_init ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：初始化顺序锁

参数

[in] sql 顺序锁的指针

注解

上下文：任意

在文件 seqlock.h 第 133 行定义.

{
        xwosdl_sqlk_init(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rd_begin()

static xwsq_t xwos_sqlk_rd_begin ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启共享读临界区

参数

[in] sql 顺序锁的指针

返回: 当前顺序值

注解

上下文：任意

若顺序锁已处于写临界区，调用的线程会自旋等待。

在文件 seqlock.h 第 148 行定义.

{
        return xwosdl_sqlk_rd_begin(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rd_retry()

static bool xwos_sqlk_rd_retry	(	struct xwos_sqlk *	sql,
		xwsq_t	start
	)

inlinestatic

XWOS API：关闭共享读临界区，并检查是否需要重试

参数

[in]	sql	顺序锁的指针
[in]	start	xwos_sqlk_rd_begin() 返回的顺序值，用于测试顺序值是否发生改变

返回值

true	顺序值发生了改变，需要重试
false	顺序值未发生改变

注解

上下文：任意

在文件 seqlock.h 第 163 行定义.

{
        return xwosdl_sqlk_rd_retry(&sql->ossql, start);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_lock()

static void xwos_sqlk_rdex_lock ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启独占读临界区

参数

[in] sql 顺序锁的指针

注解

上下文：线程

此函数只会关闭本地CPU的抢占，因此只能保证其临界区在线程中是安全的。

在文件 seqlock.h 第 189 行定义.

{
        xwosdl_sqlk_rdex_lock(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_lock_bh()

static void xwos_sqlk_rdex_lock_bh ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启独占读临界区，关闭本地CPU的中断底半部

参数

[in] sql 顺序锁的指针

注解

上下文：线程、中断底半部

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数只会关闭本地CPU的抢占和中断底半部，因此只能保证其临界区在线程与中断底半部中是安全的。

在文件 seqlock.h 第 447 行定义.

{
        xwosdl_sqlk_rdex_lock_bh(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_lock_cpuirq()

static void xwos_sqlk_rdex_lock_cpuirq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启独占读临界区，并关闭本地CPU的中断

参数

[in] sql 顺序锁的指针

注解

上下文：任意

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 233 行定义.

{
        xwosdl_sqlk_rdex_lock_cpuirq(&sql->ossql);
}

◆ xwos_sqlk_rdex_lock_cpuirqsv()

static void xwos_sqlk_rdex_lock_cpuirqsv	(	struct xwos_sqlk *	sql,
		xwreg_t *	cpuirq
	)

inlinestatic

XWOS API：开启独占读临界区，保存本地CPU的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[out]	cpuirq	缓冲区指针，用于返回本地CPU的中断标志

注解

上下文：任意

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 278 行定义.

{
        xwosdl_sqlk_rdex_lock_cpuirqsv(&sql->ossql, cpuirq);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_lock_irqs()

static void xwos_sqlk_rdex_lock_irqs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：开启独占读临界区，并关闭部分中断

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 330 行定义.

{
        xwosdl_sqlk_rdex_lock_irqs(&sql->ossql, irqs, num);
}

◆ xwos_sqlk_rdex_lock_irqssv()

static void xwos_sqlk_rdex_lock_irqssv	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：开启独占读临界区，保存部分中断的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[out]	flags	缓冲区指针，用于返回部分中断的中断标志
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 389 行定义.

{
        xwosdl_sqlk_rdex_lock_irqssv(&sql->ossql, irqs, flags, num);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_trylock()

static xwer_t xwos_sqlk_rdex_trylock ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：尝试开启独占读临界区

参数

[in] sql 顺序锁的指针

返回: 错误码

返回值

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

注解

上下文：线程

此函数只会关闭本地CPU的抢占，因此只能保证其临界区在线程中是安全的。

在文件 seqlock.h 第 206 行定义.

{
        return xwosdl_sqlk_rdex_trylock(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_trylock_bh()

static xwer_t xwos_sqlk_rdex_trylock_bh ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：尝试开启独占读临界区，关闭本地CPU的中断底半部

参数

[in] sql 顺序锁的指针

返回: 错误码

返回值

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

注解

上下文：线程、中断底半部

此函数只会关闭本地CPU的抢占和中断底半部，因此只能保证其临界区在线程与中断底半部中是安全的。

在文件 seqlock.h 第 465 行定义.

{
        return xwosdl_sqlk_rdex_trylock_bh(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_trylock_cpuirq()

static xwer_t xwos_sqlk_rdex_trylock_cpuirq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：尝试开启独占读临界区，并关闭本地CPU的中断

参数

[in] sql 顺序锁的指针

返回: 错误码

返回值

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

注解

上下文：任意

此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 250 行定义.

{
        return xwosdl_sqlk_rdex_trylock_cpuirq(&sql->ossql);
}

◆ xwos_sqlk_rdex_trylock_cpuirqsv()

static xwer_t xwos_sqlk_rdex_trylock_cpuirqsv	(	struct xwos_sqlk *	sql,
		xwreg_t *	cpuirq
	)

inlinestatic

XWOS API：尝试开启独占读临界区，保存本地CPU的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[out]	cpuirq	缓冲区指针，用于返回本地CPU的中断标志

返回: 错误码

返回值

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

注解

上下文：任意

此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 297 行定义.

{
        return xwosdl_sqlk_rdex_trylock_cpuirqsv(&sql->ossql, cpuirq);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_trylock_irqs()

static xwer_t xwos_sqlk_rdex_trylock_irqs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：尝试开启独占读临界区，并关闭部分中断

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

返回: 错误码

返回值

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

注解

上下文：线程、中断资源数组中描述的中断

此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 352 行定义.

{
        return xwosdl_sqlk_rdex_trylock_irqs(&sql->ossql, irqs, num);
}

◆ xwos_sqlk_rdex_trylock_irqssv()

static xwer_t xwos_sqlk_rdex_trylock_irqssv	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：尝试开启独占读临界区，保存部分中断的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[out]	flags	缓冲区指针，用于返回部分中断的中断标志
[in]	num	数组中元素数量

返回: 错误码

返回值

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

注解

上下文：线程、中断资源数组中描述的中断

此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 412 行定义.

{
        return xwosdl_sqlk_rdex_trylock_irqssv(&sql->ossql, irqs, flags, num);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_unlock()

static void xwos_sqlk_rdex_unlock ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：关闭独占读临界区

参数

[in] sql 顺序锁的指针

注解

上下文：线程

在文件 seqlock.h 第 218 行定义.

{
        xwosdl_sqlk_rdex_unlock(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_unlock_bh()

static void xwos_sqlk_rdex_unlock_bh ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：关闭独占读临界区，开启本地CPU的中断底半部

参数

[in] sql 顺序锁的指针

注解

上下文：线程、中断底半部

在文件 seqlock.h 第 477 行定义.

{
        xwosdl_sqlk_rdex_unlock_bh(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_unlock_cpuirq()

static void xwos_sqlk_rdex_unlock_cpuirq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：关闭独占读临界区，并开启本地CPU的中断

参数

[in] sql 顺序锁的指针

注解

上下文：任意

在文件 seqlock.h 第 262 行定义.

{
        xwosdl_sqlk_rdex_unlock_cpuirq(&sql->ossql);
}

◆ xwos_sqlk_rdex_unlock_cpuirqrs()

static void xwos_sqlk_rdex_unlock_cpuirqrs	(	struct xwos_sqlk *	sql,
		xwreg_t	cpuirq
	)

inlinestatic

XWOS API：关闭独占读临界区，恢复本地CPU的中断标志

参数

[in]	sql	顺序锁的指针
[in]	cpuirq	本地CPU的中断标志

注解

上下文：任意

在文件 seqlock.h 第 311 行定义.

{
        xwosdl_sqlk_rdex_unlock_cpuirqrs(&sql->ossql, cpuirq);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_rdex_unlock_irqs()

static void xwos_sqlk_rdex_unlock_irqs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：关闭独占读临界区，并开启部分中断

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

在文件 seqlock.h 第 368 行定义.

{
        xwosdl_sqlk_rdex_unlock_irqs(&sql->ossql, irqs, num);
}

◆ xwos_sqlk_rdex_unlock_irqsrs()

static void xwos_sqlk_rdex_unlock_irqsrs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：关闭独占读临界区，恢复部分中断的中断标志

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	flags	部分中断的中断标志数组
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

在文件 seqlock.h 第 429 行定义.

{
        xwosdl_sqlk_rdex_unlock_irqsrs(&sql->ossql, irqs, flags, num);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_lock()

static void xwos_sqlk_wr_lock ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启写临界区

参数

[in] sql 顺序锁的指针

注解

上下文：线程

若顺序锁已处于写或独占读临界区，就自旋等待。

在文件 seqlock.h 第 491 行定义.

{
        xwosdl_sqlk_wr_lock(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_lock_bh()

static void xwos_sqlk_wr_lock_bh ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启写临界区，关闭本地CPU的中断底半部

参数

[in] sql 顺序锁的指针

注解

上下文：线程、中断底半部

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数只会关闭本地CPU的抢占和中断底半部，因此只能保证其临界区在线程与中断底半部中是安全的。

在文件 seqlock.h 第 750 行定义.

{
        xwosdl_sqlk_wr_lock_bh(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_lock_cpuirq()

static void xwos_sqlk_wr_lock_cpuirq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：开启写临界区，并关闭本地CPU的中断

参数

[in] sql 顺序锁的指针

注解

上下文：线程

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 535 行定义.

{
        xwosdl_sqlk_wr_lock_cpuirq(&sql->ossql);
}

◆ xwos_sqlk_wr_lock_cpuirqsv()

static void xwos_sqlk_wr_lock_cpuirqsv	(	struct xwos_sqlk *	sql,
		xwreg_t *	cpuirq
	)

inlinestatic

XWOS API：开启写临界区，保存本地CPU的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[out]	cpuirq	缓冲区指针，用于返回本地CPU的中断标志

注解

上下文：任意

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 580 行定义.

{
        xwosdl_sqlk_wr_lock_cpuirqsv(&sql->ossql, cpuirq);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_lock_irqs()

static void xwos_sqlk_wr_lock_irqs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：开启写临界区，并关闭部分中断

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文中是安全的。

在文件 seqlock.h 第 632 行定义.

{
        xwosdl_sqlk_wr_lock_irqs(&sql->ossql, irqs, num);
}

◆ xwos_sqlk_wr_lock_irqssv()

static void xwos_sqlk_wr_lock_irqssv	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：开启写临界区，保存部分中断的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[out]	flags	缓冲区指针，用于返回部分中断的中断标志
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

若顺序锁已处于写或独占读临界区，就自旋等待。
此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 692 行定义.

{
        xwosdl_sqlk_wr_lock_irqssv(&sql->ossql, irqs, flags, num);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_trylock()

static xwer_t xwos_sqlk_wr_trylock ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：尝试开启写临界区

参数

[in] sql 顺序锁的指针

返回: 错误码

返回值

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

注解

上下文：线程

在文件 seqlock.h 第 506 行定义.

{
        return xwosdl_sqlk_wr_trylock(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_trylock_bh()

static xwer_t xwos_sqlk_wr_trylock_bh ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：尝试开启写临界区，关闭本地CPU的中断底半部

参数

[in] sql 顺序锁的指针

返回: 错误码

返回值

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

注解

上下文：线程、中断底半部

此函数只会关闭本地CPU的抢占和中断底半部，因此只能保证其临界区在线程与中断底半部中是安全的。

在文件 seqlock.h 第 768 行定义.

{
        return xwosdl_sqlk_wr_trylock_bh(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_trylock_cpuirq()

static xwer_t xwos_sqlk_wr_trylock_cpuirq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：尝试开启写临界区，并关闭本地CPU的中断

参数

[in] sql 顺序锁的指针

返回: 错误码

返回值

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

注解

上下文：任意

此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 552 行定义.

{
        return xwosdl_sqlk_wr_trylock_cpuirq(&sql->ossql);
}

◆ xwos_sqlk_wr_trylock_cpuirqsv()

static xwer_t xwos_sqlk_wr_trylock_cpuirqsv	(	struct xwos_sqlk *	sql,
		xwreg_t *	cpuirq
	)

inlinestatic

XWOS API：尝试开启写临界区，保存本地CPU的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[out]	cpuirq	缓冲区指针，用于返回本地CPU的中断标志

返回: 错误码

返回值

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

注解

上下文：任意

此函数会关闭本地CPU的抢占与中断，因此可保证其临界区在所有上下文都是安全的。

在文件 seqlock.h 第 599 行定义.

{
        return xwosdl_sqlk_wr_trylock_cpuirqsv(&sql->ossql, cpuirq);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_trylock_irqs()

static xwer_t xwos_sqlk_wr_trylock_irqs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：尝试开启写临界区，并关闭部分中断

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

返回: 错误码

返回值

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

注解

上下文：线程、中断资源数组中描述的中断

此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 654 行定义.

{
        return xwosdl_sqlk_wr_trylock_irqs(&sql->ossql, irqs, num);
}

◆ xwos_sqlk_wr_trylock_irqssv()

static xwer_t xwos_sqlk_wr_trylock_irqssv	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：尝试开启写临界区，保存部分中断的中断标志并关闭

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[out]	flags	缓冲区指针，用于返回部分中断的中断标志
[in]	num	数组中元素数量

返回: 错误码

返回值

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

注解

上下文：线程、中断资源数组中描述的中断

此函数只会关闭本地CPU的抢占和部分中断，因此只能保证其临界区在这些中断与线程上下文是安全的。

在文件 seqlock.h 第 715 行定义.

{
        return xwosdl_sqlk_wr_trylock_irqssv(&sql->ossql, irqs, flags, num);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_unlock()

static void xwos_sqlk_wr_unlock ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：关闭写临界区

参数

[in] sql 顺序锁的指针

注解

同步/异步：同步
上下文：线程
重入性：不可重入

在文件 seqlock.h 第 520 行定义.

{
        xwosdl_sqlk_wr_unlock(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_unlock_bh()

static void xwos_sqlk_wr_unlock_bh ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：关闭写临界区，开启本地CPU的中断底半部

参数

[in] sql 顺序锁的指针

注解

上下文：线程、中断底半部

若顺序锁已处于写或独占读临界区，就自旋等待。

在文件 seqlock.h 第 782 行定义.

{
        xwosdl_sqlk_wr_unlock_bh(&sql->ossql);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_unlock_cpuirq()

static void xwos_sqlk_wr_unlock_cpuirq ( struct xwos_sqlk * sql )

inlinestatic

XWOS API：关闭写临界区，并开启本地CPU的中断

参数

[in] sql 顺序锁的指针

注解

上下文：任意

在文件 seqlock.h 第 564 行定义.

{
        xwosdl_sqlk_wr_unlock_cpuirq(&sql->ossql);
}

◆ xwos_sqlk_wr_unlock_cpuirqrs()

static void xwos_sqlk_wr_unlock_cpuirqrs	(	struct xwos_sqlk *	sql,
		xwreg_t	cpuirq
	)

inlinestatic

XWOS API：关闭写临界区，恢复本地CPU的中断标志

参数

[in]	sql	顺序锁的指针
[in]	cpuirq	本地CPU的中断标志

注解

上下文：任意

在文件 seqlock.h 第 613 行定义.

{
        xwosdl_sqlk_wr_unlock_cpuirqrs(&sql->ossql, cpuirq);
}

这是这个函数的调用关系图:

◆ xwos_sqlk_wr_unlock_irqs()

static void xwos_sqlk_wr_unlock_irqs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwsz_t	num
	)

inlinestatic

XWOS API：关闭写临界区，并开启部分中断

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

在文件 seqlock.h 第 670 行定义.

{
        xwosdl_sqlk_wr_unlock_irqs(&sql->ossql, irqs, num);
}

◆ xwos_sqlk_wr_unlock_irqsrs()

static void xwos_sqlk_wr_unlock_irqsrs	(	struct xwos_sqlk *	sql,
		const xwirq_t	irqs[],
		xwreg_t	flags[],
		xwsz_t	num
	)

inlinestatic

XWOS API：关闭写临界区，恢复部分中断的中断标志

参数

[in]	sql	顺序锁的指针
[in]	irqs	中断资源数组指针
[in]	flags	部分中断的中断标志数组
[in]	num	数组中元素数量

注解

上下文：线程、中断资源数组中描述的中断

在文件 seqlock.h 第 732 行定义.

{
        xwosdl_sqlk_wr_unlock_irqsrs(&sql->ossql, irqs, flags, num);
}

这是这个函数的调用关系图:

结构体

宏定义

函数

详细描述

顺序锁的初始化

非独占读

独占读

写

C++

宏定义说明

◆ XWOS_SQLK_GRANULARITY

◆ XWOS_SQLK_INITIALIZER

函数说明

◆ xwos_sqlk_get_seq()

◆ xwos_sqlk_init()

◆ xwos_sqlk_rd_begin()

◆ xwos_sqlk_rd_retry()

◆ xwos_sqlk_rdex_lock()

◆ xwos_sqlk_rdex_lock_bh()

◆ xwos_sqlk_rdex_lock_cpuirq()

◆ xwos_sqlk_rdex_lock_cpuirqsv()

◆ xwos_sqlk_rdex_lock_irqs()

◆ xwos_sqlk_rdex_lock_irqssv()

◆ xwos_sqlk_rdex_trylock()

◆ xwos_sqlk_rdex_trylock_bh()

◆ xwos_sqlk_rdex_trylock_cpuirq()

◆ xwos_sqlk_rdex_trylock_cpuirqsv()

◆ xwos_sqlk_rdex_trylock_irqs()

◆ xwos_sqlk_rdex_trylock_irqssv()

◆ xwos_sqlk_rdex_unlock()

◆ xwos_sqlk_rdex_unlock_bh()

◆ xwos_sqlk_rdex_unlock_cpuirq()

◆ xwos_sqlk_rdex_unlock_cpuirqrs()

◆ xwos_sqlk_rdex_unlock_irqs()

◆ xwos_sqlk_rdex_unlock_irqsrs()

◆ xwos_sqlk_wr_lock()

◆ xwos_sqlk_wr_lock_bh()

◆ xwos_sqlk_wr_lock_cpuirq()

◆ xwos_sqlk_wr_lock_cpuirqsv()

◆ xwos_sqlk_wr_lock_irqs()

◆ xwos_sqlk_wr_lock_irqssv()

◆ xwos_sqlk_wr_trylock()

◆ xwos_sqlk_wr_trylock_bh()

◆ xwos_sqlk_wr_trylock_cpuirq()

◆ xwos_sqlk_wr_trylock_cpuirqsv()

◆ xwos_sqlk_wr_trylock_irqs()

◆ xwos_sqlk_wr_trylock_irqssv()

◆ xwos_sqlk_wr_unlock()

◆ xwos_sqlk_wr_unlock_bh()

◆ xwos_sqlk_wr_unlock_cpuirq()

◆ xwos_sqlk_wr_unlock_cpuirqrs()

◆ xwos_sqlk_wr_unlock_irqs()

◆ xwos_sqlk_wr_unlock_irqsrs()