los_task_pri.h 21.4 KB
Newer Older
1
/*
2 3
 * Copyright (c) 2013-2019 Huawei Technologies Co., Ltd. All rights reserved.
 * Copyright (c) 2020-2021 Huawei Device Co., Ltd. All rights reserved.
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
 *
 * Redistribution and use in source and binary forms, with or without modification,
 * are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice, this list of
 *    conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright notice, this list
 *    of conditions and the following disclaimer in the documentation and/or other materials
 *    provided with the distribution.
 *
 * 3. Neither the name of the copyright holder nor the names of its contributors may be used
 *    to endorse or promote products derived from this software without specific prior written
 *    permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef _LOS_TASK_PRI_H
#define _LOS_TASK_PRI_H

#include "los_task.h"
36
#include "los_percpu_pri.h"
37
#include "los_spinlock.h"
38
#ifdef LOSCFG_SCHED_DEBUG
39 40 41 42 43
#include "los_stat_pri.h"
#endif
#include "los_stackinfo_pri.h"
#include "los_futex_pri.h"
#include "los_signal.h"
44 45 46 47
#ifdef LOSCFG_KERNEL_CPUP
#include "los_cpup_pri.h"
#endif

48 49 50 51 52 53 54 55 56 57 58 59
#ifdef __cplusplus
#if __cplusplus
extern "C" {
#endif /* __cplusplus */
#endif /* __cplusplus */

/**
 * @ingroup los_task
 * Define task siginal types.
 *
 * Task siginal types.
 */
60
#define SIGNAL_NONE                 0U			//无信号
61 62
#define SIGNAL_KILL                 (1U << 0)	//干掉
#define SIGNAL_SUSPEND              (1U << 1)	//挂起
63
#define SIGNAL_AFFI                 (1U << 2)	//CPU 亲和性,一个任务被切换后被同一个CPU再次执行,则亲和力高
64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85

/* scheduler lock */
extern SPIN_LOCK_S g_taskSpin;//任务自旋锁
#define SCHEDULER_LOCK(state)       LOS_SpinLockSave(&g_taskSpin, &(state))
#define SCHEDULER_UNLOCK(state)     LOS_SpinUnlockRestore(&g_taskSpin, state)

/* default and non-running task's ownership id */
#define OS_TASK_INVALID_CPUID       0xFFFF

/**
 * @ingroup los_task
 * Null task ID
 *
 */
#define OS_TASK_ERRORID             0xFFFFFFFF

/**
 * @ingroup los_task
 * Define a usable task priority.
 *
 * Highest task priority.
 */
86
#define OS_TASK_PRIORITY_HIGHEST    0	//任务最高优先级,软时钟任务就是最高级任务,见于 OsSwtmrTaskCreate
87 88 89 90 91 92 93

/**
 * @ingroup los_task
 * Define a usable task priority.
 *
 * Lowest task priority.
 */
94
#define OS_TASK_PRIORITY_LOWEST     31 //任务最低优先级
95 96 97 98 99 100 101

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is init.
 */
102
#define OS_TASK_STATUS_INIT         0x0001U //初始化状态
103 104 105 106 107 108 109

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is ready.
 */
110
#define OS_TASK_STATUS_READY        0x0002U //就绪状态的任务都将插入就绪队列,注意就绪队列的本质是个双向链表
111 112 113 114 115 116 117

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is running.
 */
118
#define OS_TASK_STATUS_RUNNING      0x0004U //运行状态
119 120 121 122 123 124 125

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is suspended.
 */
126
#define OS_TASK_STATUS_SUSPENDED    0x0008U
127 128 129 130 131 132 133

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is blocked.
 */
134
#define OS_TASK_STATUS_PENDING      0x0010U
135 136 137 138 139 140 141

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is delayed.
 */
142
#define OS_TASK_STATUS_DELAY        0x0020U //延期状态
143 144 145 146 147 148 149

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The time for waiting for an event to occur expires.
 */
150
#define OS_TASK_STATUS_TIMEOUT      0x0040U	//任务超时
151 152 153 154 155 156 157 158 159

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is pend for a period of time.
 */
#define OS_TASK_STATUS_PEND_TIME    0x0080U

