Mutex

Mutex 的协作图:

结构体
struct	rt_mutex

类型定义
typedef struct rt_mutex *	rt_mutex_t

函数
rt_err_t	rt_mutex_init (rt_mutex_t mutex, const char *name, rt_uint8_t flag)
	RTM_EXPORT (rt_mutex_init)
rt_err_t	rt_mutex_detach (rt_mutex_t mutex)
	RTM_EXPORT (rt_mutex_detach)
void	rt_mutex_drop_thread (rt_mutex_t mutex, rt_thread_t thread)
rt_uint8_t	rt_mutex_setprioceiling (rt_mutex_t mutex, rt_uint8_t priority)
	RTM_EXPORT (rt_mutex_setprioceiling)
rt_uint8_t	rt_mutex_getprioceiling (rt_mutex_t mutex)
	RTM_EXPORT (rt_mutex_getprioceiling)
rt_mutex_t	rt_mutex_create (const char *name, rt_uint8_t flag)
	RTM_EXPORT (rt_mutex_create)
rt_err_t	rt_mutex_delete (rt_mutex_t mutex)
	RTM_EXPORT (rt_mutex_delete)
rt_err_t	rt_mutex_take (rt_mutex_t mutex, rt_int32_t time)
	RTM_EXPORT (rt_mutex_take)
rt_err_t	rt_mutex_take_interruptible (rt_mutex_t mutex, rt_int32_t time)
	RTM_EXPORT (rt_mutex_take_interruptible)
rt_err_t	rt_mutex_take_killable (rt_mutex_t mutex, rt_int32_t time)
	RTM_EXPORT (rt_mutex_take_killable)
rt_err_t	rt_mutex_trytake (rt_mutex_t mutex)
	RTM_EXPORT (rt_mutex_trytake)
rt_err_t	rt_mutex_release (rt_mutex_t mutex)
	RTM_EXPORT (rt_mutex_release)
rt_err_t	rt_mutex_control (rt_mutex_t mutex, int cmd, void *arg)
	RTM_EXPORT (rt_mutex_control)
rt_inline rt_thread_t	rt_mutex_get_owner (rt_mutex_t mutex)
rt_inline rt_ubase_t	rt_mutex_get_hold (rt_mutex_t mutex)

详细描述

类型定义说明

rt_mutex_t

typedef struct rt_mutex* rt_mutex_t

在文件 rtdef.h 第 1037 行定义.

函数说明

rt_mutex_init()

rt_err_t rt_mutex_init	(	rt_mutex_t	mutex,
		const char *	name,
		rt_uint8_t	flag )

Initialize a static mutex object.

注解

For the static mutex object, its memory space is allocated by the compiler during compiling, and shall placed on the read-write data segment or on the uninitialized data segment. By contrast, the rt_mutex_create() function will automatically allocate memory space and initialize the mutex.

参见

rt_mutex_create()

参数

mutex	is a pointer to the mutex to initialize. It is assumed that storage for the mutex will be allocated in your application.
name	is a pointer to the name that given to the mutex.
flag	is the mutex flag, which determines the queuing way of how multiple threads wait when the mutex is not available. NOTE: This parameter has been obsoleted. It can be RT_IPC_FLAG_PRIO, RT_IPC_FLAG_FIFO or RT_NULL.

返回

Return the operation status. When the return value is RT_EOK, the initialization is successful. If the return value is any other values, it represents the initialization failed.

警告

This function can ONLY be called from threads.

在文件 ipc.c 第 1007 行定义.

