los_rwlock_pri.h 文件参考

浏览源代码.

枚举
enum	RwlockMode {   RWLOCK_NONE_MODE , RWLOCK_READ_MODE , RWLOCK_WRITE_MODE , RWLOCK_READFIRST_MODE ,   RWLOCK_WRITEFIRST_MODE }

函数
UINT32	OsRwlockRdUnsafe (LosRwlock *rwlock, UINT32 timeout)
UINT32	OsRwlockTryRdUnsafe (LosRwlock *rwlock, UINT32 timeout)
UINT32	OsRwlockWrUnsafe (LosRwlock *rwlock, UINT32 timeout)
UINT32	OsRwlockTryWrUnsafe (LosRwlock *rwlock, UINT32 timeout)
UINT32	OsRwlockUnlockUnsafe (LosRwlock *rwlock, BOOL *needSched)
	释放锁,唤醒任务 更多...

枚举类型说明

RwlockMode

enum RwlockMode

枚举值
RWLOCK_NONE_MODE	自由模式: 读写链表都没有内容
RWLOCK_READ_MODE	读模式: 读链表有数据,写链表没有数据
RWLOCK_WRITE_MODE	写模式: 写链表有数据,读链表没有数据
RWLOCK_READFIRST_MODE	读优先模式: 读链表中的任务最高优先级高于写链表中任务最高优先级
RWLOCK_WRITEFIRST_MODE	写优先模式: 写链表中的任务最高优先级高于读链表中任务最高优先级

在文件 los_rwlock_pri.h 第 46 行定义.

                {
    RWLOCK_NONE_MODE,   ///< 自由模式: 读写链表都没有内容 
    RWLOCK_READ_MODE,   ///< 读模式: 读链表有数据,写链表没有数据
    RWLOCK_WRITE_MODE,  ///< 写模式: 写链表有数据,读链表没有数据
    RWLOCK_READFIRST_MODE,  ///< 读优先模式: 读链表中的任务最高优先级高于写链表中任务最高优先级
    RWLOCK_WRITEFIRST_MODE  ///< 写优先模式: 写链表中的任务最高优先级高于读链表中任务最高优先级
};

函数说明

OsRwlockRdUnsafe()

UINT32 OsRwlockRdUnsafe	(	LosRwlock *	rwlock,
		UINT32	timeout
	)

在文件 los_rwlock.c 第 252 行定义.

{
    if ((rwlock->magic & RWLOCK_COUNT_MASK) != OS_RWLOCK_MAGIC) {
        return LOS_EBADF;
    }
 
    return OsRwlockRdPendOp(OsCurrTaskGet(), rwlock, timeout);
}

函数调用图:

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

OsRwlockTryRdUnsafe()

UINT32 OsRwlockTryRdUnsafe	(	LosRwlock *	rwlock,
		UINT32	timeout
	)

在文件 los_rwlock.c 第 261 行定义.

{
    if ((rwlock->magic & RWLOCK_COUNT_MASK) != OS_RWLOCK_MAGIC) {
        return LOS_EBADF;
    }
 
    LosTaskCB *runTask = OsCurrTaskGet();
    if ((LosTaskCB *)(rwlock->writeOwner) == runTask) {
        return LOS_EINVAL;
    }
 
    /*
     * When the rwlock mode is read mode or free mode and the priority of the current read task
     * is lower than the first pended write task, current read task can not obtain the rwlock.
     */
    if ((rwlock->rwCount >= 0) && !OsRwlockPriCompare(runTask, &(rwlock->writeList))) {
        return LOS_EBUSY;
    }
 
    /*
     * When the rwlock mode is write mode, current read task can not obtain the rwlock.
     */
    if (rwlock->rwCount < 0) {
        return LOS_EBUSY;
    }
 
    return OsRwlockRdPendOp(runTask, rwlock, timeout);
}

函数调用图:

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

OsRwlockTryWrUnsafe()

UINT32 OsRwlockTryWrUnsafe	(	LosRwlock *	rwlock,
		UINT32	timeout
	)

在文件 los_rwlock.c 第 299 行定义.

{
    if ((rwlock->magic & RWLOCK_COUNT_MASK) != OS_RWLOCK_MAGIC) {
        return LOS_EBADF;
    }
 
    /* When the rwlock is read mode, current write task will be pended.
    | 当 rwlock 为读模式时，当前的写任务将被挂起。*/
    if (rwlock->rwCount > 0) {
        return LOS_EBUSY;
    }
 
    /* When other write task obtains this rwlock, current write task will be pended. 
    | 当其他写任务获得这个rwlock时，当前的写任务将被挂起。*/
    LosTaskCB *runTask = OsCurrTaskGet();
    if ((rwlock->rwCount < 0) && ((LosTaskCB *)(rwlock->writeOwner) != runTask)) {
        return LOS_EBUSY;
    }
 
    return OsRwlockWrPendOp(runTask, rwlock, timeout);//
}

函数调用图:

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

OsRwlockUnlockUnsafe()

UINT32 OsRwlockUnlockUnsafe	(	LosRwlock *	rwlock,
		BOOL *	needSched
	)

释放锁,唤醒任务

在文件 los_rwlock.c 第 449 行定义.

{
    if ((rwlock->magic & RWLOCK_COUNT_MASK) != OS_RWLOCK_MAGIC) {
        return LOS_EBADF;
    }
 
    if (rwlock->rwCount == 0) {
        return LOS_EPERM;
    }
 
    LosTaskCB *runTask = OsCurrTaskGet();
    if ((rwlock->rwCount < 0) && ((LosTaskCB *)(rwlock->writeOwner) != runTask)) {//写模式时,当前任务未持有锁
        return LOS_EPERM;
    }
 
    /*
     * When the rwCount of the rwlock more than 1 or less than -1, the rwlock mode will
     * not changed after current unlock operation, so pended tasks can not be waken.
     | 当 rwlock 的 rwCount 大于 1 或小于 -1 时，当前解锁操作后 rwlock 模式不会改变，因此挂起的任务不能被唤醒。
     */
    if (rwlock->rwCount > 1) {//读模式
        rwlock->rwCount--;
        return LOS_OK;
    }
 
    if (rwlock->rwCount < -1) {//写模式
        rwlock->rwCount++;
        return LOS_OK;
    }
 
    return OsRwlockPostOp(rwlock, needSched);
}

函数调用图:

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

OsRwlockWrUnsafe()

UINT32 OsRwlockWrUnsafe	(	LosRwlock *	rwlock,
		UINT32	timeout
	)

在文件 los_rwlock.c 第 290 行定义.

{
    if ((rwlock->magic & RWLOCK_COUNT_MASK) != OS_RWLOCK_MAGIC) {
        return LOS_EBADF;
    }
 
    return OsRwlockWrPendOp(OsCurrTaskGet(), rwlock, timeout);
}

函数调用图:

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