160 161 162
#define OS_TASK_STATUS_BLOCKED      (OS_TASK_STATUS_INIT | OS_TASK_STATUS_PENDING | \
                                     OS_TASK_STATUS_DELAY | OS_TASK_STATUS_PEND_TIME)

163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185
/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is exit.
 */
#define OS_TASK_STATUS_EXIT         0x0100U

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task control block is unused.
 */
#define OS_TASK_STATUS_UNUSED       0x0200U

/**
 * @ingroup los_task
 * Flag that indicates the task or task control block status.
 *
 * The task is joinable.
 */
#define OS_TASK_FLAG_PTHREAD_JOIN   0x0400U //主task和子task连在一块不分离
186

187 188 189 190
/**
 * @ingroup los_task
 * Flag that indicates the task property.
 *
191
 * The task is system-level task, like idle, swtmr and etc.
192
 */
193
#define OS_TASK_FLAG_SYSTEM_TASK    0x1000U	//系统任务
194 195 196 197 198

/**
 * @ingroup los_task
 * Flag that indicates the task property.
 *
199
 * The task is no-delete system task, like resourceTask. //该任务是不可删除的系统任务,如资源回收任务
200
 */
201
#define OS_TASK_FLAG_NO_DELETE    0x2000U
202

203 204 205 206 207 208
/**
 * @ingroup los_task
 * Flag that indicates the task property.
 *
 * Kills the thread during process exit.
 */
209
#define OS_TASK_FLAG_EXIT_KILL       0x4000U //在进程退出期间一同被干掉的任务
210

211 212 213 214 215 216
/**
 * @ingroup los_task
 * Flag that indicates the task property.
 *
 * Specifies the process creation task.
 */
217
#define OS_TASK_FLAG_SPECIFIES_PROCESS 0x0U //创建指定任务 例如: cat weharmony.net 实现 
218 219 220 221 222 223

/**
 * @ingroup los_task
 * Boundary on which the stack size is aligned.
 *
 */
224
#define OS_TASK_STACK_SIZE_ALIGN    16U //堆栈大小对齐的边界
225 226 227 228 229 230 231 232 233 234 235

/**
 * @ingroup los_task
 * Boundary on which the stack address is aligned.
 *
 */
#define OS_TASK_STACK_ADDR_ALIGN    8U

/**
 * @ingroup los_task
 * Number of usable task priorities.
236
 */	//可用任务优先级的数量
237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
#define OS_TSK_PRINUM               (OS_TASK_PRIORITY_LOWEST - OS_TASK_PRIORITY_HIGHEST + 1)

/**
* @ingroup  los_task
* @brief Check whether a task ID is valid.
*
* @par Description:
* This API is used to check whether a task ID, excluding the idle task ID, is valid.
* @attention None.
*
* @param  taskID [IN] Task ID.
*
* @retval 0 or 1. One indicates that the task ID is invalid, whereas zero indicates that the task ID is valid.
* @par Dependency:
* <ul><li>los_task_pri.h: the header file that contains the API declaration.</li></ul>
* @see
*/
#define OS_TSK_GET_INDEX(taskID) (taskID)

/**
* @ingroup  los_task
* @brief Obtain the pointer to a task control block.
*
* @par Description:
* This API is used to obtain the pointer to a task control block using a corresponding parameter.
* @attention None.
*
* @param  ptr [IN] Parameter used for obtaining the task control block.
*
* @retval Pointer to the task control block.
* @par Dependency:
* <ul><li>los_task_pri.h: the header file that contains the API declaration.</li></ul>
* @see
*/
#define OS_TCB_FROM_PENDLIST(ptr) LOS_DL_LIST_ENTRY(ptr, LosTaskCB, pendList)
//通过pendList取出TCB,用于挂入链表节点时使用 pendList的情况 
/**
* @ingroup  los_task
* @brief Obtain the pointer to a task control block.
*
* @par Description:
* This API is used to obtain the pointer to a task control block that has a specified task ID.
* @attention None.
*
* @param  TaskID [IN] Task ID.
*
* @retval Pointer to the task control block.
* @par Dependency:
* <ul><li>los_task_pri.h: the header file that contains the API declaration.</li></ul>
* @see
*/
#define OS_TCB_FROM_TID(taskID) (((LosTaskCB *)g_taskCBArray) + (taskID))
//通过Tid找到TCB
#ifndef LOSCFG_STACK_POINT_ALIGN_SIZE
#define LOSCFG_STACK_POINT_ALIGN_SIZE                       (sizeof(UINTPTR) * 2)
#endif