{
    /* flag parameter has been obsoleted */
    RT_UNUSED(flag);
 
    /* parameter check */
    RT_ASSERT(mutex != RT_NULL);
 
    /* initialize object */
    rt_object_init(&(mutex->parent.parent), RT_Object_Class_Mutex, name);
 
    /* initialize ipc object */
    _ipc_object_init(&(mutex->parent));
 
    mutex->owner    = RT_NULL;
    mutex->priority = 0xFF;
    mutex->hold     = 0;
    mutex->ceiling_priority = 0xFF;
    rt_list_init(&(mutex->taken_list));
 
    /* flag can only be RT_IPC_FLAG_PRIO. RT_IPC_FLAG_FIFO cannot solve the unbounded priority inversion problem */
    mutex->parent.parent.flag = RT_IPC_FLAG_PRIO;
    rt_spin_lock_init(&(mutex->spinlock));
 
    return RT_EOK;
}

引用了 _ipc_object_init(), rt_mutex::ceiling_priority, rt_object::flag, rt_mutex::hold, rt_mutex::owner, rt_ipc_object::parent, rt_mutex::parent, rt_mutex::priority, RT_ASSERT, RT_IPC_FLAG_PRIO, rt_list_init(), RT_NULL, RT_Object_Class_Mutex, rt_object_init(), rt_spin_lock_init(), RT_UNUSED, rt_mutex::spinlock , 以及 rt_mutex::taken_list.

函数调用图:

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

RTM_EXPORT() [1/12]

RTM_EXPORT

(

rt_mutex_init

)

引用了 rt_mutex_init().

函数调用图:

rt_mutex_detach()

rt_err_t rt_mutex_detach

(

rt_mutex_t

mutex

)

This function will detach a static mutex object.

注解

This function is used to detach a static mutex object which is initialized by rt_mutex_init() function. By contrast, the rt_mutex_delete() function will delete a mutex object. When the mutex is successfully detached, it will resume all suspended threads in the mutex list.

参见

rt_mutex_delete()

参数

mutex

is a pointer to a mutex object to be detached.

返回

Return the operation status. When the return value is RT_EOK, the initialization is successful. If the return value is any other values, it means that the mutex detach failed.

警告

This function can ONLY detach a static mutex initialized by the rt_mutex_init() function. If the mutex is created by the rt_mutex_create() function, you MUST NOT USE this function to detach it, ONLY USE the rt_mutex_delete() function to complete the deletion.

在文件 ipc.c 第 1054 行定义.

{
    /* parameter check */
    RT_ASSERT(mutex != RT_NULL);
    RT_ASSERT(rt_object_get_type(&mutex->parent.parent) == RT_Object_Class_Mutex);
    RT_ASSERT(rt_object_is_systemobject(&mutex->parent.parent));
 
    _mutex_before_delete_detach(mutex);
 
    /* detach mutex object */
    rt_object_detach(&(mutex->parent.parent));
 
    return RT_EOK;
}

引用了 rt_ipc_object::parent, rt_mutex::parent, RT_ASSERT, RT_NULL, RT_Object_Class_Mutex, rt_object_detach(), rt_object_get_type() , 以及 rt_object_is_systemobject().

函数调用图:

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

RTM_EXPORT() [2/12]

RTM_EXPORT

(

rt_mutex_detach

)

引用了 rt_mutex_detach().

函数调用图:

rt_mutex_drop_thread()

void rt_mutex_drop_thread	(	rt_mutex_t	mutex,
		rt_thread_t	thread )

drop a thread from the suspend list of mutex

参数

mutex	is a pointer to a mutex object.
thread	is the thread should be dropped from mutex.

Should change the priority of mutex owner thread Note: After current thread is detached from mutex pending list, there is a chance that the mutex owner has been released the mutex. Which means mutex->owner can be NULL at this point. If that happened, it had already reset its priority. So it's okay to skip

在文件 ipc.c 第 1078 行定义.

