diff --git a/src/kernel_liteos_a/kernel/base/include/los_container_pri.h b/src/kernel_liteos_a/kernel/base/include/los_container_pri.h
index d7b72c70..db10f529 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_container_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_container_pri.h
@@ -57,10 +57,10 @@
typedef enum {
CONTAINER = 0,
- PID_CONTAINER,
- PID_CHILD_CONTAINER,
- UTS_CONTAINER,
- MNT_CONTAINER,
+ PID_CONTAINER, //进程容器
+ PID_CHILD_CONTAINER, //子进程容器
+ UTS_CONTAINER, //
+ MNT_CONTAINER, //挂载容器
IPC_CONTAINER,
USER_CONTAINER,
TIME_CONTAINER,
@@ -70,29 +70,29 @@ typedef enum {
} ContainerType;
typedef struct Container {
- Atomic rc;
+ Atomic rc; //原子操作
#ifdef LOSCFG_PID_CONTAINER
- struct PidContainer *pidContainer;
- struct PidContainer *pidForChildContainer;
+ struct PidContainer *pidContainer; //进程容器
+ struct PidContainer *pidForChildContainer;//进程的孩子容器
#endif
#ifdef LOSCFG_UTS_CONTAINER
- struct UtsContainer *utsContainer;
+ struct UtsContainer *utsContainer; //
#endif
#ifdef LOSCFG_MNT_CONTAINER
- struct MntContainer *mntContainer;
+ struct MntContainer *mntContainer; //挂载容器
#endif
#ifdef LOSCFG_IPC_CONTAINER
- struct IpcContainer *ipcContainer;
+ struct IpcContainer *ipcContainer; //IPC容器
#endif
#ifdef LOSCFG_TIME_CONTAINER
- struct TimeContainer *timeContainer;
- struct TimeContainer *timeForChildContainer;
+ struct TimeContainer *timeContainer; //时间容器
+ struct TimeContainer *timeForChildContainer;
#endif
#ifdef LOSCFG_NET_CONTAINER
- struct NetContainer *netContainer;
+ struct NetContainer *netContainer; //网络容器
#endif
} Container;
-
+//容器数量上限
typedef struct TagContainerLimit {
#ifdef LOSCFG_PID_CONTAINER
UINT32 pidLimit;
diff --git a/src/kernel_liteos_a/kernel/base/include/los_err_pri.h b/src/kernel_liteos_a/kernel/base/include/los_err_pri.h
index 40a667ae..e7c7fc9c 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_err_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_err_pri.h
@@ -40,78 +40,21 @@ extern "C" {
#endif /* __cplusplus */
#endif /* __cplusplus */
-/**
- * @ingroup los_err
- * Define the error magic word.
- */
+
#define OS_ERR_MAGIC_WORD 0xa1b2c3f8
-/**
- * @ingroup los_err
- * @brief Error handling macro capable of returning error codes.
- *
- * @par Description:
- * This API is used to call the error handling function by using an error code and return the same error code.
- * @attention
- *
- *
- * @param errNo [IN] Error code.
- *
- * @retval errNo
- * @par Dependency:
- * - los_err_pri.h: the header file that contains the API declaration.
- * @see None.
- */
#define OS_RETURN_ERROR(errNo) do { \
(VOID)LOS_ErrHandle("os_unspecific_file", OS_ERR_MAGIC_WORD, errNo, 0, NULL); \
return errNo; \
} while (0)
-/**
- * @ingroup los_err
- * @brief Error handling macro capable of returning error codes.
- *
- * @par Description:
- * This API is used to call the error handling function by using an error code and the line number of
- * the erroneous line, and return the same error code.
- * @attention
- *
- *
- * @param errLine [IN] Line number of the erroneous line.
- * @param errNo [IN] Error code.
- *
- * @retval errNo
- * @par Dependency:
- * - los_err_pri.h: the header file that contains the API declaration.
- * @see None.
- */
+
#define OS_RETURN_ERROR_P2(errLine, errNo) do { \
(VOID)LOS_ErrHandle("os_unspecific_file", errLine, errNo, 0, NULL); \
return errNo; \
} while (0)
-/**
- * @ingroup los_err
- * @brief Macro for jumping to error handler.
- *
- * @par Description:
- * This API is used to call the error handling function by using an error code.
- * @attention
- *
- *
- * @param errorNo [IN] Error code.
- *
- * @retval None.
- * @par Dependency:
- * - los_err_pri.h: the header file that contains the API declaration.
- * @see None.
- */
+
#define OS_GOTO_ERR_HANDLER(errorNo) do { \
errNo = errorNo; \
errLine = OS_ERR_MAGIC_WORD; \
diff --git a/src/kernel_liteos_a/kernel/base/include/los_futex_pri.h b/src/kernel_liteos_a/kernel/base/include/los_futex_pri.h
index 7671115b..758a2679 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_futex_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_futex_pri.h
@@ -33,25 +33,27 @@
#define _LOS_FUTEX_PRI_H
#include "los_list.h"
-#define FUTEX_WAIT 0
-#define FUTEX_WAKE 1
-#define FUTEX_REQUEUE 3
-#define FUTEX_WAKE_OP 5
+#define FUTEX_WAIT 0 ///< 原子性的检查 uaddr 中计数器的值是否为 val，如果是则让任务休眠，直到 FUTEX_WAKE 或者超时（time-out）。
+ //也就是把任务挂到 uaddr 相对应的等待队列上去。
+#define FUTEX_WAKE 1 ///< 最多唤醒 val 个等待在 uaddr 上任务。
+#define FUTEX_REQUEUE 3 ///< 调整指定锁在Futex表中的位置
+#define FUTEX_WAKE_OP 5
#define FUTEX_LOCK_PI 6
#define FUTEX_UNLOCK_PI 7
#define FUTEX_TRYLOCK_PI 8
#define FUTEX_WAIT_BITSET 9
-#define FUTEX_PRIVATE 128
+#define FUTEX_PRIVATE 128 //私有快锁（以虚拟地址进行哈希）
#define FUTEX_MASK 0x3U
-
+/// 每个futex node对应一个被挂起的task ，key值唯一标识一把用户态锁，具有相同key值的node被queue_list串联起来表示被同一把锁阻塞的task队列。
typedef struct {
- UINTPTR key; /* private:uvaddr shared:paddr */
- UINT32 index; /* hash bucket index */
- UINT32 pid; /* private:process id shared:OS_INVALID(-1) */
- LOS_DL_LIST pendList; /* point to pendList in TCB struct */
- LOS_DL_LIST queueList; /* thread list blocked by this lock */
- LOS_DL_LIST futexList; /* point to the next FutexNode */
+ UINTPTR key; /* private:uvaddr | 私有锁,用虚拟地址 shared:paddr | 共享锁,用物理地址*/
+ UINT32 index; /* hash bucket index | 哈希桶索引 OsFutexKeyToIndex */
+ UINT32 pid; /* private:process id shared:OS_INVALID(-1) | 私有锁:进程ID , 共享锁为 -1 */
+ LOS_DL_LIST pendList; /* point to pendList in TCB struct | 指向 TCB 结构中的 pendList, 通过它找到任务*/
+ LOS_DL_LIST queueList; /* thread list blocked by this lock | 挂等待这把锁的任务，其实这里挂到是FutexNode.queueList ,
+ 通过 queueList 可以找到 pendList ,通过 pendList又可以找到真正的任务*/
+ LOS_DL_LIST futexList; /* point to the next FutexNode | 下一把Futex锁*/
} FutexNode;
extern UINT32 OsFutexInit(VOID);
diff --git a/src/kernel_liteos_a/kernel/base/include/los_ipc_container_pri.h b/src/kernel_liteos_a/kernel/base/include/los_ipc_container_pri.h
index 42ccbf3e..d46bd84b 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_ipc_container_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_ipc_container_pri.h
@@ -42,13 +42,13 @@ typedef struct TagQueueCB LosQueueCB;
typedef struct OsMux LosMux;
typedef LosMux pthread_mutex_t;
typedef struct ProcessCB LosProcessCB;
-
+//IPC容器
typedef struct IpcContainer {
Atomic rc;
- LosQueueCB *allQueue;
- LOS_DL_LIST freeQueueList;
+ LosQueueCB *allQueue; //队列控制块（读写分离模式）
+ LOS_DL_LIST freeQueueList;//空闲队列链表
fd_set queueFdSet;
- struct mqarray queueTable[LOSCFG_BASE_IPC_QUEUE_LIMIT];
+ struct mqarray queueTable[LOSCFG_BASE_IPC_QUEUE_LIMIT];//队列池
pthread_mutex_t mqueueMutex;
struct mqpersonal *mqPrivBuf[MAX_MQ_FD];
struct shminfo shmInfo;
diff --git a/src/kernel_liteos_a/kernel/base/include/los_memstat_pri.h b/src/kernel_liteos_a/kernel/base/include/los_memstat_pri.h
index a2a9f581..7f3aee4b 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_memstat_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_memstat_pri.h
@@ -42,7 +42,7 @@ extern "C" {
#endif /* __cplusplus */
typedef struct {
- UINT32 memUsed;
+ UINT32 memUsed; ///< 记录任务内存使用量
} TskMemUsedInfo;
extern VOID OsTaskMemUsedInc(UINT32 usedSize, UINT32 taskID);
@@ -53,7 +53,7 @@ extern VOID OsTaskMemClear(UINT32 taskID);
#ifdef LOS_MEM_SLAB
typedef struct {
- UINT32 slabUsed;
+ UINT32 slabUsed; ///< 任务占用以slab分配方式内存量
} TskSlabUsedInfo;
extern VOID OsTaskSlabUsedInc(UINT32 usedSize, UINT32 taskID);
diff --git a/src/kernel_liteos_a/kernel/base/include/los_mux_pri.h b/src/kernel_liteos_a/kernel/base/include/los_mux_pri.h
index 8837114c..ebab2648 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_mux_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_mux_pri.h
@@ -1,6 +1,6 @@
/*
* Copyright (c) 2013-2019 Huawei Technologies Co., Ltd. All rights reserved.
- * Copyright (c) 2020-2022 Huawei Device Co., Ltd. All rights reserved.
+ * Copyright (c) 2020-2021 Huawei Device Co., Ltd. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
diff --git a/src/kernel_liteos_a/kernel/base/include/los_percpu_pri.h b/src/kernel_liteos_a/kernel/base/include/los_percpu_pri.h
index 8a824ffd..e561c03d 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_percpu_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_percpu_pri.h
@@ -43,9 +43,9 @@ extern "C" {
#ifdef LOSCFG_KERNEL_SMP
typedef enum {
- CPU_RUNNING = 0, /* cpu is running */
- CPU_HALT, /* cpu in the halt */
- CPU_EXC /* cpu in the exc */
+ CPU_RUNNING = 0, ///< cpu is running | CPU正在运行状态
+ CPU_HALT, ///< cpu in the halt | CPU处于暂停状态
+ CPU_EXC ///< cpu in the exc | CPU处于异常状态
} ExcFlag;
typedef struct {
@@ -55,14 +55,14 @@ typedef struct {
#endif
} Percpu;
-/* the kernel per-cpu structure */
+/*! the kernel per-cpu structure | 每个cpu的内核描述符 */
extern Percpu g_percpu[LOSCFG_KERNEL_CORE_NUM];
-
+/*! 获得当前运行CPU的信息 */
STATIC INLINE Percpu *OsPercpuGet(VOID)
{
- return &g_percpu[ArchCurrCpuid()];
+ return &g_percpu[ArchCurrCpuid()];
}
-
+/*! 获得参数CPU的信息 */
STATIC INLINE Percpu *OsPercpuGetByID(UINT32 cpuid)
{
return &g_percpu[cpuid];
diff --git a/src/kernel_liteos_a/kernel/base/include/los_pid_container_pri.h b/src/kernel_liteos_a/kernel/base/include/los_pid_container_pri.h
index cc047e68..eed94630 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_pid_container_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_pid_container_pri.h
@@ -38,29 +38,29 @@ typedef struct TagTaskCB LosTaskCB;
typedef struct ProcessCB LosProcessCB;
struct ProcessGroup;
struct Container;
-
+//虚拟进程/任务 信息
typedef struct {
- UINT32 vid; /* Virtual ID */
- UINT32 vpid; /* Virtual parent ID */
- UINTPTR cb; /* Control block */
- LosProcessCB *realParent; /* process real parent */
- LOS_DL_LIST node;
+ UINT32 vid; /* Virtual ID | 虚拟ID*/
+ UINT32 vpid; /* Virtual parent ID | 父进程虚拟ID*/
+ UINTPTR cb; /* Control block | 控制块*/
+ LosProcessCB *realParent; /* process real parent | 进程真实的父进程 */
+ LOS_DL_LIST node;//用于挂入 PidContainer.pidFreeList | tidFreeList
} ProcessVid;
#define PID_CONTAINER_LEVEL_LIMIT 3
-
+//进程容器
typedef struct PidContainer {
- Atomic rc;
- Atomic level;
- Atomic lock;
- BOOL referenced;
- UINT32 containerID;
- struct PidContainer *parent;
- struct ProcessGroup *rootPGroup;
- LOS_DL_LIST tidFreeList;
- ProcessVid tidArray[LOSCFG_BASE_CORE_TSK_LIMIT];
- LOS_DL_LIST pidFreeList;
- ProcessVid pidArray[LOSCFG_BASE_CORE_PROCESS_LIMIT];
+ Atomic rc; //原子操作
+ Atomic level; //等级，0为最高级，父比子高一级
+ Atomic lock; //锁
+ BOOL referenced; //是否被引用
+ UINT32 containerID; //容器ID
+ struct PidContainer *parent; //父进程容器
+ struct ProcessGroup *rootPGroup; //进程组
+ LOS_DL_LIST tidFreeList; //任务空闲链表
+ ProcessVid tidArray[LOSCFG_BASE_CORE_TSK_LIMIT];//虚拟任务池
+ LOS_DL_LIST pidFreeList; //进程空闲链表
+ ProcessVid pidArray[LOSCFG_BASE_CORE_PROCESS_LIMIT];//虚拟进程池
} PidContainer;
#define OS_PID_CONTAINER_FROM_PCB(processCB) ((processCB)->container->pidContainer)
diff --git a/src/kernel_liteos_a/kernel/base/include/los_process_pri.h b/src/kernel_liteos_a/kernel/base/include/los_process_pri.h
index e100438d..a0d9d114 100644
--- a/src/kernel_liteos_a/kernel/base/include/los_process_pri.h
+++ b/src/kernel_liteos_a/kernel/base/include/los_process_pri.h
@@ -1,6 +1,6 @@
/*
* Copyright (c) 2013-2019 Huawei Technologies Co., Ltd. All rights reserved.
- * Copyright (c) 2020-2023 Huawei Device Co., Ltd. All rights reserved.
+ * Copyright (c) 2020-2021 Huawei Device Co., Ltd. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
@@ -65,82 +65,86 @@ extern "C" {
#ifdef LOSCFG_SECURITY_CAPABILITY
#define OS_GROUPS_NUMBER_MAX 256
+/*! 用户描述体*/
typedef struct {
- UINT32 userID;
+ UINT32 userID; ///<用户ID [0,60000],0为root用户
UINT32 effUserID;
- UINT32 gid;
+ UINT32 gid; ///<用户组ID [0,60000],0为root用户组
UINT32 effGid;
- UINT32 groupNumber;
- UINT32 groups[1];
+ UINT32 groupNumber;///< 用户组数量
+ UINT32 groups[1]; //所属用户组列表,一个用户可属多个用户组
} User;
#endif
-
+/*! 进程组结构体*/
typedef struct ProcessGroup {
- UINTPTR pgroupLeader; /**< Process group leader is the the process that created the group */
- LOS_DL_LIST processList; /**< List of processes under this process group */
- LOS_DL_LIST exitProcessList; /**< List of closed processes (zombie processes) under this group */
- LOS_DL_LIST groupList; /**< Process group list */
+ UINTPTR pgroupLeader; /**< Process group leader is the the process that created the group | 负责创建进程组的进程首地址*/
+ LOS_DL_LIST processList; /**< List of processes under this process group | 属于该进程组的进程链表*/
+ LOS_DL_LIST exitProcessList; /**< List of closed processes (zombie processes) under this group | 进程组的僵死进程链表*/
+ LOS_DL_LIST groupList; /**< Process group list | 进程组链表,上面挂的都是进程组*/
} ProcessGroup;
+/**
+ * 进程控制块.
+ */
typedef struct ProcessCB {
- CHAR processName[OS_PCB_NAME_LEN]; /**< Process name */
- UINT32 processID; /**< Process ID */
+ CHAR processName[OS_PCB_NAME_LEN]; /**< Process name | 进程名称 */
+ UINT32 processID; /**< Process ID = leader thread ID | 进程ID,由进程池分配,范围[0,64] */
UINT16 processStatus; /**< [15:4] Process Status; [3:0] The number of threads currently
- running in the process */
- UINT16 consoleID; /**< The console id of task belongs */
- UINT16 processMode; /**< Kernel Mode:0; User Mode:1; */ // 用戶模式1 内核模式0
+ running in the process | 这里设计很巧妙.用一个变量表示了两层逻辑 数量和状态,点赞! @note_good 从这里也可以看出一个进程可以有多个正在运行的任务*/
+ UINT16 consoleID; /**< The console id of task belongs | 任务的控制台id归属 */
+ UINT16 processMode; /**< Kernel Mode:0; User Mode:1; | 模式指定为内核还是用户进程 */
struct ProcessCB *parentProcess; /**< Parent process */
- UINT32 exitCode; /**< Process exit status */
- LOS_DL_LIST pendList; /**< Block list to which the process belongs */
- LOS_DL_LIST childrenList; /**< Children process list */ // 存放子進程,链表
- LOS_DL_LIST exitChildList; /**< Exit children process list */ // 要退出的子进程
- LOS_DL_LIST siblingList; /**< Linkage in parent's children list */ //兄弟进程链表
- ProcessGroup *pgroup; /**< Process group to which a process belongs */ //所属进程组
- LOS_DL_LIST subordinateGroupList; /**< Linkage in group list */ // 进程是组长时有哪些组员进程
- LosTaskCB *threadGroup; // 哪个线程组是进程的主线程ID
- LOS_DL_LIST threadSiblingList; /**< List of threads under this process */ // 进程的线程任务列表
- volatile UINT32 threadNumber; /**< Number of threads alive under this process */ // 此进程下的活动线程数量
- UINT32 threadCount; /**< Total number of threads created under this process */ // 在此进程下创建的线程总数
- LOS_DL_LIST waitList; /**< The process holds the waitLits to support wait/waitpid */ // 进程持有等待链表以支持wait/waitpid
+ UINT32 exitCode; /**< Process exit status | 进程退出状态码*/
+ LOS_DL_LIST pendList; /**< Block list to which the process belongs | 进程所在的阻塞列表,进程因阻塞挂入相应的链表.*/
+ LOS_DL_LIST childrenList; /**< Children process list | 孩子进程都挂到这里,形成双循环链表*/
+ LOS_DL_LIST exitChildList; /**< Exit children process list | 要退出的孩子进程链表，白发人要送黑发人.*/
+ LOS_DL_LIST siblingList; /**< Linkage in parent's children list | 兄弟进程链表, 56个民族是一家,来自同一个父进程.*/
+ ProcessGroup *pgroup; /**< Process group to which a process belongs | 所属进程组*/
+ LOS_DL_LIST subordinateGroupList; /**< Linkage in group list | 进程组员链表*/
+ LosTaskCB *threadGroup;
+ LOS_DL_LIST threadSiblingList; /**< List of threads under this process | 进程的线程(任务)列表 */
+ volatile UINT32 threadNumber; /**< Number of threads alive under this process | 此进程下的活动线程数*/
+ UINT32 threadCount; /**< Total number of threads created under this process | 在此进程下创建的线程总数*/ //
+ LOS_DL_LIST waitList; /**< The process holds the waitLits to support wait/waitpid | 父进程通过进程等待的方式，回收子进程资源，获取子进程退出信息*/
#ifdef LOSCFG_KERNEL_SMP
- UINT32 timerCpu; /**< CPU core number of this task is delayed or pended */ // 统计各个线程被延迟或者阻塞的时间
+ UINT32 timerCpu; /**< CPU core number of this task is delayed or pended | 统计各线程被延期或阻塞的时间*/
#endif
- UINTPTR sigHandler; /**< Signal handler */ // 信号处理函数
- sigset_t sigShare; /**< Signal share bit */ // 信号共享位
+ UINTPTR sigHandler; /**< Signal handler | 信号处理函数,处理如 SIGSYS 等信号*/
+ sigset_t sigShare; /**< Signal share bit | 信号共享位 sigset_t是个64位的变量,对应64种信号*/
#ifdef LOSCFG_KERNEL_LITEIPC
- ProcIpcInfo *ipcInfo; /**< Memory pool for lite ipc */ //用于进程间通讯的虚拟设备文件系统，设备装载点为 /dev/lite_ipc
+ ProcIpcInfo *ipcInfo; /**< Memory pool for lite ipc | 用于进程间通讯的虚拟设备文件系统,设备装载点为 /dev/lite_ipc*/
#endif
#ifdef LOSCFG_KERNEL_VM
- LosVmSpace *vmSpace; /**< VMM space for processes */ //虚拟空间，描述进程虚拟内存的数据结构，linux称为内存描述符
+ LosVmSpace *vmSpace; /**< VMM space for processes | 虚拟空间,描述进程虚拟内存的数据结构，linux称为内存描述符 */
#endif
#ifdef LOSCFG_FS_VFS
- struct files_struct *files; /**< Files held by the process */
-#endif
- timer_t timerID; /**< ITimer */
+ struct files_struct *files; /**< Files held by the process | 进程所持有的所有文件，注者称之为进程的文件管理器*/
+#endif //每个进程都有属于自己的文件管理器,记录对文件的操作. 注意:一个文件可以被多个进程操作
+ timer_t timerID; /**< iTimer */
-#ifdef LOSCFG_SECURITY_CAPABILITY
- User *user; // 进程的拥有者
- UINT32 capability; // 安全能力范围
+#ifdef LOSCFG_SECURITY_CAPABILITY //安全能力
+ User *user; ///< 进程的拥有者
+ UINT32 capability; ///< 安全能力范围 对应 CAP_SETGID
#endif
-#ifdef LOSCFG_SECURITY_VID
- TimerIdMap timerIdMap;
+#ifdef LOSCFG_SECURITY_VID //虚拟ID映射功能
+ TimerIdMap timerIdMap;
#endif
#ifdef LOSCFG_DRIVERS_TZDRIVER
- struct Vnode *execVnode; /**< Exec bin of the process */
+ struct Vnode *execVnode; /**< Exec bin of the process | 进程的可执行文件 */
#endif
- mode_t umask;
+ mode_t umask; ///< umask(user file-creatiopn mode mask)为用户文件创建掩码，是创建文件或文件夹时默认权限的基础。
#ifdef LOSCFG_KERNEL_CPUP
- OsCpupBase *processCpup; /**< Process cpu usage */
+ OsCpupBase *processCpup; /**< Process cpu usage | 进程占用CPU情况统计*/
#endif
- struct rlimit *resourceLimit;
+ struct rlimit *resourceLimit; ///< 每个进程在运行时系统不会无限制的允许单个进程不断的消耗资源，因此都会设置资源限制。
#ifdef LOSCFG_KERNEL_CONTAINER
- Container *container;
+ Container *container; ///< 内核容器
#ifdef LOSCFG_USER_CONTAINER
- struct Credentials *credentials;
+ struct Credentials *credentials; ///< 用户身份证
#endif
#endif
#ifdef LOSCFG_PROC_PROCESS_DIR
- struct ProcDirEntry *procDir;
+ struct ProcDirEntry *procDir; ///< 目录文件项
#endif
#ifdef LOSCFG_KERNEL_PLIMITS
ProcLimiterSet *plimits;
@@ -161,8 +165,8 @@ extern UINT32 g_processMaxNum;
#define OS_PCB_FROM_TCB(taskCB) ((LosProcessCB *)((taskCB)->processCB))
#define OS_PCB_FROM_TID(taskID) ((LosProcessCB *)(OS_TCB_FROM_TID(taskID)->processCB))
#define OS_GET_PGROUP_LEADER(pgroup) ((LosProcessCB *)((pgroup)->pgroupLeader))
-#define OS_PCB_FROM_SIBLIST(ptr) LOS_DL_LIST_ENTRY((ptr), LosProcessCB, siblingList)
-#define OS_PCB_FROM_PENDLIST(ptr) LOS_DL_LIST_ENTRY((ptr), LosProcessCB, pendList)
+#define OS_PCB_FROM_SIBLIST(ptr) LOS_DL_LIST_ENTRY((ptr), LosProcessCB, siblingList)///< 通过siblingList节点找到 LosProcessCB
+#define OS_PCB_FROM_PENDLIST(ptr) LOS_DL_LIST_ENTRY((ptr), LosProcessCB, pendList) ///< 通过pendlist节点找到 LosProcessCB
/**
* @ingroup los_process
@@ -202,7 +206,7 @@ extern UINT32 g_processMaxNum;
*
* The process is run out but the resources occupied by the process are not recovered.
*/
-#define OS_PROCESS_STATUS_ZOMBIES 0x0100U
+#define OS_PROCESS_STATUS_ZOMBIES 0x0100U ///< 进程状态: 僵死
/**
* @ingroup los_process
@@ -211,7 +215,7 @@ extern UINT32 g_processMaxNum;
* The process status equal this is process control block unused,
* coexisting with OS_PROCESS_STATUS_ZOMBIES means that the control block is not recovered.
*/
-#define OS_PROCESS_FLAG_UNUSED 0x0200U
+#define OS_PROCESS_FLAG_UNUSED 0x0200U ///< 进程未使用标签,一般用于进程的初始状态 freelist里面都是这种标签
/**
* @ingroup los_process
@@ -219,7 +223,7 @@ extern UINT32 g_processMaxNum;
*
* The process has been call exit, it only works with multiple cores.
*/
-#define OS_PROCESS_FLAG_EXIT 0x0400U
+#define OS_PROCESS_FLAG_EXIT 0x0400U ///< 进程退出标签,退出的进程进入回收链表等待回收资源
/**
* @ingroup los_process
@@ -227,7 +231,7 @@ extern UINT32 g_processMaxNum;
*
* The process is the leader of the process group.
*/
-#define OS_PROCESS_FLAG_GROUP_LEADER 0x0800U
+#define OS_PROCESS_FLAG_GROUP_LEADER 0x0800U ///< 进程当了进程组领导标签
/**
* @ingroup los_process
@@ -235,21 +239,21 @@ extern UINT32 g_processMaxNum;
*
* The process has performed the exec operation.
*/
-#define OS_PROCESS_FLAG_ALREADY_EXEC 0x1000U
+#define OS_PROCESS_FLAG_ALREADY_EXEC 0x1000U ///< 进程已执行exec操作 load elf时使用
/**
* @ingroup los_process
* Flag that indicates the process or process control block status.
*
* The process is dying or already dying.
- */
-#define OS_PROCESS_STATUS_INACTIVE (OS_PROCESS_FLAG_EXIT | OS_PROCESS_STATUS_ZOMBIES)
+ */ /// 进程不活跃状态定义: 身上贴有退出便签且状态为僵死的进程
+#define OS_PROCESS_STATUS_INACTIVE (OS_PROCESS_FLAG_EXIT | OS_PROCESS_STATUS_ZOMBIES)
/**
* @ingroup los_process
* Used to check if the process control block is unused.
*/
-STATIC INLINE BOOL OsProcessIsUnused(const LosProcessCB *processCB)
+STATIC INLINE BOOL OsProcessIsUnused(const LosProcessCB *processCB)//查下进程是否还在使用?
{
return ((processCB->processStatus & OS_PROCESS_FLAG_UNUSED) != 0);
}
@@ -257,8 +261,8 @@ STATIC INLINE BOOL OsProcessIsUnused(const LosProcessCB *processCB)
/**
* @ingroup los_process
* Used to check if the process is inactive.
- */
-STATIC INLINE BOOL OsProcessIsInactive(const LosProcessCB *processCB)
+ */ /// 进程不活跃函数定义:身上贴有不使用且不活跃标签的进程
+STATIC INLINE BOOL OsProcessIsInactive(const LosProcessCB *processCB)//查下进程是否不活跃?
{
return ((processCB->processStatus & (OS_PROCESS_FLAG_UNUSED | OS_PROCESS_STATUS_INACTIVE)) != 0);
}
@@ -266,8 +270,8 @@ STATIC INLINE BOOL OsProcessIsInactive(const LosProcessCB *processCB)
/**
* @ingroup los_process
* Used to check if the process is dead.
- */
-STATIC INLINE BOOL OsProcessIsDead(const LosProcessCB *processCB)
+ */ /// 进程死啦死啦的定义: 身上贴有不使用且状态为僵死的进程
+STATIC INLINE BOOL OsProcessIsDead(const LosProcessCB *processCB)//查下进程是否死啦死啦滴?
{
return ((processCB->processStatus & OS_PROCESS_STATUS_ZOMBIES) != 0);
}
@@ -282,68 +286,44 @@ STATIC INLINE BOOL OsProcessIsPGroupLeader(const LosProcessCB *processCB)
return ((processCB->processStatus & OS_PROCESS_FLAG_GROUP_LEADER) != 0);
}
-/**
- * @ingroup los_process
- * The highest priority of a kernel mode process.
- */
-#define OS_PROCESS_PRIORITY_HIGHEST 0
-/**
- * @ingroup los_process
- * The lowest priority of a kernel mode process
- */
-#define OS_PROCESS_PRIORITY_LOWEST 31
+#define OS_PROCESS_PRIORITY_HIGHEST 0 ///< 进程最高优先级
-/**
- * @ingroup los_process
- * The highest priority of a user mode process.
- */
-#define OS_USER_PROCESS_PRIORITY_HIGHEST 10
-/**
- * @ingroup los_process
- * The lowest priority of a user mode process
- */
-#define OS_USER_PROCESS_PRIORITY_LOWEST OS_PROCESS_PRIORITY_LOWEST
+#define OS_PROCESS_PRIORITY_LOWEST 31 ///< 进程最低优先级
-/**
- * @ingroup los_process
- * User state root process default priority
- */
-#define OS_PROCESS_USERINIT_PRIORITY 28
-/**
- * @ingroup los_process
- * ID of the kernel idle process
- */
-#define OS_KERNEL_IDLE_PROCESS_ID 0U
+#define OS_USER_PROCESS_PRIORITY_HIGHEST 10 ///< 内核模式和用户模式的优先级分割线 10-31 用户级, 0-9内核级
-/**
- * @ingroup los_process
- * ID of the user root process
- */
-#define OS_USER_ROOT_PROCESS_ID 1U
-/**
- * @ingroup los_process
- * ID of the kernel root process
- */
-#define OS_KERNEL_ROOT_PROCESS_ID 2U
+#define OS_USER_PROCESS_PRIORITY_LOWEST OS_PROCESS_PRIORITY_LOWEST ///< 用户进程的最低优先级
+
+
+#define OS_PROCESS_USERINIT_PRIORITY 28 ///< 用户进程默认的优先级,28级好低啊
+
-#define OS_TASK_DEFAULT_STACK_SIZE 0x2000
-#define OS_USER_TASK_SYSCALL_STACK_SIZE 0x3000
-#define OS_USER_TASK_STACK_SIZE 0x100000
+#define OS_KERNEL_IDLE_PROCESS_ID 0U //0号进程为空闲进程
-#define OS_KERNEL_MODE 0x0U
-#define OS_USER_MODE 0x1U
+
+#define OS_USER_ROOT_PROCESS_ID 1U //1号为用户态根进程
+
+
+#define OS_KERNEL_ROOT_PROCESS_ID 2U //1号为内核态根进程
+#define OS_TASK_DEFAULT_STACK_SIZE 0x2000 ///< task默认栈大小 8K
+#define OS_USER_TASK_SYSCALL_STACK_SIZE 0x3000 ///< 用户通过系统调用的栈大小 12K ,这时是运行在内核模式下
+#define OS_USER_TASK_STACK_SIZE 0x100000 ///< 用户任务运行在用户空间的栈大小 1M
+
+#define OS_KERNEL_MODE 0x0U ///< 内核态
+#define OS_USER_MODE 0x1U ///< 用户态
+/*! 用户态进程*/
STATIC INLINE BOOL OsProcessIsUserMode(const LosProcessCB *processCB)
{
return (processCB->processMode == OS_USER_MODE);
}
-#define LOS_PRIO_PROCESS 0U
-#define LOS_PRIO_PGRP 1U
-#define LOS_PRIO_USER 2U
+#define LOS_PRIO_PROCESS 0U ///< 进程标识
+#define LOS_PRIO_PGRP 1U ///< 进程组标识
+#define LOS_PRIO_USER 2U ///< 用户标识
#define OS_USER_PRIVILEGE_PROCESS_GROUP ((UINTPTR)OsGetUserInitProcess())
#define OS_KERNEL_PROCESS_GROUP ((UINTPTR)OsGetKernelInitProcess())
@@ -353,40 +333,40 @@ STATIC INLINE BOOL OsProcessIsUserMode(const LosProcessCB *processCB)
* 31 15 8 7 0
* | | exit code | core dump | signal |
*/
-#define OS_PRO_EXIT_OK 0
-
+#define OS_PRO_EXIT_OK 0 ///< 进程正常退出
+/// 置进程退出码第七位为1
STATIC INLINE VOID OsProcessExitCodeCoreDumpSet(LosProcessCB *processCB)
{
- processCB->exitCode |= 0x80U;
+ processCB->exitCode |= 0x80U; // 0b10000000
}
-
+/// 设置进程退出信号(0 ~ 7)
STATIC INLINE VOID OsProcessExitCodeSignalSet(LosProcessCB *processCB, UINT32 signal)
{
- processCB->exitCode |= signal & 0x7FU;
+ processCB->exitCode |= signal & 0x7FU;// 0b01111111
}
-
+/// 清除进程退出信号(0 ~ 7)
STATIC INLINE VOID OsProcessExitCodeSignalClear(LosProcessCB *processCB)
{
- processCB->exitCode &= (~0x7FU);
+ processCB->exitCode &= (~0x7FU);// 低7位全部清0
}
-
+/// 进程退出码是否被设置过,默认是 0 ,如果 & 0x7FU 还是 0 ,说明没有被设置过.
STATIC INLINE BOOL OsProcessExitCodeSignalIsSet(LosProcessCB *processCB)
{
return (processCB->exitCode) & 0x7FU;
}
-
+/// 设置进程退出号(8 ~ 15)
STATIC INLINE VOID OsProcessExitCodeSet(LosProcessCB *processCB, UINT32 code)
{
processCB->exitCode |= ((code & 0x000000FFU) << 8U) & 0x0000FF00U; /* 8: Move 8 bits to the left, exitCode */
}
#define OS_PID_CHECK_INVALID(pid) (((UINT32)(pid)) >= g_processMaxNum)
-
+/*! 内联函数 进程ID是否有效 */
STATIC INLINE BOOL OsProcessIDUserCheckInvalid(UINT32 pid)
{
return ((pid >= g_processMaxNum) || (pid == 0));
}
-
+/*! 获取当前进程PCB */
STATIC INLINE LosProcessCB *OsCurrProcessGet(VOID)
{
UINT32 intSave;
@@ -398,6 +378,7 @@ STATIC INLINE LosProcessCB *OsCurrProcessGet(VOID)
}
#ifdef LOSCFG_SECURITY_CAPABILITY
+/*! 获取当前进程的所属用户 */
STATIC INLINE User *OsCurrUserGet(VOID)
{
User *user = NULL;
@@ -469,14 +450,14 @@ STATIC INLINE UINT32 OsGetRootPid(const LosProcessCB *processCB)
/*
* return immediately if no child has exited.
*/
-#define LOS_WAIT_WNOHANG (1 << 0U)
+#define LOS_WAIT_WNOHANG (1 << 0U) ///< 如果没有孩子进程退出，则立即返回,而不是阻塞在这个函数上等待；如果结束了，则返回该子进程的进程号。
/*
* return if a child has stopped (but not traced via ptrace(2)).
* Status for traced children which have stopped is provided even
* if this option is not specified.
*/
-#define LOS_WAIT_WUNTRACED (1 << 1U)
+#define LOS_WAIT_WUNTRACED (1 << 1U) ///< 如果子进程进入暂停情况则马上返回，不予以理会结束状态。untraced
#define LOS_WAIT_WSTOPPED (1 << 1U)
/*
@@ -488,7 +469,7 @@ STATIC INLINE UINT32 OsGetRootPid(const LosProcessCB *processCB)
* return if a stopped child has been resumed by delivery of SIGCONT.
* (For Linux-only options, see below.)
*/
-#define LOS_WAIT_WCONTINUED (1 << 3U)
+#define LOS_WAIT_WCONTINUED (1 << 3U) ///< 可获取子进程恢复执行的状态，也就是可获取continued状态 continued
/*
* Leave the child in a waitable state;
@@ -499,30 +480,30 @@ STATIC INLINE UINT32 OsGetRootPid(const LosProcessCB *processCB)
/*
* Indicates that you are already in a wait state
*/
-#define OS_PROCESS_WAIT (1 << 15U)
+#define OS_PROCESS_WAIT (1 << 15U) ///< 表示已经处于等待状态
/*
* Wait for any child process to finish
*/
-#define OS_PROCESS_WAIT_ANY OS_TASK_WAIT_ANYPROCESS
+#define OS_PROCESS_WAIT_ANY OS_TASK_WAIT_ANYPROCESS ///< 等待任意子进程完成
/*
* Wait for the child process specified by the pid to finish
*/
-#define OS_PROCESS_WAIT_PRO OS_TASK_WAIT_PROCESS
+#define OS_PROCESS_WAIT_PRO OS_TASK_WAIT_PROCESS ///< 等待pid指定的子进程完成
/*
* Waits for any child process in the specified process group to finish.
*/
-#define OS_PROCESS_WAIT_GID OS_TASK_WAIT_GID
+#define OS_PROCESS_WAIT_GID OS_TASK_WAIT_GID ///< 等待指定进程组中的任意子进程完成
#define OS_PROCESS_INFO_ALL 1
-#define OS_PROCESS_DEFAULT_UMASK 0022
-
-extern UINTPTR __user_init_entry;
-extern UINTPTR __user_init_bss;
-extern UINTPTR __user_init_end;
-extern UINTPTR __user_init_load_addr;
+#define OS_PROCESS_DEFAULT_UMASK 0022 ///< 系统默认的用户掩码(umask),大多数的Linux系统的默认掩码为022。
+//用户掩码的作用是用户在创建文件时从文件的默认权限中去除掩码中的权限。所以文件创建之后的权限实际为:创建文件的权限为：0666-0022=0644。创建文件夹的权限为：0777-0022=0755
+extern UINTPTR __user_init_entry; ///< 第一个用户态进程(init)的入口地址 查看 LITE_USER_SEC_ENTRY
+extern UINTPTR __user_init_bss; ///< 查看 LITE_USER_SEC_BSS ,赋值由liteos.ld完成
+extern UINTPTR __user_init_end; ///< init 进程的用户空间初始化结束地址
+extern UINTPTR __user_init_load_addr;///< init 进程的加载地址 ,由链接器赋值
extern UINT32 OsProcessInit(VOID);
extern UINT32 OsSystemProcessCreate(VOID);
extern VOID OsProcessNaturalExit(LosProcessCB *processCB, UINT32 status);