294
#define OS_TASK_RESOURCE_STATIC_SIZE    0x1000	//4K
295 296 297 298 299 300 301
#define OS_TASK_RESOURCE_FREE_PRIORITY  5		//回收资源任务的优先级
#define OS_RESOURCE_EVENT_MASK          0xFF	//资源事件的掩码
#define OS_RESOURCE_EVENT_OOM           0x02	//内存溢出事件
#define OS_RESOURCE_EVENT_FREE          0x04	//资源释放事件
#define OS_TCB_NAME_LEN 32

typedef struct {
302 303 304
    VOID            *stackPointer;      /**< Task stack pointer \n  */	//内核栈指针位置(SP)
    UINT16          taskStatus;         /**< Task status \n  */			//各种状态标签,可以拥有多种标签,按位标识
    UINT16          priority;           /**< Task priority \n  */		//任务优先级[0:31],默认是31级
305
    UINT16          policy;				//任务的调度方式(三种 .. LOS_SCHED_RR )
306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325
    UINT64          startTime;          /**< The start time of each phase of task \n  *///任务开始时间
    UINT64          irqStartTime;       /**< Interrupt start time \n  *///任务中断开始时间
    UINT32          irqUsedTime;        /**< Interrupt consumption time \n  *///任务中断恢复时间
    UINT32          initTimeSlice;      /**< Task init time slice \n  *///任务初始的时间片
    INT32           timeSlice;          /**< Task remaining time slice \n  *///任务剩余时间片
    UINT32          waitTimes;          /**< Task delay time, tick number \n  *///设置任务调度延期时间
    SortLinkList    sortList;           /**< Task sortlink node \n  */	//任务排序链表节点
    UINT32          stackSize;          /**< Task stack size \n  */		//内核态栈大小,内存来自内核空间
    UINTPTR         topOfStack;         /**< Task stack top \n  */		//内核态栈顶 bottom = top + size
    UINT32          taskID;             /**< Task ID \n  */				//任务ID,任务池本质是一个大数组,ID就是数组的索引,默认 < 128
    TSK_ENTRY_FUNC  taskEntry;          /**< Task entrance function \n  */	//任务执行入口函数
    VOID            *joinRetval;        /**< pthread adaption \n  */	//用来存储join线程的返回值
    VOID            *taskMux;           /**< Task-held mutex \n  */		//task在等哪把锁
    VOID            *taskEvent;         /**< Task-held event \n  */		//task在等哪个事件
    UINTPTR         args[4];            /**< Parameter, of which the maximum number is 4 \n  */	//入口函数的参数 例如 main (int argc,char *argv[])
    CHAR            taskName[OS_TCB_NAME_LEN]; /**< Task name \n  */	//任务的名称
    LOS_DL_LIST     pendList;           /**< Task pend node \n  */		//如果任务阻塞时就通过它挂到各种阻塞情况的链表上,比如OsTaskWait时
    LOS_DL_LIST     threadList;         /**< thread list \n  */			//挂到所属进程的线程链表上
    UINT32          eventMask;          /**< Event mask \n  */			//任务对哪些事件进行屏蔽
    UINT32          eventMode;          /**< Event mode \n  */			//事件三种模式(LOS_WAITMODE_AND,LOS_WAITMODE_OR,LOS_WAITMODE_CLR)
326
    UINT32          priBitMap;          /**< BitMap for recording the change of task priority,	//任务在执行过程中优先级会经常变化,这个变量用来记录所有曾经变化
327
                                             the priority can not be greater than 31 \n  */			//过的优先级,例如 ..01001011 曾经有过 0,1,3,6 优先级
328
#ifdef LOSCFG_KERNEL_CPUP
329
    OsCpupBase      taskCpup;           /**< task cpu usage \n  */
330
#endif
331 332
    INT32           errorNo;            /**< Error Num \n  */
    UINT32          signal;             /**< Task signal \n  */ //任务信号类型,(SIGNAL_NONE,SIGNAL_KILL,SIGNAL_SUSPEND,SIGNAL_AFFI)
333
    sig_cb          sig;				//信号控制块,用于异步通信,类似于 linux singal模块
334
#ifdef LOSCFG_KERNEL_SMP
335 336 337
    UINT16          currCpu;            /**< CPU core number of this task is running on \n  */	//正在运行此任务的CPU内核号
    UINT16          lastCpu;            /**< CPU core number of this task is running on last time \n  */ //上次运行此任务的CPU内核号
    UINT16          cpuAffiMask;        /**< CPU affinity mask, support up to 16 cores \n  */	//CPU亲和力掩码,最多支持16核,亲和力很重要,多核情况下尽量一个任务在一个CPU核上运行,提高效率
338
#ifdef LOSCFG_KERNEL_SMP_TASK_SYNC
339
    UINT32          syncSignal;         /**< Synchronization for signal handling \n  */	//用于CPU之间 同步信号
340
#endif
341
#ifdef LOSCFG_KERNEL_SMP_LOCKDEP //死锁检测开关
342 343 344
    LockDep         lockDep;
#endif
#endif
345
#ifdef LOSCFG_SCHED_DEBUG
346
    SchedStat       schedStat;          /**< Schedule statistics \n  */
347
#endif
348 349 350 351 352 353 354 355
    UINTPTR         userArea;			///< 用户空间的堆区开始位置
    UINTPTR         userMapBase;		///< 用户空间的栈顶位置,内存来自用户空间,和topOfStack有本质的区别.
    UINT32          userMapSize;        /**< user thread stack size ,real size : userMapSize + USER_STACK_MIN_SIZE \n  *///用户栈大小
    UINT32          processID;          /**< Which belong process \n  *///所属进程ID
    FutexNode       futex;				///< 实现快锁功能
    LOS_DL_LIST     joinList;           /**< join list \n  */ //联结链表,允许任务之间相互释放彼此
    LOS_DL_LIST     lockList;           /**< Hold the lock list \n 该链表上挂的都是已持有的锁 */
    UINTPTR         waitID;             /**< Wait for the PID or GID of the child process \n  */
356
    UINT16          waitFlag;           /**< The type of child process that is waiting, belonging to a group or parent,
357
                                             a specific child process, or any child process \n 以什么样的方式等待子进程结束(OS_TASK_WAIT_PROCESS | OS_TASK_WAIT_GID | ..) */
358
#ifdef LOSCFG_KERNEL_LITEIPC
359 360
    LOS_DL_LIST     msgListHead;		///< 消息队列头结点,上面挂的都是任务要读的消息
    BOOL            accessMap[LOSCFG_BASE_CORE_TSK_LIMIT];///< 访问图,指的是task之间是否能访问的标识,LOSCFG_BASE_CORE_TSK_LIMIT 为任务池总数
361
#endif
362 363 364 365
#ifdef LOSCFG_KERNEL_PERF
    UINTPTR         pc;
    UINTPTR         fp;
#endif
366 367 368 369 370 371 372
} LosTaskCB;
//LosTask结构体是给外部使用的
typedef struct {
    LosTaskCB *runTask;
    LosTaskCB *newTask;
} LosTask;