{
    rt_uint8_t priority;
    rt_bool_t need_update = RT_FALSE;
    rt_sched_lock_level_t slvl;
 
    /* parameter check */
    RT_DEBUG_IN_THREAD_CONTEXT;
    RT_ASSERT(mutex != RT_NULL);
    RT_ASSERT(thread != RT_NULL);
 
    rt_spin_lock(&(mutex->spinlock));
 
    RT_ASSERT(thread->pending_object == &mutex->parent.parent);
 
    rt_sched_lock(&slvl);
 
    /* detach from suspended list */
    rt_list_remove(&RT_THREAD_LIST_NODE(thread));

    if (mutex->owner && rt_sched_thread_get_curr_prio(mutex->owner) ==
                            rt_sched_thread_get_curr_prio(thread))
    {
        need_update = RT_TRUE;
    }
 
    /* update the priority of mutex */
    if (!rt_list_isempty(&mutex->parent.suspend_thread))
    {
        /* more thread suspended in the list */
        struct rt_thread *th;
 
        th = RT_THREAD_LIST_NODE_ENTRY(mutex->parent.suspend_thread.next);
        /* update the priority of mutex */
        mutex->priority = rt_sched_thread_get_curr_prio(th);
    }
    else
    {
        /* set mutex priority to maximal priority */
        mutex->priority = 0xff;
    }
 
    /* try to change the priority of mutex owner thread */
    if (need_update)
    {
        /* get the maximal priority of mutex in thread */
        priority = _thread_get_mutex_priority(mutex->owner);
        if (priority != rt_sched_thread_get_curr_prio(mutex->owner))
        {
            _thread_update_priority(mutex->owner, priority, RT_UNINTERRUPTIBLE);
        }
    }
 
    rt_sched_unlock(slvl);
    rt_spin_unlock(&(mutex->spinlock));
}

引用了 _thread_get_mutex_priority(), _thread_update_priority(), rt_list_node::next, rt_mutex::owner, rt_ipc_object::parent, rt_mutex::parent, rt_thread::pending_object, rt_mutex::priority, RT_ASSERT, RT_DEBUG_IN_THREAD_CONTEXT, RT_FALSE, rt_list_isempty(), rt_list_remove(), RT_NULL, rt_sched_lock(), rt_sched_thread_get_curr_prio(), rt_sched_unlock(), rt_spin_lock(), rt_spin_unlock(), RT_THREAD_LIST_NODE, RT_THREAD_LIST_NODE_ENTRY, RT_TRUE, RT_UNINTERRUPTIBLE, rt_mutex::spinlock , 以及 rt_ipc_object::suspend_thread.

函数调用图:

rt_mutex_setprioceiling()

rt_uint8_t rt_mutex_setprioceiling	(	rt_mutex_t	mutex,
		rt_uint8_t	priority )

set the prioceiling attribute of the mutex.

参数

mutex	is a pointer to a mutex object.
priority	is the priority should be set to mutex.

返回

return the old priority ceiling

在文件 ipc.c 第 1151 行定义.

{
    rt_uint8_t ret_priority = 0xFF;
    rt_uint8_t highest_prio;
    rt_sched_lock_level_t slvl;
 
    RT_DEBUG_IN_THREAD_CONTEXT;
 
    if ((mutex) && (priority < RT_THREAD_PRIORITY_MAX))
    {
        /* critical section here if multiple updates to one mutex happen */
        rt_spin_lock(&(mutex->spinlock));
        ret_priority = mutex->ceiling_priority;
        mutex->ceiling_priority = priority;
        if (mutex->owner)
        {
            rt_sched_lock(&slvl);
            highest_prio = _thread_get_mutex_priority(mutex->owner);
            if (highest_prio != rt_sched_thread_get_curr_prio(mutex->owner))
            {
                _thread_update_priority(mutex->owner, highest_prio, RT_UNINTERRUPTIBLE);
            }
            rt_sched_unlock(slvl);
        }
        rt_spin_unlock(&(mutex->spinlock));
    }
    else
    {
        rt_set_errno(-RT_EINVAL);
    }
 
    return ret_priority;
}

引用了 _thread_get_mutex_priority(), _thread_update_priority(), rt_mutex::ceiling_priority, rt_mutex::owner, RT_DEBUG_IN_THREAD_CONTEXT, rt_sched_lock(), rt_sched_thread_get_curr_prio(), rt_sched_unlock(), rt_spin_lock(), rt_spin_unlock(), RT_UNINTERRUPTIBLE , 以及 rt_mutex::spinlock.

