libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues Releases Wiki Activity

[kernel] rt_thread_suspend/resume增加注释

This commit is contained in:
Meco Man 2022-01-08 16:30:22 -05:00 committed by Bernard Xiong
parent 43e7186a99
commit 3ac9eece5a
1 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
src/thread.c
View File

@ -805,7 +805,11 @@ RTM_EXPORT(rt_thread_control);
/** /**
* @brief This function will suspend the specified thread and change it to suspend state. * @brief This function will suspend the specified thread and change it to suspend state.
* *
* @note This function only can suspend current thread itself. * @note This function ONLY can suspend current thread itself.
* Do not use the rt_thread_suspend and rt_thread_resume functions to synchronize the activities of threads.
* You have no way of knowing what code a thread is executing when you suspend it.
* If you suspend a thread while it is executing a critical area which is protected by a mutex,
* other threads attempt to use that mutex and have to wait. Deadlocks can occur very easily.
* *
* @param thread is the thread to be suspended. * @param thread is the thread to be suspended.
* *
@ -833,11 +837,6 @@ rt_err_t rt_thread_suspend(rt_thread_t thread)
/* disable interrupt */ /* disable interrupt */
temp = rt_hw_interrupt_disable(); temp = rt_hw_interrupt_disable();
if (stat == RT_THREAD_RUNNING)
{
/* not suspend running status thread on other core */
RT_ASSERT(thread == rt_thread_self());
}
/* change thread stat */ /* change thread stat */
rt_schedule_remove_thread(thread); rt_schedule_remove_thread(thread);
@ -857,6 +856,8 @@ RTM_EXPORT(rt_thread_suspend);
/** /**
* @brief This function will resume a thread and put it to system ready queue. * @brief This function will resume a thread and put it to system ready queue.
* *
* @note Do not use the rt_thread_suspend and rt_thread_resume functions to synchronize the activities of threads.
*
* @param thread is the thread to be resumed. * @param thread is the thread to be resumed.
* *
* @return Return the operation status. If the return value is RT_EOK, the function is successfully executed. * @return Return the operation status. If the return value is RT_EOK, the function is successfully executed.