373
struct ProcessSignalInfo {//进程信号描述符
374 375 376 377 378
    siginfo_t *sigInfo;       /**< Signal to be dispatched \n  要发送的信号*/
    LosTaskCB *defaultTcb;    /**< Default TCB \n 默认task,默认接收信号的任务. */
    LosTaskCB *unblockedTcb;  /**< The signal unblock on this TCB \n 信号在此TCB上解除阻塞  */
    LosTaskCB *awakenedTcb;   /**< This TCB was awakened \n  即 任务在等待这个信号,此信号一来任务被唤醒.*/
    LosTaskCB *receivedTcb;   /**< This TCB received the signal \n 如果没有屏蔽信号,任务将接收这个信号. */
379 380
};

381
typedef int (*ForEachTaskCB)(LosTaskCB *tcb, void *arg);//回调任务函数,例如:进程被kill 9 时,通知所有任务善后处理
382 383 384 385 386 387

/**
 * @ingroup los_task
 * Maximum number of tasks.
 *
 */
388
extern UINT32 g_taskMaxNum;///< 任务最大数量 默认128个
389 390 391 392 393 394 395


/**
 * @ingroup los_task
 * Starting address of a task.
 *
 */
396
extern LosTaskCB *g_taskCBArray;///< 外部变量 任务池 默认128个
397 398 399 400 401 402