函数调用图:

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

RTM_EXPORT() [3/12]

RTM_EXPORT

(

rt_mutex_setprioceiling

)

引用了 rt_mutex_setprioceiling().

函数调用图:

rt_mutex_getprioceiling()

rt_uint8_t rt_mutex_getprioceiling

(

rt_mutex_t

mutex

)

set the prioceiling attribute of the mutex.

参数

mutex

is a pointer to a mutex object.

返回

return the current priority ceiling of the mutex.

在文件 ipc.c 第 1194 行定义.

{
    rt_uint8_t prio = 0xFF;
 
    /* parameter check */
    RT_DEBUG_IN_THREAD_CONTEXT;
    RT_ASSERT(mutex != RT_NULL);
 
    if (mutex)
    {
        rt_spin_lock(&(mutex->spinlock));
        prio = mutex->ceiling_priority;
        rt_spin_unlock(&(mutex->spinlock));
    }
 
    return prio;
}

引用了 rt_mutex::ceiling_priority, RT_ASSERT, RT_DEBUG_IN_THREAD_CONTEXT, RT_NULL, rt_spin_lock(), rt_spin_unlock() , 以及 rt_mutex::spinlock.

函数调用图:

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

RTM_EXPORT() [4/12]

RTM_EXPORT

(

rt_mutex_getprioceiling

)

引用了 rt_mutex_getprioceiling().

函数调用图:

rt_mutex_create()

rt_mutex_t rt_mutex_create	(	const char *	name,
		rt_uint8_t	flag )

This function will create a mutex object.

注解

For the mutex object, its memory space is automatically allocated. By contrast, the rt_mutex_init() function will initialize a static mutex object.

参见

rt_mutex_init()

参数

name	is a pointer to the name that given to the mutex.
flag	is the mutex flag, which determines the queuing way of how multiple threads wait when the mutex is not available. NOTE: This parameter has been obsoleted. It can be RT_IPC_FLAG_PRIO, RT_IPC_FLAG_FIFO or RT_NULL.

返回

Return a pointer to the mutex object. When the return value is RT_NULL, it means the creation failed.

警告

This function can ONLY be called from threads.

在文件 ipc.c 第 1233 行定义.

{
    struct rt_mutex *mutex;
 
    /* flag parameter has been obsoleted */
    RT_UNUSED(flag);
 
    RT_DEBUG_NOT_IN_INTERRUPT;
 
    /* allocate object */
    mutex = (rt_mutex_t)rt_object_allocate(RT_Object_Class_Mutex, name);
    if (mutex == RT_NULL)
        return mutex;
 
    /* initialize ipc object */
    _ipc_object_init(&(mutex->parent));
 
    mutex->owner    = RT_NULL;
    mutex->priority = 0xFF;
    mutex->hold     = 0;
    mutex->ceiling_priority = 0xFF;
    rt_list_init(&(mutex->taken_list));
 
    /* flag can only be RT_IPC_FLAG_PRIO. RT_IPC_FLAG_FIFO cannot solve the unbounded priority inversion problem */
    mutex->parent.parent.flag = RT_IPC_FLAG_PRIO;
    rt_spin_lock_init(&(mutex->spinlock));
 
    return mutex;
}

引用了 _ipc_object_init(), rt_mutex::ceiling_priority, rt_object::flag, rt_mutex::hold, rt_mutex::owner, rt_ipc_object::parent, rt_mutex::parent, rt_mutex::priority, RT_DEBUG_NOT_IN_INTERRUPT, RT_IPC_FLAG_PRIO, rt_list_init(), RT_NULL, rt_object_allocate(), RT_Object_Class_Mutex, rt_spin_lock_init(), RT_UNUSED, rt_mutex::spinlock , 以及 rt_mutex::taken_list.

函数调用图:

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

RTM_EXPORT() [5/12]

RTM_EXPORT