/**
 * @ingroup los_task
 * Time slice structure.
 */
typedef struct {//时间片结构体,任务轮询
403 404 405
    LosTaskCB *task; /**< Current running task \n 当前运行着的任务*/
    UINT16 time;     /**< Expiration time point \n 过期时间点*/
    UINT16 timeout;  /**< Expiration duration \n 有效期*/
406 407 408 409 410 411
} OsTaskRobin;
//获取当前CPU  core运行的任务
STATIC INLINE LosTaskCB *OsCurrTaskGet(VOID)
{
    return (LosTaskCB *)ArchCurrTaskGet();
}
412
///告诉协处理器当前任务使用范围为内核空间 
413 414 415 416
STATIC INLINE VOID OsCurrTaskSet(LosTaskCB *task)
{
    ArchCurrTaskSet(task);
}
417
///告诉协处理器当前任务使用范围为 用户空间
418 419 420 421
STATIC INLINE VOID OsCurrUserTaskSet(UINTPTR thread)
{
    ArchCurrUserTaskSet(thread);
}
422
///通过任务ID获取任务实体,task由任务池分配,本质是个数组,彼此都挨在一块
423 424 425 426
STATIC INLINE LosTaskCB *OsGetTaskCB(UINT32 taskID)
{
    return OS_TCB_FROM_TID(taskID);
}
427
///任务是否在使用
428 429 430 431 432 433 434 435
STATIC INLINE BOOL OsTaskIsUnused(const LosTaskCB *taskCB)
{
    if (taskCB->taskStatus & OS_TASK_STATUS_UNUSED) {//在freelist中的任务都是 OS_TASK_STATUS_UNUSED 状态
        return TRUE;
    }

    return FALSE;
}
436
///任务是否在运行
437 438 439 440 441 442 443 444
STATIC INLINE BOOL OsTaskIsRunning(const LosTaskCB *taskCB)
{
    if (taskCB->taskStatus & OS_TASK_STATUS_RUNNING) {//一个CPU core 只能有一个 OS_TASK_STATUS_RUNNING task
        return TRUE;
    }

    return FALSE;
}
445
///任务是否不再活动
446 447 448 449 450 451 452 453 454
STATIC INLINE BOOL OsTaskIsInactive(const LosTaskCB *taskCB)
{
    if (taskCB->taskStatus & (OS_TASK_STATUS_UNUSED | OS_TASK_STATUS_INIT | OS_TASK_STATUS_EXIT)) {//三个标签有一个代表不在活动
        return TRUE;
    }

    return FALSE;
}

455 456 457 458 459 460 461 462
STATIC INLINE BOOL OsTaskIsPending(const LosTaskCB *taskCB)
{
    if (taskCB->taskStatus & OS_TASK_STATUS_PENDING) {
        return TRUE;
    }

    return FALSE;
}
463 464 465 466 467 468 469 470 471 472

STATIC INLINE BOOL OsTaskIsKilled(const LosTaskCB *taskCB)
{
    if (taskCB->taskStatus & OS_TASK_FLAG_EXIT_KILL) {
        return TRUE;
    }

    return FALSE;
}

473 474 475 476 477
#define OS_TID_CHECK_INVALID(taskID) ((UINT32)(taskID) >= g_taskMaxNum)//是否有无效的任务 > 128

/* get task info */
#define OS_ALL_TASK_MASK  0xFFFFFFFF

478 479 480 481 482 483 484 485 486 487 488 489
#define OS_TASK_WAIT_ANYPROCESS (1 << 0U)					///< 任务等待任何进程出现
#define OS_TASK_WAIT_PROCESS    (1 << 1U)					///< 任务等待进程出现
#define OS_TASK_WAIT_GID        (1 << 2U)					///< 任务等待组ID
#define OS_TASK_WAIT_SEM        (OS_TASK_WAIT_GID + 1)		///< 任务等待信号量发生
#define OS_TASK_WAIT_QUEUE      (OS_TASK_WAIT_SEM + 1)		///< 任务等待队列到来
#define OS_TASK_WAIT_JOIN       (OS_TASK_WAIT_QUEUE + 1)	///< 任务等待
#define OS_TASK_WAIT_SIGNAL     (OS_TASK_WAIT_JOIN + 1) 	///< 任务等待信号的到来
#define OS_TASK_WAIT_LITEIPC    (OS_TASK_WAIT_SIGNAL + 1)	///< 任务等待liteipc到来
#define OS_TASK_WAIT_MUTEX      (OS_TASK_WAIT_LITEIPC + 1)	///< 任务等待MUTEX到来
#define OS_TASK_WAIT_FUTEX      (OS_TASK_WAIT_MUTEX + 1)	///< 任务等待FUTEX到来
#define OS_TASK_WAIT_EVENT      (OS_TASK_WAIT_FUTEX + 1) 	///< 任务等待事件发生
#define OS_TASK_WAIT_COMPLETE   (OS_TASK_WAIT_EVENT + 1)	///< 任务等待完成
490 491

//设置事件阻塞掩码,即设置任务的等待事件.
492 493 494 495 496 497 498
STATIC INLINE VOID OsTaskWaitSetPendMask(UINT16 mask, UINTPTR lockID, UINT32 timeout)
{
    LosTaskCB *runTask = OsCurrTaskGet();
    runTask->waitID = lockID;
    runTask->waitFlag = mask;
    (VOID)timeout;
}
499

500
//清除事件阻塞掩码,即任务不再等待任何事件.
501 502 503 504 505 506
STATIC INLINE VOID OsTaskWakeClearPendMask(LosTaskCB *resumeTask)
{
    resumeTask->waitID = 0;
    resumeTask->waitFlag = 0;
}

507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539
extern UINT32 OsTaskSetDetachUnsafe(LosTaskCB *taskCB);
extern VOID OsTaskJoinPostUnsafe(LosTaskCB *taskCB);
extern UINT32 OsTaskJoinPendUnsafe(LosTaskCB *taskCB);
extern BOOL OsTaskCpuAffiSetUnsafe(UINT32 taskID, UINT16 newCpuAffiMask, UINT16 *oldCpuAffiMask);
extern VOID OsTaskSchedule(LosTaskCB *, LosTaskCB *);
extern VOID OsTaskContextLoad(LosTaskCB *newTask);
extern VOID OsIdleTask(VOID);
extern UINT32 OsIdleTaskCreate(VOID);
extern UINT32 OsTaskInit(VOID);
extern UINT32 OsShellCmdDumpTask(INT32 argc, const CHAR **argv);
extern UINT32 OsShellCmdTskInfoGet(UINT32 taskID, VOID *seqfile, UINT16 flag);
extern LosTaskCB *OsGetMainTask(VOID);
extern VOID OsSetMainTask(VOID);
extern UINT32 OsGetIdleTaskId(VOID);
extern VOID OsTaskEntry(UINT32 taskID);
extern SortLinkAttribute *OsTaskSortLinkGet(VOID);
extern VOID OsTaskProcSignal(VOID);
extern UINT32 OsTaskDeleteUnsafe(LosTaskCB *taskCB, UINT32 status, UINT32 intSave);
extern VOID OsTaskResourcesToFree(LosTaskCB *taskCB);
extern VOID OsRunTaskToDelete(LosTaskCB *taskCB);
extern UINT32 OsCreateUserTask(UINT32 processID, TSK_INIT_PARAM_S *initParam);
extern INT32 OsSetTaskName(LosTaskCB *taskCB, const CHAR *name, BOOL setPName);
extern VOID OsTaskCBRecycleToFree(VOID);
extern VOID OsTaskExitGroup(UINT32 status);
extern VOID OsTaskToExit(LosTaskCB *taskCB, UINT32 status);
extern VOID OsExecDestroyTaskGroup(VOID);
extern UINT32 OsUserTaskOperatePermissionsCheck(LosTaskCB *taskCB);
extern UINT32 OsUserProcessOperatePermissionsCheck(LosTaskCB *taskCB, UINT32 processID);
extern INT32 OsTcbDispatch(LosTaskCB *stcb, siginfo_t *info);
extern VOID OsWriteResourceEvent(UINT32 events);
extern VOID OsWriteResourceEventUnsafe(UINT32 events);
extern UINT32 OsResourceFreeTaskCreate(VOID);

540 541 542 543 544 545 546
#ifdef __cplusplus
#if __cplusplus
}
#endif /* __cplusplus */
#endif /* __cplusplus */

#endif /* _LOS_TASK_PRI_H */