(

rt_mutex_create

)

引用了 rt_mutex_create().

函数调用图:

rt_mutex_delete()

rt_err_t rt_mutex_delete

(

rt_mutex_t

mutex

)

This function will delete a mutex object and release this memory space.

注解

This function is used to delete a mutex object which is created by the rt_mutex_create() function. By contrast, the rt_mutex_detach() function will detach a static mutex object. When the mutex is successfully deleted, it will resume all suspended threads in the mutex list.

参见

rt_mutex_detach()

参数

mutex

is a pointer to a mutex object to be deleted.

返回

Return the operation status. When the return value is RT_EOK, the operation is successful. If the return value is any other values, it means that the mutex detach failed.

警告

This function can ONLY delete a mutex initialized by the rt_mutex_create() function. If the mutex is initialized by the rt_mutex_init() function, you MUST NOT USE this function to delete it, ONLY USE the rt_mutex_detach() function to complete the detachment.

在文件 ipc.c 第 1283 行定义.

{
    /* parameter check */
    RT_ASSERT(mutex != RT_NULL);
    RT_ASSERT(rt_object_get_type(&mutex->parent.parent) == RT_Object_Class_Mutex);
    RT_ASSERT(rt_object_is_systemobject(&mutex->parent.parent) == RT_FALSE);
 
    RT_DEBUG_NOT_IN_INTERRUPT;
 
    _mutex_before_delete_detach(mutex);
 
    /* delete mutex object */
    rt_object_delete(&(mutex->parent.parent));
 
    return RT_EOK;
}

引用了 rt_ipc_object::parent, rt_mutex::parent, RT_ASSERT, RT_DEBUG_NOT_IN_INTERRUPT, RT_FALSE, RT_NULL, RT_Object_Class_Mutex, rt_object_delete(), rt_object_get_type() , 以及 rt_object_is_systemobject().

函数调用图:

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

RTM_EXPORT() [6/12]

RTM_EXPORT

(

rt_mutex_delete

)

引用了 rt_mutex_delete(), RT_MUTEX_HOLD_MAX, RT_NULL, RT_Object_Class_Mutex , 以及 RT_TRUE.

函数调用图:

rt_mutex_take()

rt_err_t rt_mutex_take	(	rt_mutex_t	mutex,
		rt_int32_t	time )

在文件 ipc.c 第 1537 行定义.

{
    return _rt_mutex_take(mutex, time, RT_UNINTERRUPTIBLE);
}

引用了 RT_UNINTERRUPTIBLE.

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

RTM_EXPORT() [7/12]

RTM_EXPORT

(

rt_mutex_take

)

引用了 rt_mutex_take().

函数调用图:

rt_mutex_take_interruptible()

rt_err_t rt_mutex_take_interruptible	(	rt_mutex_t	mutex,
		rt_int32_t	time )

在文件 ipc.c 第 1543 行定义.

{
    return _rt_mutex_take(mutex, time, RT_INTERRUPTIBLE);
}

引用了 RT_INTERRUPTIBLE.

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

RTM_EXPORT() [8/12]

RTM_EXPORT

(

rt_mutex_take_interruptible

)

引用了 rt_mutex_take_interruptible().

函数调用图:

rt_mutex_take_killable()

rt_err_t rt_mutex_take_killable	(	rt_mutex_t	mutex,
		rt_int32_t	time )

在文件 ipc.c 第 1549 行定义.

{
    return _rt_mutex_take(mutex, time, RT_KILLABLE);
}

引用了 RT_KILLABLE.

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

RTM_EXPORT() [9/12]

RTM_EXPORT

(

rt_mutex_take_killable

)

引用了 rt_mutex_take_killable().

函数调用图:

rt_mutex_trytake()

rt_err_t rt_mutex_trytake

(

rt_mutex_t

mutex

)

This function will try to take a mutex, if the mutex is unavailable, the thread returns immediately.

注解

This function is very similar to the rt_mutex_take() function, when the mutex is not available, except that rt_mutex_trytake() will return immediately without waiting for a timeout when the mutex is not available. In other words, rt_mutex_trytake(mutex) has the same effect as rt_mutex_take(mutex, 0).

参见

rt_mutex_take()

参数

mutex

is a pointer to a mutex object.

返回

Return the operation status. ONLY When the return value is RT_EOK, the operation is successful. If the return value is any other values, it means that the mutex take failed.

在文件 ipc.c 第 1570 行定义.

{
    return rt_mutex_take(mutex, RT_WAITING_NO);
}

引用了 rt_mutex_take() , 以及 RT_WAITING_NO.

函数调用图:

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

RTM_EXPORT() [10/12]

RTM_EXPORT

(

rt_mutex_trytake

)

引用了 rt_mutex_trytake().

函数调用图:

rt_mutex_release()

rt_err_t rt_mutex_release

(

rt_mutex_t

mutex

)

This function will release a mutex. If there is thread suspended on the mutex, the thread will be resumed.

注解

If there are threads suspended on this mutex, the first thread in the list of this mutex object will be resumed, and a thread scheduling (rt_schedule) will be executed. If no threads are suspended on this mutex, the count value mutex->value of this mutex will increase by 1.

参数

mutex

is a pointer to a mutex object.

返回

Return the operation status. When the return value is RT_EOK, the operation is successful. If the return value is any other values, it means that the mutex release failed.

a timeout timer had triggered while we try. So we skip this thread and try again.

在文件 ipc.c 第 1589 行定义.

{
    rt_sched_lock_level_t slvl;
    struct rt_thread *thread;
    rt_bool_t need_schedule;
 
    /* parameter check */
    RT_ASSERT(mutex != RT_NULL);
    RT_ASSERT(rt_object_get_type(&mutex->parent.parent) == RT_Object_Class_Mutex);
 
    need_schedule = RT_FALSE;
 
    /* only thread could release mutex because we need test the ownership */
    RT_DEBUG_IN_THREAD_CONTEXT;
 
    /* get current thread */
    thread = rt_thread_self();
 
    rt_spin_lock(&(mutex->spinlock));
 
    LOG_D("mutex_release:current thread %s, hold: %d",
          thread->parent.name, mutex->hold);
 
    RT_OBJECT_HOOK_CALL(rt_object_put_hook, (&(mutex->parent.parent)));
 
    /* mutex only can be released by owner */
    if (thread != mutex->owner)
    {
        thread->error = -RT_ERROR;
        rt_spin_unlock(&(mutex->spinlock));
 
        return -RT_ERROR;
    }
 
    /* decrease hold */
    mutex->hold --;
    /* if no hold */
    if (mutex->hold == 0)
    {
        rt_sched_lock(&slvl);
 
        /* remove mutex from thread's taken list */
        rt_list_remove(&mutex->taken_list);
 
        /* whether change the thread priority */
        need_schedule = _check_and_update_prio(thread, mutex);
 
        /* wakeup suspended thread */
        if (!rt_list_isempty(&mutex->parent.suspend_thread))
        {
            struct rt_thread *next_thread;
            do
            {
                /* get the first suspended thread */
                next_thread = RT_THREAD_LIST_NODE_ENTRY(mutex->parent.suspend_thread.next);
 
                RT_ASSERT(rt_sched_thread_is_suspended(next_thread));
 
                /* remove the thread from the suspended list of mutex */
                rt_list_remove(&RT_THREAD_LIST_NODE(next_thread));
 
                /* resume thread to ready queue */
                if (rt_sched_thread_ready(next_thread) != RT_EOK)
                {
                    next_thread = RT_NULL;
                }
            } while (!next_thread && !rt_list_isempty(&mutex->parent.suspend_thread));
 
            if (next_thread)
            {
                LOG_D("mutex_release: resume thread: %s",
                    next_thread->parent.name);
 
                /* set new owner and put mutex into taken list of thread */
                mutex->owner = next_thread;
                mutex->hold  = 1;
                rt_list_insert_after(&next_thread->taken_object_list, &mutex->taken_list);
 
                /* cleanup pending object */
                next_thread->pending_object = RT_NULL;
 
                /* update mutex priority */
                if (!rt_list_isempty(&(mutex->parent.suspend_thread)))
                {
                    struct rt_thread *th;
 
                    th = RT_THREAD_LIST_NODE_ENTRY(mutex->parent.suspend_thread.next);
                    mutex->priority = rt_sched_thread_get_curr_prio(th);
                }
                else
                {
                    mutex->priority = 0xff;
                }
 
                need_schedule = RT_TRUE;
            }
            else
            {
                /* no waiting thread is woke up, clear owner */
                mutex->owner = RT_NULL;
                mutex->priority = 0xff;
            }
 
            rt_sched_unlock(slvl);
        }
        else
        {
            rt_sched_unlock(slvl);
 
            /* clear owner */
            mutex->owner    = RT_NULL;
            mutex->priority = 0xff;
        }
    }
 
    rt_spin_unlock(&(mutex->spinlock));
 
    /* perform a schedule */
    if (need_schedule == RT_TRUE)
        rt_schedule();
 
    return RT_EOK;
}

引用了 rt_thread::error, rt_mutex::hold, LOG_D, rt_object::name, rt_list_node::next, rt_mutex::owner, rt_ipc_object::parent, rt_mutex::parent, rt_thread::parent, rt_thread::pending_object, rt_mutex::priority, RT_ASSERT, RT_DEBUG_IN_THREAD_CONTEXT, RT_FALSE, rt_list_insert_after(), rt_list_isempty(), rt_list_remove(), RT_NULL, RT_Object_Class_Mutex, rt_object_get_type(), RT_OBJECT_HOOK_CALL, rt_sched_lock(), rt_sched_thread_get_curr_prio(), rt_sched_thread_is_suspended(), rt_sched_thread_ready(), rt_sched_unlock(), rt_schedule(), rt_spin_lock(), rt_spin_unlock(), RT_THREAD_LIST_NODE, RT_THREAD_LIST_NODE_ENTRY, rt_thread_self(), RT_TRUE, rt_mutex::spinlock, rt_ipc_object::suspend_thread, rt_mutex::taken_list , 以及 rt_thread::taken_object_list.

函数调用图:

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

RTM_EXPORT() [11/12]

RTM_EXPORT

(

rt_mutex_release

)

引用了 rt_mutex_release().

函数调用图:

rt_mutex_control()

rt_err_t rt_mutex_control	(	rt_mutex_t	mutex,
		int	cmd,
		void *	arg )

This function will set some extra attributions of a mutex object.

注解

Currently this function does not implement the control function.

参数

mutex	is a pointer to a mutex object.
cmd	is a command word used to configure some attributions of the mutex.
arg	is the argument of the function to execute the command.

返回

Return the operation status. When the return value is RT_EOK, the operation is successful. If the return value is any other values, it means that this function failed to execute.

在文件 ipc.c 第 1733 行定义.

{
    RT_UNUSED(mutex);
    RT_UNUSED(cmd);
    RT_UNUSED(arg);
 
    return -RT_EINVAL;
}

引用了 RT_UNUSED.

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

RTM_EXPORT() [12/12]

RTM_EXPORT

(

rt_mutex_control

)

引用了 rt_mutex_control().

函数调用图:

rt_mutex_get_owner()

rt_inline rt_thread_t rt_mutex_get_owner

(

rt_mutex_t

mutex

)

在文件 rtthread.h 第 468 行定义.

{
    return mutex->owner;
}

引用了 rt_mutex::owner.

rt_mutex_get_hold()

rt_inline rt_ubase_t rt_mutex_get_hold

(

rt_mutex_t

mutex

)

在文件 rtthread.h 第 472 行定义.

{
    return mutex->hold;
}

引用了 rt_mutex::hold.