los_process.c 文件参考

进程模块主文件 更多...

浏览源代码.

函数
STATIC INLINE VOID	OsInsertPCBToFreeList (LosProcessCB *processCB)
	将进程插入到空闲链表中 更多...
VOID	OsDeleteTaskFromProcess (LosTaskCB *taskCB)
UINT32	OsProcessAddNewTask (UINT32 pid, LosTaskCB *taskCB, SchedParam *param)
STATIC ProcessGroup *	OsCreateProcessGroup (UINT32 pid)
	创建进程组 更多...
STATIC VOID	OsExitProcessGroup (LosProcessCB *processCB, ProcessGroup **group)
STATIC ProcessGroup *	OsFindProcessGroup (UINT32 gid)
STATIC INT32	OsSendSignalToSpecifyProcessGroup (ProcessGroup *group, siginfo_t *info, INT32 permission)
LITE_OS_SEC_TEXT INT32	OsSendSignalToAllProcess (siginfo_t *info, INT32 permission)
LITE_OS_SEC_TEXT INT32	OsSendSignalToProcessGroup (INT32 pid, siginfo_t *info, INT32 permission)
STATIC LosProcessCB *	OsFindGroupExitProcess (ProcessGroup *group, INT32 pid)
STATIC UINT32	OsFindChildProcess (const LosProcessCB *processCB, INT32 childPid)
STATIC LosProcessCB *	OsFindExitChildProcess (const LosProcessCB *processCB, INT32 childPid)
VOID	OsWaitWakeTask (LosTaskCB *taskCB, UINT32 wakePID)
STATIC BOOL	OsWaitWakeSpecifiedProcess (LOS_DL_LIST *head, const LosProcessCB *processCB, LOS_DL_LIST **anyList)
STATIC VOID	OsWaitCheckAndWakeParentProcess (LosProcessCB *parentCB, const LosProcessCB *processCB)
LITE_OS_SEC_TEXT VOID	OsProcessResourcesToFree (LosProcessCB *processCB)
LITE_OS_SEC_TEXT STATIC VOID	OsRecycleZombiesProcess (LosProcessCB *childCB, ProcessGroup **group)
STATIC VOID	OsDealAliveChildProcess (LosProcessCB *processCB)
STATIC VOID	OsChildProcessResourcesFree (const LosProcessCB *processCB)
VOID	OsProcessNaturalExit (LosProcessCB *processCB, UINT32 status)
STATIC UINT32	OsProcessInit (VOID)
LITE_OS_SEC_TEXT VOID	OsProcessCBRecycleToFree (VOID)
STATIC VOID	OsDeInitPCB (LosProcessCB *processCB)
UINT32	OsSetProcessName (LosProcessCB *processCB, const CHAR *name)
STATIC UINT32	OsInitPCB (LosProcessCB *processCB, UINT32 mode, const CHAR *name)
STATIC User *	OsCreateUser (UINT32 userID, UINT32 gid, UINT32 size)
LITE_OS_SEC_TEXT BOOL	LOS_CheckInGroups (UINT32 gid)
LITE_OS_SEC_TEXT INT32	LOS_GetUserID (VOID)
LITE_OS_SEC_TEXT INT32	LOS_GetGroupID (VOID)
STATIC UINT32	OsProcessCreateInit (LosProcessCB *processCB, UINT32 flags, const CHAR *name)
LITE_OS_SEC_TEXT_INIT UINT32	OsSystemProcessCreate (VOID)
STATIC INLINE INT32	OsProcessSchedlerParamCheck (INT32 which, INT32 pid, UINT16 prio, UINT16 policy)
	进程调度参数检查 更多...
STATIC BOOL	OsProcessCapPermitCheck (const LosProcessCB *processCB, const SchedParam *param, UINT16 prio)
LITE_OS_SEC_TEXT INT32	OsSetProcessScheduler (INT32 which, INT32 pid, UINT16 prio, UINT16 policy)
	设置进程调度计划 更多...
LITE_OS_SEC_TEXT INT32	LOS_SetProcessScheduler (INT32 pid, UINT16 policy, UINT16 prio)
	设置指定进程的调度参数，包括优先级和调度策略 更多...
LITE_OS_SEC_TEXT INT32	LOS_GetProcessScheduler (INT32 pid)
	获得指定进程的调度策略 更多...
LITE_OS_SEC_TEXT INT32	LOS_SetProcessPriority (INT32 pid, UINT16 prio)
	接口封装 - 设置进程优先级 更多...
LITE_OS_SEC_TEXT INT32	OsGetProcessPriority (INT32 which, INT32 pid)
	接口封装 - 获取进程优先级 which:标识进程,进程组,用户 更多...
LITE_OS_SEC_TEXT INT32	LOS_GetProcessPriority (INT32 pid)
	接口封装 - 获取指定进程优先级 更多...
STATIC VOID	OsWaitInsertWaitListInOrder (LosTaskCB *runTask, LosProcessCB *processCB)
STATIC UINT32	OsWaitSetFlag (const LosProcessCB *processCB, INT32 pid, LosProcessCB **child)
	设置等待子进程退出方式方法 更多...
STATIC UINT32	OsWaitRecycleChildProcess (const LosProcessCB *childCB, UINT32 intSave, INT32 *status, siginfo_t *info)
	等待回收孩子进程 @note_thinking 这样写Porcess不太好吧 更多...
STATIC UINT32	OsWaitChildProcessCheck (LosProcessCB *processCB, INT32 pid, LosProcessCB **childCB)
	检查要等待的孩子进程 更多...
STATIC UINT32	OsWaitOptionsCheck (UINT32 options)
STATIC INT32	OsWait (INT32 pid, USER INT32 *status, USER siginfo_t *info, UINT32 options, VOID *rusage)
	等待子进程结束并回收子进程,返回已经终止的子进程的进程ID号，并清除僵死进程。 更多...
LITE_OS_SEC_TEXT INT32	LOS_Wait (INT32 pid, USER INT32 *status, UINT32 options, VOID *rusage)
STATIC UINT32	OsWaitidOptionsCheck (UINT32 options)
LITE_OS_SEC_TEXT INT32	LOS_Waitid (INT32 pid, USER siginfo_t *info, UINT32 options, VOID *rusage)
STATIC UINT32	OsSetProcessGroupCheck (const LosProcessCB *processCB, UINT32 gid)
	设置进程组检查 更多...
STATIC UINT32	OsSetProcessGroupIDUnsafe (UINT32 pid, UINT32 gid, ProcessGroup **group)
LITE_OS_SEC_TEXT INT32	OsSetProcessGroupID (UINT32 pid, UINT32 gid)
LITE_OS_SEC_TEXT INT32	OsSetCurrProcessGroupID (UINT32 gid)
LITE_OS_SEC_TEXT INT32	LOS_GetProcessGroupID (UINT32 pid)
LITE_OS_SEC_TEXT INT32	LOS_GetCurrProcessGroupID (VOID)
	获取当前进程的组ID 更多...
STATIC LosProcessCB *	OsGetFreePCB (VOID)
	为用户态任务分配栈空间 更多...
STATIC VOID *	OsUserInitStackAlloc (LosProcessCB *processCB, UINT32 *size)
LITE_OS_SEC_TEXT VOID	OsExecProcessVmSpaceRestore (LosVmSpace *oldSpace)
LITE_OS_SEC_TEXT LosVmSpace *	OsExecProcessVmSpaceReplace (LosVmSpace *newSpace, UINTPTR stackBase, INT32 randomDevFD)
LITE_OS_SEC_TEXT UINT32	OsExecRecycleAndInit (LosProcessCB *processCB, const CHAR *name, LosVmSpace *oldSpace, UINTPTR oldFiles)
	进程的回收再利用,被LOS_DoExecveFile调用 更多...
LITE_OS_SEC_TEXT UINT32	OsExecStart (const TSK_ENTRY_FUNC entry, UINTPTR sp, UINTPTR mapBase, UINT32 mapSize)
	执行用户态任务, entry为入口函数 ,其中 创建好task,task上下文 等待调度真正执行, sp:栈指针 mapBase:栈底 mapSize:栈大小 更多...
STATIC UINT32	OsUserInitProcessStart (LosProcessCB *processCB, TSK_INIT_PARAM_S *param)
	用户进程开始初始化 更多...
STATIC UINT32	OsLoadUserInit (LosProcessCB *processCB)
LITE_OS_SEC_TEXT_INIT UINT32	OsUserInitProcess (VOID)
STATIC UINT32	OsCopyUser (LosProcessCB *childCB, LosProcessCB *parentCB)
	拷贝用户信息 直接用memcpy_s 更多...
STATIC UINT32	OsCopyTask (UINT32 flags, LosProcessCB *childProcessCB, const CHAR *name, UINTPTR entry, UINT32 size)
STATIC UINT32	OsCopyParent (UINT32 flags, LosProcessCB *childProcessCB, LosProcessCB *runProcessCB)
STATIC UINT32	OsCopyMM (UINT32 flags, LosProcessCB *childProcessCB, LosProcessCB *runProcessCB)
STATIC UINT32	OsCopyFile (UINT32 flags, LosProcessCB *childProcessCB, LosProcessCB *runProcessCB)
	拷贝进程文件描述符(proc_fd)信息 更多...
STATIC UINT32	OsForkInitPCB (UINT32 flags, LosProcessCB *child, const CHAR *name, UINTPTR sp, UINT32 size)
STATIC UINT32	OsChildSetProcessGroupAndSched (LosProcessCB *child, LosProcessCB *run)
STATIC UINT32	OsCopyProcessResources (UINT32 flags, LosProcessCB *child, LosProcessCB *run)
	拷贝进程资源 更多...
STATIC INT32	OsCopyProcess (UINT32 flags, const CHAR *name, UINTPTR sp, UINT32 size)
	拷贝进程 更多...
LITE_OS_SEC_TEXT INT32	OsClone (UINT32 flags, UINTPTR sp, UINT32 size)
	OsClone 进程克隆 更多...
LITE_OS_SEC_TEXT INT32	LOS_Fork (UINT32 flags, const CHAR *name, const TSK_ENTRY_FUNC entry, UINT32 stackSize)
LITE_OS_SEC_TEXT VOID	LOS_Exit (INT32 status)
	LOS_Exit 进程退出 更多...
LITE_OS_SEC_TEXT INT32	LOS_GetUsedPIDList (UINT32 *pidList, INT32 pidMaxNum)
	LOS_GetUsedPIDList 获取使用中的进程列表 更多...
LITE_OS_SEC_TEXT struct fd_table_s *	LOS_GetFdTable (UINT32 pid)
LITE_OS_SEC_TEXT UINT32	LOS_GetCurrProcessID (VOID)
	获取当前进程的进程ID 更多...
STATIC VOID	ThreadGroupActiveTaskKilled (LosTaskCB *taskCB)
	按指定状态退出指定进程 更多...
LITE_OS_SEC_TEXT VOID	OsProcessThreadGroupDestroy (VOID)
LITE_OS_SEC_TEXT UINT32	LOS_GetSystemProcessMaximum (VOID)
	获取系统支持的最大进程数目 更多...
LITE_OS_SEC_TEXT UINT32	OsGetUserInitProcessID (VOID)
	获取用户态进程的根进程,所有用户进程都是g_processCBArray[g_userInitProcess] fork来的 更多...
LITE_OS_SEC_TEXT UINT32	OsGetKernelInitProcessID (VOID)
	获取内核态根进程 更多...
LITE_OS_SEC_TEXT UINT32	OsGetIdleProcessID (VOID)
	获取内核态空闲进程 更多...
LITE_OS_SEC_TEXT VOID	OsSetSigHandler (UINTPTR addr)
	设置进程的信号处理函数 更多...
LITE_OS_SEC_TEXT UINTPTR	OsGetSigHandler (VOID)
	获取进程的信号处理函数 更多...

变量
LITE_OS_SEC_BSS LosProcessCB *	g_processCBArray = NULL
	进程池数组 更多...
LITE_OS_SEC_DATA_INIT STATIC LOS_DL_LIST	g_freeProcess
	空闲状态下的进程链表, .个人觉得应该取名为 g_freeProcessList @note_thinking 更多...
LITE_OS_SEC_DATA_INIT STATIC LOS_DL_LIST	g_processRecycleList
	需要回收的进程列表 更多...
LITE_OS_SEC_BSS UINT32	g_userInitProcess = OS_INVALID_VALUE
	1号进程 用户态的初始init进程,用户态下其他进程由它 fork 更多...
LITE_OS_SEC_BSS UINT32	g_kernelInitProcess = OS_INVALID_VALUE
	2号进程 内核态初始Kprocess进程,内核态下其他进程由它 fork 更多...
LITE_OS_SEC_BSS UINT32	g_kernelIdleProcess = OS_INVALID_VALUE
	0号进程 内核态idle进程,由Kprocess fork 更多...
LITE_OS_SEC_BSS UINT32	g_processMaxNum
	进程最大数量,默认64个 更多...
LITE_OS_SEC_BSS ProcessGroup *	g_processGroup = NULL
	全局进程组,负责管理所有进程组 更多...

详细描述

进程模块主文件

并发（Concurrent）:多个线程在单个核心运行，同一时间只能一个线程运行，内核不停切换线程，
      看起来像同时运行，实际上是线程不停切换
并行（Parallel）每个线程分配给独立的CPU核心，线程同时运行
单核CPU多个进程或多个线程内能实现并发（微观上的串行，宏观上的并行）
多核CPU线程间可以实现宏观和微观上的并行
LITE_OS_SEC_BSS 和 LITE_OS_SEC_DATA_INIT 是告诉编译器这些全局变量放在哪个数据段

版本

作者

weharmonyos.com | 鸿蒙研究站 | 每天死磕一点点

日期

2021-12-15

在文件 los_process.c 中定义.

函数说明

LOS_CheckInGroups()

LITE_OS_SEC_TEXT BOOL LOS_CheckInGroups

(

UINT32

gid

)

检查参数群组ID是否在当前用户所属群组中

在文件 los_process.c 第 805 行定义.

{
    UINT32 intSave;
    UINT32 count;
    User *user = NULL;
 
    SCHEDULER_LOCK(intSave);
    user = OsCurrUserGet();//当前进程所属用户
    for (count = 0; count < user->groupNumber; count++) {//循环对比
        if (user->groups[count] == gid) {
            SCHEDULER_UNLOCK(intSave);
            return TRUE;
        }
    }
 
    SCHEDULER_UNLOCK(intSave);
    return FALSE;
}

函数调用图:

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

LOS_Exit()

LITE_OS_SEC_TEXT VOID LOS_Exit

(

INT32

status

)

LOS_Exit 进程退出

参数

status

返回

参见

在文件 los_process.c 第 2086 行定义.

{
    UINT32 intSave;
 
    (void)status;
    /* The exit of a kernel - state process must be kernel - state and all threads must actively exit */
    LosProcessCB *processCB = OsCurrProcessGet();
    SCHEDULER_LOCK(intSave);
    if (!OsProcessIsUserMode(processCB) && (processCB->threadNumber != 1)) {//内核态下进程的退出方式,必须是所有的任务都退出了
        SCHEDULER_UNLOCK(intSave);
        PRINT_ERR("Kernel-state processes with multiple threads are not allowed to exit directly\n");
        return;
    }
    SCHEDULER_UNLOCK(intSave);
 
    OsProcessThreadGroupDestroy();
    OsRunningTaskToExit(OsCurrTaskGet(), OS_PRO_EXIT_OK);
}

函数调用图:

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

LOS_Fork()

LITE_OS_SEC_TEXT INT32 LOS_Fork	(	UINT32	flags,
		const CHAR *	name,
		const TSK_ENTRY_FUNC	entry,
		UINT32	stackSize
	)

在文件 los_process.c 第 2060 行定义.

{
    UINT32 cloneFlag = CLONE_PARENT | CLONE_THREAD | CLONE_VFORK | CLONE_FILES;
 
    if (flags & (~cloneFlag)) {
        PRINT_WARN("Clone dont support some flags!\n");
    }
 
    flags |= CLONE_FILES;
    return OsCopyProcess(cloneFlag & flags, name, (UINTPTR)entry, stackSize);//拷贝一个进程
}

函数调用图:

LOS_GetCurrProcessGroupID()

LITE_OS_SEC_TEXT INT32 LOS_GetCurrProcessGroupID

(

VOID

)

获取当前进程的组ID

在文件 los_process.c 第 1485 行定义.

{
    return LOS_GetProcessGroupID(OsCurrProcessGet()->processID);
}

函数调用图:

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

LOS_GetCurrProcessID()

LITE_OS_SEC_TEXT UINT32 LOS_GetCurrProcessID

(

VOID

)

获取当前进程的进程ID

在文件 los_process.c 第 2161 行定义.

{
    return OsCurrProcessGet()->processID;
}

函数调用图:

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

LOS_GetFdTable()

LITE_OS_SEC_TEXT struct fd_table_s * LOS_GetFdTable

(

UINT32

pid

)

在文件 los_process.c 第 2143 行定义.

{
    LosProcessCB *pcb = NULL;
    struct files_struct *files = NULL;
 
    if (OS_PID_CHECK_INVALID(pid)) {
        return NULL;
    }
    pcb = OS_PCB_FROM_PID(pid);
    files = pcb->files;
    if (files == NULL) {
        return NULL;
    }
 
    return files->fdt;
}

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

LOS_GetGroupID()

LITE_OS_SEC_TEXT INT32 LOS_GetGroupID

(

VOID

)

获取当前进程的用户组ID

在文件 los_process.c 第 842 行定义.

{
#ifdef LOSCFG_SECURITY_CAPABILITY
    UINT32 intSave;
    INT32 gid;
 
    SCHEDULER_LOCK(intSave);
    gid = (INT32)OsCurrUserGet()->gid;
    SCHEDULER_UNLOCK(intSave);
 
    return gid;
#else
    return 0;
#endif
}

函数调用图:

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

LOS_GetProcessGroupID()

LITE_OS_SEC_TEXT INT32 LOS_GetProcessGroupID

(

UINT32

pid

)

在文件 los_process.c 第 1461 行定义.

{
    INT32 gid;
    UINT32 intSave;
    LosProcessCB *processCB = NULL;
 
    if (OS_PID_CHECK_INVALID(pid)) {
        return -LOS_EINVAL;
    }
 
    SCHEDULER_LOCK(intSave);
    processCB = OS_PCB_FROM_PID(pid);
    if (OsProcessIsUnused(processCB)) {
        gid = -LOS_ESRCH;
        goto EXIT;
    }
 
    gid = (INT32)processCB->group->groupID;
 
EXIT:
    SCHEDULER_UNLOCK(intSave);
    return gid;
}

函数调用图:

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

LOS_GetProcessPriority()

LITE_OS_SEC_TEXT INT32 LOS_GetProcessPriority

(

INT32

pid

)

接口封装 - 获取指定进程优先级

在文件 los_process.c 第 1083 行定义.

{
    return OsGetProcessPriority(LOS_PRIO_PROCESS, pid);
}

函数调用图:

LOS_GetProcessScheduler()

LITE_OS_SEC_TEXT INT32 LOS_GetProcessScheduler

(

INT32

pid

)

获得指定进程的调度策略

在文件 los_process.c 第 1030 行定义.

{
    UINT32 intSave;
 
    if (OS_PID_CHECK_INVALID(pid)) {
        return -LOS_EINVAL;
    }
 
    SCHEDULER_LOCK(intSave);
    LosProcessCB *processCB = OS_PCB_FROM_PID(pid);
    if (OsProcessIsUnused(processCB)) {
        SCHEDULER_UNLOCK(intSave);
        return -LOS_ESRCH;
    }
 
    SCHEDULER_UNLOCK(intSave);
 
    return LOS_SCHED_RR;
}

函数调用图:

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

LOS_GetSystemProcessMaximum()

LITE_OS_SEC_TEXT UINT32 LOS_GetSystemProcessMaximum

(

VOID

)

获取系统支持的最大进程数目

在文件 los_process.c 第 2239 行定义.

{
    return g_processMaxNum;
}

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

LOS_GetUsedPIDList()

LITE_OS_SEC_TEXT INT32 LOS_GetUsedPIDList	(	UINT32 *	pidList,
		INT32	pidMaxNum
	)

LOS_GetUsedPIDList
获取使用中的进程列表

参数

pidList
pidMaxNum

返回

参见

在文件 los_process.c 第 2115 行定义.

{
    LosProcessCB *pcb = NULL;
    INT32 num = 0;
    UINT32 intSave;
    UINT32 pid = 1;
 
    if (pidList == NULL) {
        return 0;
    }
    SCHEDULER_LOCK(intSave);
    while (OsProcessIDUserCheckInvalid(pid) == false) {//遍历进程池
        pcb = OS_PCB_FROM_PID(pid);
        pid++;
        if (OsProcessIsUnused(pcb)) {//未使用的不算
            continue;
        }
        pidList[num] = pcb->processID;//由参数带走
        num++;
        if (num >= pidMaxNum) {
            break;
        }
    }
    SCHEDULER_UNLOCK(intSave);
    return num;
}

函数调用图:

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

LOS_GetUserID()

LITE_OS_SEC_TEXT INT32 LOS_GetUserID

(

VOID

)

获取当前进程的用户ID

在文件 los_process.c 第 826 行定义.

{
#ifdef LOSCFG_SECURITY_CAPABILITY
    UINT32 intSave;
    INT32 uid;
 
    SCHEDULER_LOCK(intSave);
    uid = (INT32)OsCurrUserGet()->userID;
    SCHEDULER_UNLOCK(intSave);
    return uid;
#else
    return 0;
#endif
}

函数调用图:

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

LOS_SetProcessPriority()

LITE_OS_SEC_TEXT INT32 LOS_SetProcessPriority	(	INT32	pid,
		UINT16	prio
	)

接口封装 - 设置进程优先级

在文件 los_process.c 第 1050 行定义.

{
    return OsSetProcessScheduler(LOS_PRIO_PROCESS, pid, prio, LOS_GetProcessScheduler(pid));
}

函数调用图:

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

LOS_SetProcessScheduler()

LITE_OS_SEC_TEXT INT32 LOS_SetProcessScheduler	(	INT32	pid,
		UINT16	policy,
		UINT16	prio
	)

设置指定进程的调度参数，包括优先级和调度策略

在文件 los_process.c 第 1025 行定义.

{
    return OsSetProcessScheduler(LOS_PRIO_PROCESS, pid, prio, policy);
}

函数调用图:

LOS_Wait()

LITE_OS_SEC_TEXT INT32 LOS_Wait	(	INT32	pid,
		USER INT32 *	status,
		UINT32	options,
		VOID *	rusage
	)

在文件 los_process.c 第 1313 行定义.

{
    (VOID)rusage;
    UINT32 ret;
 
    ret = OsWaitOptionsCheck(options);
    if (ret != LOS_OK) {
        return -ret;
    }
 
    return OsWait(pid, status, NULL, options, NULL);
}

函数调用图:

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

LOS_Waitid()

LITE_OS_SEC_TEXT INT32 LOS_Waitid	(	INT32	pid,
		USER siginfo_t *	info,
		UINT32	options,
		VOID *	rusage
	)

在文件 los_process.c 第 1350 行定义.

{
    (VOID)rusage;
    UINT32 ret;
 
    /* check options value */
    ret = OsWaitidOptionsCheck(options);
    if (ret != LOS_OK) {
        return -ret;
    }
 
    return OsWait(pid, NULL, info, options, NULL);
}

函数调用图:

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

OsChildProcessResourcesFree()

STATIC VOID OsChildProcessResourcesFree

(

const LosProcessCB *

processCB

)

回收指定进程的已经退出(死亡)的孩子进程所占资源

在文件 los_process.c 第 537 行定义.

{
    LosProcessCB *childCB = NULL;
    ProcessGroup *group = NULL;
 
    while (!LOS_ListEmpty(&((LosProcessCB *)processCB)->exitChildList)) {//遍历直到没有了退出(死亡)的孩子进程
        childCB = LOS_DL_LIST_ENTRY(processCB->exitChildList.pstNext, LosProcessCB, siblingList);//获取孩子进程,
        OsRecycleZombiesProcess(childCB, &group);//其中会将childCB从exitChildList链表上摘出去
        (VOID)LOS_MemFree(m_aucSysMem1, group);//
    }
}

函数调用图:

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

OsChildSetProcessGroupAndSched()

STATIC UINT32 OsChildSetProcessGroupAndSched	(	LosProcessCB *	child,
		LosProcessCB *	run
	)

在文件 los_process.c 第 1945 行定义.

{
    UINT32 intSave;
    UINT32 ret;
    ProcessGroup *group = NULL;
 
    LosTaskCB *taskCB = OS_TCB_FROM_TID(child->threadGroupID);
    SCHEDULER_LOCK(intSave);
    if (run->group->groupID == OS_USER_PRIVILEGE_PROCESS_GROUP) {//如果是有用户特权进程组
        ret = OsSetProcessGroupIDUnsafe(child->processID, child->processID, &group);//设置组ID,存在不安全的风险
        if (ret != LOS_OK) {
            SCHEDULER_UNLOCK(intSave);
            return LOS_ENOMEM;
        }
    }
 
    child->processStatus &= ~OS_PROCESS_STATUS_INIT;
    taskCB->ops->enqueue(OsSchedRunqueue(), taskCB);
    SCHEDULER_UNLOCK(intSave);
 
    (VOID)LOS_MemFree(m_aucSysMem1, group);
    return LOS_OK;
}

函数调用图:

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

OsClone()

LITE_OS_SEC_TEXT INT32 OsClone	(	UINT32	flags,
		UINTPTR	sp,
		UINT32	size
	)

OsClone 进程克隆

参数

flags
size	进程主任务内核栈大小
sp	进程主任务的入口函数

返回

参见

在文件 los_process.c 第 2049 行定义.

{
    UINT32 cloneFlag = CLONE_PARENT | CLONE_THREAD | CLONE_VFORK | CLONE_VM;
 
    if (flags & (~cloneFlag)) {
        PRINT_WARN("Clone dont support some flags!\n");
    }
 
    return OsCopyProcess(cloneFlag & flags, NULL, sp, size);
}

函数调用图:

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

OsCopyFile()

STATIC UINT32 OsCopyFile	(	UINT32	flags,
		LosProcessCB *	childProcessCB,
		LosProcessCB *	runProcessCB
	)

拷贝进程文件描述符(proc_fd)信息

在文件 los_process.c 第 1909 行定义.

{
#ifdef LOSCFG_FS_VFS
    if (flags & CLONE_FILES) {
        childProcessCB->files = runProcessCB->files;
    } else {
        childProcessCB->files = dup_fd(runProcessCB->files);
    }
    if (childProcessCB->files == NULL) {
        return LOS_ENOMEM;
    }
#endif
 
    childProcessCB->consoleID = runProcessCB->consoleID;//控制台也是文件
    childProcessCB->umask = runProcessCB->umask;
    return LOS_OK;
}

函数调用图:

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

OsCopyMM()

STATIC UINT32 OsCopyMM	(	UINT32	flags,
		LosProcessCB *	childProcessCB,
		LosProcessCB *	runProcessCB
	)

在文件 los_process.c 第 1885 行定义.

{
    status_t status;
    UINT32 intSave;
 
    if (!OsProcessIsUserMode(childProcessCB)) {//不是用户模式，直接返回，什么意思？内核虚拟空间只有一个，无需COPY ！！！
        return LOS_OK;
    }
 
    if (flags & CLONE_VM) {//贴有虚拟内存的标签
        SCHEDULER_LOCK(intSave);
        childProcessCB->vmSpace->archMmu.virtTtb = runProcessCB->vmSpace->archMmu.virtTtb;//TTB虚拟地址基地址,即L1表存放位置,virtTtb是个指针,进程的虚拟空间是指定的范围的
        childProcessCB->vmSpace->archMmu.physTtb = runProcessCB->vmSpace->archMmu.physTtb;//TTB物理地址基地址,physTtb是个值,取决于运行时映射到物理内存的具体哪个位置.
        SCHEDULER_UNLOCK(intSave);
        return LOS_OK;
    }
 
    status = LOS_VmSpaceClone(runProcessCB->vmSpace, childProcessCB->vmSpace);//虚拟空间clone
    if (status != LOS_OK) {
        return LOS_ENOMEM;
    }
    return LOS_OK;
}

函数调用图:

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

OsCopyParent()

STATIC UINT32 OsCopyParent	(	UINT32	flags,
		LosProcessCB *	childProcessCB,
		LosProcessCB *	runProcessCB
	)

在文件 los_process.c 第 1861 行定义.

{
    UINT32 ret;
    UINT32 intSave;
    LosProcessCB *parentProcessCB = NULL;
 
    SCHEDULER_LOCK(intSave);
 
    if (flags & CLONE_PARENT) { //这里指明 childProcessCB 和 runProcessCB 有同一个父亲，是兄弟关系
        parentProcessCB = OS_PCB_FROM_PID(runProcessCB->parentProcessID);//找出当前进程的父亲大人
    } else {
        parentProcessCB = runProcessCB;         
    }
        childProcessCB->parentProcessID = parentProcessCB->processID;//指认父亲，这个赋值代表从此是你儿了
        LOS_ListTailInsert(&parentProcessCB->childrenList, &childProcessCB->siblingList);//通过我的兄弟姐妹节点，挂到父亲的孩子链表上，于我而言，父亲的这个链表上挂的都是我的兄弟姐妹
                                                            //不会被排序，老大，老二，老三 老天爷指定了。
        childProcessCB->group = parentProcessCB->group;//跟父亲大人在同一个进程组，注意父亲可能是组长，但更可能不是组长，
        LOS_ListTailInsert(&parentProcessCB->group->processList, &childProcessCB->subordinateGroupList);//自己去组里登记下，这个要自己登记，跟父亲没啥关系。
        ret = OsCopyUser(childProcessCB, parentProcessCB);
 
    SCHEDULER_UNLOCK(intSave);
    return ret;
}

函数调用图:

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

OsCopyProcess()

STATIC INT32 OsCopyProcess	(	UINT32	flags,
		const CHAR *	name,
		UINTPTR	sp,
		UINT32	size
	)

拷贝进程

在文件 los_process.c 第 1999 行定义.

{
    UINT32 ret, processID;
    LosProcessCB *run = OsCurrProcessGet();//获取当前进程
 
    LosProcessCB *child = OsGetFreePCB();//从进程池中申请一个进程控制块，鸿蒙进程池默认64
    if (child == NULL) {
        return -LOS_EAGAIN;
    }
    processID = child->processID;
 
    ret = OsForkInitPCB(flags, child, name, sp, size);//初始化进程控制块
    if (ret != LOS_OK) {
        goto ERROR_INIT;
    }
 
    ret = OsCopyProcessResources(flags, child, run);//拷贝进程的资源,包括虚拟空间,文件,安全,IPC ==
    if (ret != LOS_OK) {
        goto ERROR_TASK;
    }
 
    ret = OsChildSetProcessGroupAndSched(child, run);//设置进程组和加入进程调度就绪队列
    if (ret != LOS_OK) {
        goto ERROR_TASK;
    }
 
    LOS_MpSchedule(OS_MP_CPU_ALL);//给各CPU发送准备接受调度信号
    if (OS_SCHEDULER_ACTIVE) {//当前CPU core处于活动状态
        LOS_Schedule();// 申请调度
    }
 
    return processID;
 
ERROR_TASK:
    (VOID)LOS_TaskDelete(child->threadGroupID);
ERROR_INIT:
    OsDeInitPCB(child);
    return -ret;
}

函数调用图:

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

OsCopyProcessResources()

STATIC UINT32 OsCopyProcessResources	(	UINT32	flags,
		LosProcessCB *	child,
		LosProcessCB *	run
	)

拷贝进程资源

在文件 los_process.c 第 1969 行定义.

{
    UINT32 ret;
 
    ret = OsCopyMM(flags, child, run);//拷贝虚拟空间
    if (ret != LOS_OK) {
        return ret;
    }
 
    ret = OsCopyFile(flags, child, run);//拷贝文件信息
    if (ret != LOS_OK) {
        return ret;
    }
 
#ifdef LOSCFG_KERNEL_LITEIPC
    if (run->ipcInfo != NULL) { //重新初始化IPC池
        child->ipcInfo = LiteIpcPoolReInit((const ProcIpcInfo *)(run->ipcInfo));//@note_good 将沿用用户态空间地址(即线性区地址)
        if (child->ipcInfo == NULL) {//因为整个进程虚拟空间都是拷贝的,ipc的用户态虚拟地址当然可以拷贝,但因进程不同了,所以需要重新申请ipc池和重新
            return LOS_ENOMEM;//映射池中两个地址.
        }
    }
#endif
 
#ifdef LOSCFG_SECURITY_CAPABILITY
    OsCopyCapability(run, child);//拷贝安全能力
#endif
 
    return LOS_OK;
}

函数调用图:

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

OsCopyTask()

STATIC UINT32 OsCopyTask	(	UINT32	flags,
		LosProcessCB *	childProcessCB,
		const CHAR *	name,
		UINTPTR	entry,
		UINT32	size
	)

在文件 los_process.c 第 1803 行定义.

{
    LosTaskCB *runTask = OsCurrTaskGet();
    TSK_INIT_PARAM_S taskParam = { 0 };
    UINT32 ret, taskID, intSave;
    SchedParam param = { 0 };
 
    SCHEDULER_LOCK(intSave);
    if (OsProcessIsUserMode(childProcessCB)) {//用户态进程
        taskParam.pfnTaskEntry = runTask->taskEntry;//拷贝当前任务入口地址
        taskParam.uwStackSize = runTask->stackSize; //栈空间大小
        taskParam.userParam.userArea = runTask->userArea;       //用户态栈区栈顶位置
        taskParam.userParam.userMapBase = runTask->userMapBase; //用户态栈底
        taskParam.userParam.userMapSize = runTask->userMapSize; //用户态栈大小
    } else {//注意内核态进程创建任务的入口由外界指定,例如 OsCreateIdleProcess 指定了OsIdleTask
        taskParam.pfnTaskEntry = (TSK_ENTRY_FUNC)entry;//参数(sp)为内核态入口地址
        taskParam.uwStackSize = size;//参数(size)为内核态栈大小
    }
    if (runTask->taskStatus & OS_TASK_FLAG_PTHREAD_JOIN) {
        taskParam.uwResved = LOS_TASK_ATTR_JOINABLE;
    }
 
    runTask->ops->schedParamGet(runTask, &param);
    SCHEDULER_UNLOCK(intSave);
 
    taskParam.pcName = (CHAR *)name;
    taskParam.policy = param.policy;
    taskParam.usTaskPrio = param.priority;
    taskParam.processID = childProcessCB->processID;
 
    ret = LOS_TaskCreateOnly(&taskID, &taskParam);
    if (ret != LOS_OK) {
        if (ret == LOS_ERRNO_TSK_TCB_UNAVAILABLE) {
            return LOS_EAGAIN;
        }
        return LOS_ENOMEM;
    }
 
    LosTaskCB *childTaskCB = OS_TCB_FROM_TID(taskID);
    childTaskCB->taskStatus = runTask->taskStatus;//任务状态先同步,注意这里是赋值操作. ...01101001 
    childTaskCB->ops->schedParamModify(childTaskCB, &param);
    if (childTaskCB->taskStatus & OS_TASK_STATUS_RUNNING) {//因只能有一个运行的task,所以如果一样要改4号位
        childTaskCB->taskStatus &= ~OS_TASK_STATUS_RUNNING;//将四号位清0 ,变成 ...01100001 
    } else {//非运行状态下会发生什么?
        if (OS_SCHEDULER_ACTIVE) {//克隆线程发生错误未运行
            LOS_Panic("Clone thread status not running error status: 0x%x\n", childTaskCB->taskStatus);
        }
        childTaskCB->taskStatus &= ~OS_TASK_STATUS_UNUSED;//干净的Task
    }
 
    if (OsProcessIsUserMode(childProcessCB)) {//是否是用户进程
        SCHEDULER_LOCK(intSave);
        OsUserCloneParentStack(childTaskCB->stackPointer, runTask->topOfStack, runTask->stackSize);//拷贝当前任务上下文给新的任务
        SCHEDULER_UNLOCK(intSave);
    }
    return LOS_OK;
}

函数调用图:

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

OsCopyUser()

STATIC UINT32 OsCopyUser	(	LosProcessCB *	childCB,
		LosProcessCB *	parentCB
	)

拷贝用户信息 直接用memcpy_s

在文件 los_process.c 第 1788 行定义.

{
#ifdef LOSCFG_SECURITY_CAPABILITY
    UINT32 size = sizeof(User) + sizeof(UINT32) * (parentCB->user->groupNumber - 1);
    childCB->user = LOS_MemAlloc(m_aucSysMem1, size);
    if (childCB->user == NULL) {
        return LOS_ENOMEM;
    }
 
    (VOID)memcpy_s(childCB->user, size, parentCB->user, size);
#endif
    return LOS_OK;
}

函数调用图:

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

OsCreateProcessGroup()

STATIC ProcessGroup * OsCreateProcessGroup

(

UINT32

pid

)

创建进程组

参数

argc	1
[UINT32]	pid 进程ID

返回

函数执行结果

• ProcessGroup 返回进程组

在文件 los_process.c 第 160 行定义.

{
    LosProcessCB *processCB = NULL;
    ProcessGroup *group = LOS_MemAlloc(m_aucSysMem1, sizeof(ProcessGroup));//从内存池中分配进程组结构体
    if (group == NULL) {
        return NULL;
    }
 
    group->groupID = pid;//参数当进程组ID
    LOS_ListInit(&group->processList);//初始化进程链表,这里把组内的进程都挂上去
    LOS_ListInit(&group->exitProcessList);//初始化退出进程链表,这里挂退出的进程
 
    processCB = OS_PCB_FROM_PID(pid);//通过pid获得进程实体
    LOS_ListTailInsert(&group->processList, &processCB->subordinateGroupList);//通过subordinateGroupList挂在进程组上,自然后续要通过它来找到进程实体
    processCB->group = group;//设置进程所属进程组
    processCB->processStatus |= OS_PROCESS_FLAG_GROUP_LEADER;//进程状态贴上当老大的标签
    if (g_processGroup != NULL) {//全局进程组链表判空,g_processGroup指向"Kernel"进程所在组,详见: OsKernelInitProcess
        LOS_ListTailInsert(&g_processGroup->groupList, &group->groupList);//把进程组挂到全局进程组链表上
    }
 
    return group;
}

函数调用图:

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

OsCreateUser()

STATIC User * OsCreateUser	(	UINT32	userID,
		UINT32	gid,
		UINT32	size
	)

在文件 los_process.c 第 788 行定义.

{   //(size - 1) * sizeof(UINT32) 用于 user->groups[..],这种设计节约了内存,不造成不需要的浪费
    User *user = LOS_MemAlloc(m_aucSysMem1, sizeof(User) + (size - 1) * sizeof(UINT32));
    if (user == NULL) {
        return NULL;
    }
 
    user->userID = userID;
    user->effUserID = userID;
    user->gid = gid;
    user->effGid = gid;
    user->groupNumber = size;//用户组数量
    user->groups[0] = gid;   //用户组列表,一个用户可以属于多个用户组
    return user;
}

函数调用图:

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

OsDealAliveChildProcess()

STATIC VOID OsDealAliveChildProcess

(

LosProcessCB *

processCB

)

当一个进程自然退出的时候,它的孩子进程由两位老祖宗收养

在文件 los_process.c 第 503 行定义.

{
    UINT32 parentID;
    LosProcessCB *childCB = NULL;
    LosProcessCB *parentCB = NULL;
    LOS_DL_LIST *nextList = NULL;
    LOS_DL_LIST *childHead = NULL;
 
    if (!LOS_ListEmpty(&processCB->childrenList)) {//如果存在孩子进程
        childHead = processCB->childrenList.pstNext;//获取孩子链表
        LOS_ListDelete(&(processCB->childrenList));//清空自己的孩子链表
        if (OsProcessIsUserMode(processCB)) {//是用户态进程
            parentID = g_userInitProcess;//用户态进程老祖宗
        } else {
            parentID = g_kernelInitProcess;//内核态进程老祖宗
        }
 
        for (nextList = childHead; ;) {//遍历孩子链表
            childCB = OS_PCB_FROM_SIBLIST(nextList);//找到孩子的真身
            childCB->parentProcessID = parentID;//孩子磕头认老祖宗为爸爸
            nextList = nextList->pstNext;//找下一个孩子进程
            if (nextList == childHead) {//一圈下来,孩子们都磕完头了
                break;
            }
        }
 
        parentCB = OS_PCB_FROM_PID(parentID);//找个老祖宗的真身
        LOS_ListTailInsertList(&parentCB->childrenList, childHead);//挂到老祖宗的孩子链表上
    }
 
    return;
}

函数调用图:

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

OsDeInitPCB()

STATIC VOID OsDeInitPCB

(

LosProcessCB *

processCB

)

删除PCB块 其实是 PCB块回归进程池,先进入回收链表

在文件 los_process.c 第 672 行定义.

{
    UINT32 intSave;
    ProcessGroup *group = NULL;
 
    if (processCB == NULL) {
        return;
    }
 
    OsProcessResourcesToFree(processCB);//释放进程所占用的资源
 
    SCHEDULER_LOCK(intSave);
    if (processCB->parentProcessID != OS_INVALID_VALUE) {
        LOS_ListDelete(&processCB->siblingList);//将进程从兄弟链表中摘除
        processCB->parentProcessID = OS_INVALID_VALUE;
    }
 
    if (processCB->group != NULL) {
        OsExitProcessGroup(processCB, &group);//退出进程组
    }
 
    processCB->processStatus &= ~OS_PROCESS_STATUS_INIT;//设置进程状态为非初始化
    processCB->processStatus |= OS_PROCESS_FLAG_EXIT;   //设置进程状态为退出
    LOS_ListHeadInsert(&g_processRecycleList, &processCB->pendList);
    SCHEDULER_UNLOCK(intSave);
 
    (VOID)LOS_MemFree(m_aucSysMem1, group);//释放内存
    OsWriteResourceEvent(OS_RESOURCE_EVENT_FREE);
    return;
}

函数调用图:

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

OsDeleteTaskFromProcess()

VOID OsDeleteTaskFromProcess

(

LosTaskCB *

taskCB

)

在文件 los_process.c 第 107 行定义.

{
    LosProcessCB *processCB = OS_PCB_FROM_PID(taskCB->processID);
 
    LOS_ListDelete(&taskCB->threadList);
    processCB->threadNumber--;
    OsTaskInsertToRecycleList(taskCB);
}

函数调用图:

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

OsExecProcessVmSpaceReplace()

LITE_OS_SEC_TEXT LosVmSpace * OsExecProcessVmSpaceReplace	(	LosVmSpace *	newSpace,
		UINTPTR	stackBase,
		INT32	randomDevFD
	)

在文件 los_process.c 第 1541 行定义.

{
    LosProcessCB *processCB = OsCurrProcessGet();
    LosTaskCB *runTask = OsCurrTaskGet();
 
    OsProcessThreadGroupDestroy();
    OsTaskCBRecycleToFree();
 
    LosVmSpace *oldSpace = processCB->vmSpace;
    processCB->vmSpace = newSpace;
    processCB->vmSpace->heapBase += OsGetRndOffset(randomDevFD);
    processCB->vmSpace->heapNow = processCB->vmSpace->heapBase;
    processCB->vmSpace->mapBase += OsGetRndOffset(randomDevFD);
    processCB->vmSpace->mapSize = stackBase - processCB->vmSpace->mapBase;
    runTask->archMmu = (UINTPTR)&processCB->vmSpace->archMmu;
    LOS_ArchMmuContextSwitch((LosArchMmu *)runTask->archMmu);
    return oldSpace;
}

函数调用图:

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

OsExecProcessVmSpaceRestore()

LITE_OS_SEC_TEXT VOID OsExecProcessVmSpaceRestore

(

LosVmSpace *

oldSpace

)

在文件 los_process.c 第 1531 行定义.

{
    LosProcessCB *processCB = OsCurrProcessGet();
    LosTaskCB *runTask = OsCurrTaskGet();
 
    processCB->vmSpace = oldSpace;
    runTask->archMmu = (UINTPTR)&processCB->vmSpace->archMmu;
    LOS_ArchMmuContextSwitch((LosArchMmu *)runTask->archMmu);
}

函数调用图:

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

OsExecRecycleAndInit()

LITE_OS_SEC_TEXT UINT32 OsExecRecycleAndInit	(	LosProcessCB *	processCB,
		const CHAR *	name,
		LosVmSpace *	oldSpace,
		UINTPTR	oldFiles
	)

进程的回收再利用,被LOS_DoExecveFile调用

参数

processCB
name
oldSpace
oldFiles

返回

LITE_OS_SEC_TEXT

在文件 los_process.c 第 1568 行定义.

{
    UINT32 ret;
    const CHAR *processName = NULL;
 
    if ((processCB == NULL) || (name == NULL)) {
        return LOS_NOK;
    }
 
    processName = strrchr(name, '/');
    processName = (processName == NULL) ? name : (processName + 1); /* 1: Do not include '/' */
 
    ret = (UINT32)OsSetTaskName(OsCurrTaskGet(), processName, TRUE);
    if (ret != LOS_OK) {
        return ret;
    }
 
#ifdef LOSCFG_KERNEL_LITEIPC
    (VOID)LiteIpcPoolDestroy(processCB->processID);
#endif
 
    processCB->sigHandler = 0;
    OsCurrTaskGet()->sig.sigprocmask = 0;
 
    LOS_VmSpaceFree(oldSpace);
#ifdef LOSCFG_FS_VFS
    CloseOnExec((struct files_struct *)oldFiles);
    delete_files_snapshot((struct files_struct *)oldFiles);
#endif
 
    OsSwtmrRecycle(processCB->processID);//回收定时器
    processCB->timerID = (timer_t)(UINTPTR)MAX_INVALID_TIMER_VID;
 
#ifdef LOSCFG_SECURITY_VID
    VidMapDestroy(processCB);
    ret = VidMapListInit(processCB);
    if (ret != LOS_OK) {
        return LOS_NOK;
    }
#endif
 
    processCB->processStatus &= ~OS_PROCESS_FLAG_EXIT;  //去掉进程退出标签
    processCB->processStatus |= OS_PROCESS_FLAG_ALREADY_EXEC;//加上进程运行elf标签
 
    return LOS_OK;
}

函数调用图:

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

OsExecStart()

LITE_OS_SEC_TEXT UINT32 OsExecStart	(	const TSK_ENTRY_FUNC	entry,
		UINTPTR	sp,
		UINTPTR	mapBase,
		UINT32	mapSize
	)

执行用户态任务, entry为入口函数 ,其中 创建好task,task上下文 等待调度真正执行, sp:栈指针 mapBase:栈底 mapSize:栈大小

在文件 los_process.c 第 1616 行定义.

{
    UINT32 intSave;
 
    if (entry == NULL) {
        return LOS_NOK;
    }
 
    if ((sp == 0) || (LOS_Align(sp, LOSCFG_STACK_POINT_ALIGN_SIZE) != sp)) {//对齐
        return LOS_NOK;
    }
    //注意 sp此时指向栈底,栈底地址要大于栈顶
    if ((mapBase == 0) || (mapSize == 0) || (sp <= mapBase) || (sp > (mapBase + mapSize))) {//参数检查
        return LOS_NOK;
    }
 
    LosTaskCB *taskCB = OsCurrTaskGet();//获取当前任务
    SCHEDULER_LOCK(intSave);//拿自旋锁
 
    taskCB->userMapBase = mapBase;//用户态栈顶位置
    taskCB->userMapSize = mapSize;//用户态栈
    taskCB->taskEntry = (TSK_ENTRY_FUNC)entry;//任务的入口函数
    //初始化内核态栈
    TaskContext *taskContext = (TaskContext *)OsTaskStackInit(taskCB->taskID, taskCB->stackSize,
                                                              (VOID *)taskCB->topOfStack, FALSE);
    OsUserTaskStackInit(taskContext, (UINTPTR)taskCB->taskEntry, sp);//初始化用户栈,将内核栈中上下文的 context->R[0] = sp ,context->sp = sp
    //这样做的目的是将用户栈SP保存到内核栈中,
    SCHEDULER_UNLOCK(intSave);//解锁
    return LOS_OK;
}

函数调用图:

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

OsExitProcessGroup()

STATIC VOID OsExitProcessGroup	(	LosProcessCB *	processCB,
		ProcessGroup **	group
	)

退出进程组,参数是进程地址和进程组地址的地址

在文件 los_process.c 第 184 行定义.

{
    LosProcessCB *groupProcessCB = OS_PCB_FROM_PID(processCB->group->groupID);//找到进程组老大进程的实体
 
    LOS_ListDelete(&processCB->subordinateGroupList);//从进程组进程链表上摘出去
    if (LOS_ListEmpty(&processCB->group->processList) && LOS_ListEmpty(&processCB->group->exitProcessList)) {//进程组进程链表和退出进程链表都为空时
        LOS_ListDelete(&processCB->group->groupList);//从全局进程组链表上把自己摘出去 记住它是 LOS_ListTailInsert(&g_processGroup->groupList, &group->groupList) 挂上去的
        groupProcessCB->processStatus &= ~OS_PROCESS_FLAG_GROUP_LEADER;//贴上不是组长的标签
        *group = processCB->group;//????? 这步操作没看明白,谁能告诉我为何要这么做?
        if (OsProcessIsUnused(groupProcessCB) && !(groupProcessCB->processStatus & OS_PROCESS_FLAG_EXIT)) {//组长进程时退出的标签
            LOS_ListDelete(&groupProcessCB->pendList);//进程从全局进程链表上摘除
            OsInsertPCBToFreeList(groupProcessCB);//释放进程的资源,回到freelist再利用
        }
    }
 
    processCB->group = NULL;
}

函数调用图:

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

OsFindChildProcess()

STATIC UINT32 OsFindChildProcess	(	const LosProcessCB *	processCB,
		INT32	childPid
	)

查找进程是否有指定孩子进程

在文件 los_process.c 第 291 行定义.

{
    LosProcessCB *childCB = NULL;
 
    if (childPid < 0) {
        goto ERR;
    }
 
    LOS_DL_LIST_FOR_EACH_ENTRY(childCB, &(processCB->childrenList), LosProcessCB, siblingList) {//
        if (childCB->processID == childPid) {
            return LOS_OK;
        }
    }
 
ERR:
    PRINT_INFO("%s is find the child : %d failed in parent : %u\n", __FUNCTION__, childPid, processCB->processID);
    return LOS_NOK;
}

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

OsFindExitChildProcess()

STATIC LosProcessCB * OsFindExitChildProcess	(	const LosProcessCB *	processCB,
		INT32	childPid
	)

找出指定进程的指定孩子进程

在文件 los_process.c 第 311 行定义.

{
    LosProcessCB *exitChild = NULL;
 
    LOS_DL_LIST_FOR_EACH_ENTRY(exitChild, &(processCB->exitChildList), LosProcessCB, siblingList) {
        if ((childPid == OS_INVALID_VALUE) || (exitChild->processID == childPid)) {
            return exitChild;
        }
    }
 
    PRINT_INFO("%s is find the exit child : %d failed in parent : %u\n", __FUNCTION__, childPid, processCB->processID);
    return NULL;
}

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

OsFindGroupExitProcess()

STATIC LosProcessCB * OsFindGroupExitProcess	(	ProcessGroup *	group,
		INT32	pid
	)

在文件 los_process.c 第 276 行定义.

{
    LosProcessCB *childCB = NULL;
 
    LOS_DL_LIST_FOR_EACH_ENTRY(childCB, &(group->exitProcessList), LosProcessCB, subordinateGroupList) {
        if ((childCB->processID == pid) || (pid == OS_INVALID_VALUE)) {
            return childCB;
        }
    }
 
    PRINT_INFO("%s find exit process : %d failed in group : %u\n", __FUNCTION__, pid, group->groupID);
    return NULL;
}

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

OsFindProcessGroup()

STATIC ProcessGroup * OsFindProcessGroup

(

UINT32

gid

)

通过指定组ID找到进程组

在文件 los_process.c 第 203 行定义.

{
    ProcessGroup *group = NULL;
    if (g_processGroup->groupID == gid) {
        return g_processGroup;
    }
    //变量进程组
    LOS_DL_LIST_FOR_EACH_ENTRY(group, &g_processGroup->groupList, ProcessGroup, groupList) {
        if (group->groupID == gid) {
            return group;
        }
    }
 
    PRINT_INFO("%s failed! group id = %u\n", __FUNCTION__, gid);
    return NULL;
}

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

OsForkInitPCB()

STATIC UINT32 OsForkInitPCB	(	UINT32	flags,
		LosProcessCB *	child,
		const CHAR *	name,
		UINTPTR	sp,
		UINT32	size
	)

在文件 los_process.c 第 1927 行定义.

{
    UINT32 ret;
    LosProcessCB *run = OsCurrProcessGet();//获取当前进程
 
    ret = OsInitPCB(child, run->processMode, name);
    if (ret != LOS_OK) {
        return ret;
    }
 
    ret = OsCopyParent(flags, child, run);//拷贝父亲大人的基因信息
    if (ret != LOS_OK) {
        return ret;
    }
 
    return OsCopyTask(flags, child, name, sp, size);//拷贝任务，设置任务入口函数，栈大小
}

函数调用图:

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

OsGetFreePCB()

STATIC LosProcessCB * OsGetFreePCB

(

VOID

)

为用户态任务分配栈空间

在文件 los_process.c 第 1491 行定义.

{
    LosProcessCB *processCB = NULL;
    UINT32 intSave;
 
    SCHEDULER_LOCK(intSave);
    if (LOS_ListEmpty(&g_freeProcess)) {
        SCHEDULER_UNLOCK(intSave);
        PRINT_ERR("No idle PCB in the system!\n");
        return NULL;
    }
 
    processCB = OS_PCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(&g_freeProcess));
    LOS_ListDelete(&processCB->pendList);
    SCHEDULER_UNLOCK(intSave);
 
    return processCB;
}

函数调用图:

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

OsGetIdleProcessID()

LITE_OS_SEC_TEXT UINT32 OsGetIdleProcessID

(

VOID

)

获取内核态空闲进程

在文件 los_process.c 第 2254 行定义.

{
    return g_kernelIdleProcess;
}

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

OsGetKernelInitProcessID()

LITE_OS_SEC_TEXT UINT32 OsGetKernelInitProcessID

(

VOID

)

获取内核态根进程

在文件 los_process.c 第 2249 行定义.

{
    return g_kernelInitProcess;
}

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

OsGetProcessPriority()

LITE_OS_SEC_TEXT INT32 OsGetProcessPriority	(	INT32	which,
		INT32	pid
	)

接口封装 - 获取进程优先级 which:标识进程,进程组,用户

在文件 los_process.c 第 1055 行定义.

{
    UINT32 intSave;
    SchedParam param = { 0 };
    (VOID)which;
 
    if (OS_PID_CHECK_INVALID(pid)) {
        return -LOS_EINVAL;
    }
 
    if (which != LOS_PRIO_PROCESS) {
        return -LOS_EINVAL;
    }
 
    LosProcessCB *processCB = OS_PCB_FROM_PID(pid);
    SCHEDULER_LOCK(intSave);
    if (OsProcessIsUnused(processCB)) {
        SCHEDULER_UNLOCK(intSave);
        return -LOS_ESRCH;
    }
 
    LosTaskCB *taskCB = OS_TCB_FROM_TID(processCB->threadGroupID);
    taskCB->ops->schedParamGet(taskCB, &param);
 
    SCHEDULER_UNLOCK(intSave);
    return param.basePrio;
}

函数调用图:

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

OsGetSigHandler()

LITE_OS_SEC_TEXT UINTPTR OsGetSigHandler

(

VOID

)

获取进程的信号处理函数

在文件 los_process.c 第 2264 行定义.

{
    return OsCurrProcessGet()->sigHandler;
}

函数调用图:

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

OsGetUserInitProcessID()

LITE_OS_SEC_TEXT UINT32 OsGetUserInitProcessID

(

VOID

)

获取用户态进程的根进程,所有用户进程都是g_processCBArray[g_userInitProcess] fork来的

在文件 los_process.c 第 2244 行定义.

{
    return g_userInitProcess;//用户态根进程 序号为 1
}

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

OsInitPCB()

STATIC UINT32 OsInitPCB	(	LosProcessCB *	processCB,
		UINT32	mode,
		const CHAR *	name
	)

初始化PCB(进程控制块)

在文件 los_process.c 第 737 行定义.

{
    processCB->processMode = mode;                      //用户态进程还是内核态进程
    processCB->processStatus = OS_PROCESS_STATUS_INIT;  //进程初始状态
    processCB->parentProcessID = OS_INVALID_VALUE;      //爸爸进程，外面指定
    processCB->threadGroupID = OS_INVALID_VALUE;        //所属线程组
    processCB->umask = OS_PROCESS_DEFAULT_UMASK;        //掩码
    processCB->timerID = (timer_t)(UINTPTR)MAX_INVALID_TIMER_VID;
 
    LOS_ListInit(&processCB->threadSiblingList);//初始化孩子任务/线程链表，上面挂的都是由此fork的孩子线程 见于 OsTaskCBInit LOS_ListTailInsert(&(processCB->threadSiblingList), &(taskCB->threadList));
    LOS_ListInit(&processCB->childrenList);     //初始化孩子进程链表，上面挂的都是由此fork的孩子进程 见于 OsCopyParent LOS_ListTailInsert(&parentProcessCB->childrenList, &childProcessCB->siblingList);
    LOS_ListInit(&processCB->exitChildList);    //初始化记录退出孩子进程链表，上面挂的是哪些exit 见于 OsProcessNaturalExit LOS_ListTailInsert(&parentCB->exitChildList, &processCB->siblingList);
    LOS_ListInit(&(processCB->waitList));       //初始化等待任务链表 上面挂的是处于等待的 见于 OsWaitInsertWaitLIstInOrder LOS_ListHeadInsert(&processCB->waitList, &runTask->pendList);
 
#ifdef LOSCFG_KERNEL_VM 
    if (OsProcessIsUserMode(processCB)) {//如果是用户态进程
        processCB->vmSpace = OsCreateUserVmSpace();//创建用户空间
        if (processCB->vmSpace == NULL) {
            processCB->processStatus = OS_PROCESS_FLAG_UNUSED;
            return LOS_ENOMEM;
        }
    } else {
        processCB->vmSpace = LOS_GetKVmSpace();//从这里也可以看出,所有内核态进程是共享一个进程空间的
    }//在鸿蒙内核态进程只有kprocess 和 kidle 两个 
#endif
 
#ifdef LOSCFG_KERNEL_CPUP
    processCB->processCpup = (OsCpupBase *)LOS_MemAlloc(m_aucSysMem1, sizeof(OsCpupBase));
    if (processCB->processCpup == NULL) {
        return LOS_ENOMEM;
    }
    (VOID)memset_s(processCB->processCpup, sizeof(OsCpupBase), 0, sizeof(OsCpupBase));
#endif
#ifdef LOSCFG_SECURITY_VID
    status_t status = VidMapListInit(processCB);
    if (status != LOS_OK) {
        return LOS_ENOMEM;
    }
#endif
#ifdef LOSCFG_SECURITY_CAPABILITY
    OsInitCapability(processCB);//初始化进程安全相关功能
#endif
 
    if (OsSetProcessName(processCB, name) != LOS_OK) {
        return LOS_ENOMEM;
    }
 
    return LOS_OK;
}

函数调用图:

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

OsInsertPCBToFreeList()

STATIC INLINE VOID OsInsertPCBToFreeList

(

LosProcessCB *

processCB

)

将进程插入到空闲链表中

参数

argc	1
[LosProcessCB]	processCB 指定进程

返回

函数执行结果

• VOID 无

在文件 los_process.c 第 97 行定义.

{
    UINT32 pid = processCB->processID;//获取进程ID
    (VOID)memset_s(processCB, sizeof(LosProcessCB), 0, sizeof(LosProcessCB));//进程描述符数据清0
    processCB->processID = pid;//进程ID
    processCB->processStatus = OS_PROCESS_FLAG_UNUSED;//设置为进程未使用
    processCB->timerID = (timer_t)(UINTPTR)MAX_INVALID_TIMER_VID;//timeID初始化值
    LOS_ListTailInsert(&g_freeProcess, &processCB->pendList);//进程节点挂入g_freeProcess以分配给后续进程使用
}

函数调用图:

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

OsLoadUserInit()

STATIC UINT32 OsLoadUserInit

(

LosProcessCB *

processCB

)

在文件 los_process.c 第 1681 行定义.

{
    /*              userInitTextStart               -----
     * | user text |
     *
     * | user data |                                initSize
     *              userInitBssStart  ---
     * | user bss  |                  initBssSize
     *              userInitEnd       ---           -----
     */
    errno_t errRet;
    INT32 ret;
    CHAR *userInitTextStart = (CHAR *)&__user_init_entry;
    CHAR *userInitBssStart = (CHAR *)&__user_init_bss;
    CHAR *userInitEnd = (CHAR *)&__user_init_end;
    UINT32 initBssSize = userInitEnd - userInitBssStart;
    UINT32 initSize = userInitEnd - userInitTextStart;
    VOID *userBss = NULL;
    VOID *userText = NULL;
 
    if ((LOS_Align((UINTPTR)userInitTextStart, PAGE_SIZE) != (UINTPTR)userInitTextStart) ||
        (LOS_Align((UINTPTR)userInitEnd, PAGE_SIZE) != (UINTPTR)userInitEnd)) {
        return LOS_EINVAL;
    }
 
    if ((initSize == 0) || (initSize <= initBssSize)) {
        return LOS_EINVAL;
    }
 
    userText = LOS_PhysPagesAllocContiguous(initSize >> PAGE_SHIFT);
    if (userText == NULL) {
        return LOS_NOK;
    }
 
    errRet = memcpy_s(userText, initSize, (VOID *)&__user_init_load_addr, initSize - initBssSize);
    if (errRet != EOK) {
        PRINT_ERR("Load user init text, data and bss failed! err : %d\n", errRet);
        goto ERROR;
    }
    ret = LOS_VaddrToPaddrMmap(processCB->vmSpace, (VADDR_T)(UINTPTR)userInitTextStart, LOS_PaddrQuery(userText),
                               initSize, VM_MAP_REGION_FLAG_PERM_READ | VM_MAP_REGION_FLAG_PERM_WRITE |
                               VM_MAP_REGION_FLAG_FIXED | VM_MAP_REGION_FLAG_PERM_EXECUTE |
                               VM_MAP_REGION_FLAG_PERM_USER);
    if (ret < 0) {
        PRINT_ERR("Mmap user init text, data and bss failed! err : %d\n", ret);
        goto ERROR;
    }
 
    /* The User init boot segment may not actually exist */
    if (initBssSize != 0) {
        userBss = (VOID *)((UINTPTR)userText + userInitBssStart - userInitTextStart);
        errRet = memset_s(userBss, initBssSize, 0, initBssSize);
        if (errRet != EOK) {
            PRINT_ERR("memset user init bss failed! err : %d\n", errRet);
            goto ERROR;
        }
    }
 
    return LOS_OK;
 
ERROR:
    (VOID)LOS_PhysPagesFreeContiguous(userText, initSize >> PAGE_SHIFT);
    return LOS_NOK;
}

函数调用图:

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

OsProcessAddNewTask()

UINT32 OsProcessAddNewTask	(	UINT32	pid,
		LosTaskCB *	taskCB,
		SchedParam *	param
	)

在文件 los_process.c 第 116 行定义.

{
    UINT32 intSave;
    UINT16 numCount;
    LosProcessCB *processCB = OS_PCB_FROM_PID(pid);
 
    SCHEDULER_LOCK(intSave);
    taskCB->processID = pid;
    LOS_ListTailInsert(&(processCB->threadSiblingList), &(taskCB->threadList));
 
    if (OsProcessIsUserMode(processCB)) {
        taskCB->taskStatus |= OS_TASK_FLAG_USER_MODE;
        if (processCB->threadNumber > 0) {
            LosTaskCB *task = OS_TCB_FROM_TID(processCB->threadGroupID);
            task->ops->schedParamGet(task, param);
        } else {
            OsSchedProcessDefaultSchedParamGet(param->policy, param);
        }
    } else {
        LosTaskCB *runTask = OsCurrTaskGet();
        runTask->ops->schedParamGet(runTask, param);
    }
 
#ifdef LOSCFG_KERNEL_VM
    taskCB->archMmu = (UINTPTR)&processCB->vmSpace->archMmu;
#endif
    if (!processCB->threadNumber) {
        processCB->threadGroupID = taskCB->taskID;
    }
    processCB->threadNumber++;
 
    numCount = processCB->threadCount;
    processCB->threadCount++;
    SCHEDULER_UNLOCK(intSave);
    return numCount;
}

函数调用图:

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

OsProcessCapPermitCheck()

STATIC BOOL OsProcessCapPermitCheck	(	const LosProcessCB *	processCB,
		const SchedParam *	param,
		UINT16	prio
	)

在文件 los_process.c 第 961 行定义.

{
    LosProcessCB *runProcess = OsCurrProcessGet();//获得当前进程
 
    /* always trust kernel process */
    if (!OsProcessIsUserMode(runProcess)) {//进程必须在内核模式下,也就是说在内核模式下是安全的.
        return TRUE;
    }
 
    /* user mode process can reduce the priority of itself */
    if ((runProcess->processID == processCB->processID) && (prio > param->basePrio)) {
        return TRUE;
    }
 
    /* user mode process with privilege of CAP_SCHED_SETPRIORITY can change the priority */
    if (IsCapPermit(CAP_SCHED_SETPRIORITY)) {
        return TRUE;
    }
    return FALSE;
}

函数调用图:

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

OsProcessCBRecycleToFree()

LITE_OS_SEC_TEXT VOID OsProcessCBRecycleToFree

(

VOID

)

进程回收再利用过程

在文件 los_process.c 第 625 行定义.

{
    UINT32 intSave;
    LosProcessCB *processCB = NULL;
 
    SCHEDULER_LOCK(intSave);
    while (!LOS_ListEmpty(&g_processRecycleList)) {//循环任务回收链表,直到为空
        processCB = OS_PCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(&g_processRecycleList));//找到回收链表中第一个进程实体
        //OS_PCB_FROM_PENDLIST 代表的是通过pendlist节点找到 PCB实体,因为g_processRecyleList上面挂的是pendlist节点位置
        if (!(processCB->processStatus & OS_PROCESS_FLAG_EXIT)) {//进程没有退出标签
            break;
        }
        SCHEDULER_UNLOCK(intSave);
 
        OsTaskCBRecycleToFree();
 
        SCHEDULER_LOCK(intSave);
        processCB->processStatus &= ~OS_PROCESS_FLAG_EXIT;//给进程撕掉退出标签,(可能进程并没有这个标签)
#ifdef LOSCFG_KERNEL_VM
        LosVmSpace *space = NULL;
        if (OsProcessIsUserMode(processCB)) {//进程是否是用户态进程
            space = processCB->vmSpace;//只有用户态的进程才需要释放虚拟内存空间
        }
        processCB->vmSpace = NULL;
#endif
        /* OS_PROCESS_FLAG_GROUP_LEADER: The lead process group cannot be recycled without destroying the PCB.
         * !OS_PROCESS_FLAG_UNUSED: Parent process does not reclaim child process resources.
         */
        LOS_ListDelete(&processCB->pendList);//将进程从进程链表上摘除
        if ((processCB->processStatus & OS_PROCESS_FLAG_GROUP_LEADER) ||//如果进程是进程组组长或者处于僵死状态
            (processCB->processStatus & OS_PROCESS_STATUS_ZOMBIES)) {
            LOS_ListTailInsert(&g_processRecycleList, &processCB->pendList);//将进程挂到进程回收链表上,因为组长不能走啊
        } else {
            /* Clear the bottom 4 bits of process status */
            OsInsertPCBToFreeList(processCB);//进程回到可分配池中,再分配利用
        }
#ifdef LOSCFG_KERNEL_VM
        SCHEDULER_UNLOCK(intSave);
        (VOID)LOS_VmSpaceFree(space);//释放用户态进程的虚拟内存空间,因为内核只有一个虚拟空间,因此不需要释放虚拟空间.
        SCHEDULER_LOCK(intSave);
#endif
    }
 
    SCHEDULER_UNLOCK(intSave);
}

函数调用图:

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

OsProcessCreateInit()

STATIC UINT32 OsProcessCreateInit	(	LosProcessCB *	processCB,
		UINT32	flags,
		const CHAR *	name
	)

进程创建初始化

在文件 los_process.c 第 859 行定义.

{
    ProcessGroup *group = NULL;
    UINT32 ret = OsInitPCB(processCB, flags, name);
    if (ret != LOS_OK) {
        goto EXIT;
    }
 
#ifdef LOSCFG_FS_VFS
    processCB->files = alloc_files();//分配进程的文件的管理器
    if (processCB->files == NULL) {
        ret = LOS_ENOMEM;
        goto EXIT;
    }
#endif
 
    group = OsCreateProcessGroup(processCB->processID);//创建进程组
    if (group == NULL) {
        ret = LOS_ENOMEM;
        goto EXIT;
    }
 
#ifdef LOSCFG_SECURITY_CAPABILITY   //用户安全宏
    processCB->user = OsCreateUser(0, 0, 1);//创建用户
    if (processCB->user == NULL) {
        ret = LOS_ENOMEM;
        goto EXIT;
    }
#endif
 
    return LOS_OK;
 
EXIT:
    OsDeInitPCB(processCB);//删除进程控制块,归还内存
    return ret;
}

函数调用图:

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

OsProcessInit()

STATIC UINT32 OsProcessInit

(

VOID

)

进程模块初始化,被编译放在代码段 .init 中

在文件 los_process.c 第 586 行定义.

{
    UINT32 index;
    UINT32 size;
 
    g_processMaxNum = LOSCFG_BASE_CORE_PROCESS_LIMIT;//默认支持64个进程
    size = g_processMaxNum * sizeof(LosProcessCB);//算出总大小
 
    g_processCBArray = (LosProcessCB *)LOS_MemAlloc(m_aucSysMem1, size);// 进程池，占用内核堆,内存池分配 
    if (g_processCBArray == NULL) {
        return LOS_NOK;
    }
    (VOID)memset_s(g_processCBArray, size, 0, size);//安全方式重置清0
 
    LOS_ListInit(&g_freeProcess);//进程空闲链表初始化，创建一个进程时从g_freeProcess中申请一个进程描述符使用
    LOS_ListInit(&g_processRecycleList);//进程回收链表初始化,回收完成后进入g_freeProcess等待再次被申请使用
 
    for (index = 0; index < g_processMaxNum; index++) {//进程池循环创建
        g_processCBArray[index].processID = index;//进程ID[0-g_processMaxNum-1]赋值
        g_processCBArray[index].processStatus = OS_PROCESS_FLAG_UNUSED;// 默认都是白纸一张,贴上未使用标签
        LOS_ListTailInsert(&g_freeProcess, &g_processCBArray[index].pendList);//注意g_freeProcess挂的是pendList节点,所以使用要通过OS_PCB_FROM_PENDLIST找到进程实体.
    }
 
    g_kernelIdleProcess = 0; /* 0: The idle process ID of the kernel-mode process is fixed at 0 *///内核态init进程,从名字可以看出来这是让cpu休息的进程.
    LOS_ListDelete(&OS_PCB_FROM_PID(g_kernelIdleProcess)->pendList);//从空闲链表中摘掉
    
    g_userInitProcess = 1; /* 1: The root process ID of the user-mode process is fixed at 1 *///用户态的根进程
    LOS_ListDelete(&OS_PCB_FROM_PID(g_userInitProcess)->pendList);//从空闲链表中摘掉
 
    g_kernelInitProcess = 2; /* 2: The root process ID of the kernel-mode process is fixed at 2 *///内核态的根进程
    LOS_ListDelete(&OS_PCB_FROM_PID(g_kernelInitProcess)->pendList);//从空闲链表中摘掉
 
    //注意:这波骚操作之后,g_freeProcess链表上还有[3,g_processMaxNum-1]号进程.创建进程是从g_freeProcess上申请
    //即下次申请到的将是0号进程,而 OsCreateIdleProcess 将占有0号进程.
 
    return LOS_OK;
}

函数调用图:

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

OsProcessNaturalExit()

VOID OsProcessNaturalExit	(	LosProcessCB *	processCB,
		UINT32	status
	)

一个进程的自然消亡过程,参数是当前运行的任务

在文件 los_process.c 第 550 行定义.

{
    LosProcessCB *parentCB = NULL;
 
    OsChildProcessResourcesFree(processCB);//释放孩子进程的资源
 
 
    /* is a child process */
    if (processCB->parentProcessID != OS_INVALID_VALUE) {//判断是否有父进程
        parentCB = OS_PCB_FROM_PID(processCB->parentProcessID);//获取父进程实体
        LOS_ListDelete(&processCB->siblingList);//将自己从兄弟链表中摘除,家人们,永别了!
        if (!OsProcessExitCodeSignalIsSet(processCB)) {//是否设置了退出码?
            OsProcessExitCodeSet(processCB, status);//将进程状态设为退出码
        }
        LOS_ListTailInsert(&parentCB->exitChildList, &processCB->siblingList);//挂到父进程的孩子消亡链表,家人中,永别的可不止我一个.
        LOS_ListDelete(&processCB->subordinateGroupList);//和志同道合的朋友们永别了,注意家里可不一定是朋友的,所有各有链表.
        LOS_ListTailInsert(&processCB->group->exitProcessList, &processCB->subordinateGroupList);//挂到进程组消亡链表,朋友中,永别的可不止我一个.
 
        OsWaitCheckAndWakeParentProcess(parentCB, processCB);//检查父进程的等待任务链表并唤醒对应的任务,此处将会频繁的切到其他任务运行.
 
        OsDealAliveChildProcess(processCB);//孩子们要怎么处理,移交给(用户态和内核态)根进程
 
        processCB->processStatus |= OS_PROCESS_STATUS_ZOMBIES;//贴上僵死进程的标签
 
#ifdef LOSCFG_KERNEL_VM
        (VOID)OsKill(processCB->parentProcessID, SIGCHLD, OS_KERNEL_KILL_PERMISSION);//以内核权限发送SIGCHLD(子进程退出)信号.
#endif
        LOS_ListHeadInsert(&g_processRecycleList, &processCB->pendList);//将进程通过其阻塞节点挂入全局进程回收链表
        return;
    }
 
    LOS_Panic("pid : %u is the root process exit!\n", processCB->processID);
    return;
}

函数调用图:

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

OsProcessResourcesToFree()

LITE_OS_SEC_TEXT VOID OsProcessResourcesToFree

(

LosProcessCB *

processCB

)

回收指定进程的资源

在文件 los_process.c 第 431 行定义.

{
#ifdef LOSCFG_KERNEL_VM
    if (OsProcessIsUserMode(processCB)) {
        (VOID)OsVmSpaceRegionFree(processCB->vmSpace);
    }
#endif
#ifdef LOSCFG_FS_VFS
    if (OsProcessIsUserMode(processCB)) {//用户进程
        delete_files(processCB->files);//归还进程占用的进程描述符`profd`,如果是最后一个占用的系统描述符的进程,则同时归还系统文件描述符`sysfd`
    }
    processCB->files = NULL;    //重置指针为空
#endif
 
#ifdef LOSCFG_SECURITY_CAPABILITY //安全开关
    if (processCB->user != NULL) {
        (VOID)LOS_MemFree(m_aucSysMem1, processCB->user);//删除用户
        processCB->user = NULL; //重置指针为空
    }
#endif
 
    OsSwtmrRecycle(processCB->processID);//回收进程使用的定时器
    processCB->timerID = (timer_t)(UINTPTR)MAX_INVALID_TIMER_VID;
 
#ifdef LOSCFG_SECURITY_VID
    if (processCB->timerIdMap.bitMap != NULL) {
        VidMapDestroy(processCB);
        processCB->timerIdMap.bitMap = NULL;
    }
#endif
 
#ifdef LOSCFG_KERNEL_LITEIPC
    (VOID)LiteIpcPoolDestroy(processCB->processID);
#endif
 
#ifdef LOSCFG_KERNEL_CPUP
    UINT32 intSave;
    OsCpupBase *processCpup = processCB->processCpup;
    SCHEDULER_LOCK(intSave);
    processCB->processCpup = NULL;
    SCHEDULER_UNLOCK(intSave);
    (VOID)LOS_MemFree(m_aucSysMem1, processCpup);
#endif
 
    if (processCB->resourceLimit != NULL) {
        (VOID)LOS_MemFree((VOID *)m_aucSysMem0, processCB->resourceLimit);
        processCB->resourceLimit = NULL;
    }
}

函数调用图:

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

OsProcessSchedlerParamCheck()

STATIC INLINE INT32 OsProcessSchedlerParamCheck	(	INT32	which,
		INT32	pid,
		UINT16	prio,
		UINT16	policy
	)

进程调度参数检查

在文件 los_process.c 第 939 行定义.

{
    if (OS_PID_CHECK_INVALID(pid)) {//进程ID是否有效，默认 g_processMaxNum = 64
        return LOS_EINVAL;
    }
 
    if (which != LOS_PRIO_PROCESS) {//进程标识
        return LOS_EINVAL;
    }
 
    if (prio > OS_PROCESS_PRIORITY_LOWEST) {//鸿蒙优先级是 0 -31级,0级最大
        return LOS_EINVAL;//返回无效参数
    }
 
    if (policy != LOS_SCHED_RR) {
        return LOS_EINVAL;
    }
 
    return LOS_OK;
}

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

OsProcessThreadGroupDestroy()

LITE_OS_SEC_TEXT VOID OsProcessThreadGroupDestroy

(

VOID

)

在文件 los_process.c 第 2200 行定义.

{
#ifdef LOSCFG_KERNEL_VM
    UINT32 intSave;
 
    LosProcessCB *processCB = OsCurrProcessGet();
    LosTaskCB *currTask = OsCurrTaskGet();
    SCHEDULER_LOCK(intSave);
    if ((processCB->processStatus & OS_PROCESS_FLAG_EXIT) || !OsProcessIsUserMode(processCB)) {
        SCHEDULER_UNLOCK(intSave);
        return;
    }
 
    processCB->processStatus |= OS_PROCESS_FLAG_EXIT;
    processCB->threadGroupID = currTask->taskID;
 
    LOS_DL_LIST *list = &processCB->threadSiblingList;
    LOS_DL_LIST *head = list;
    do {
        LosTaskCB *taskCB = LOS_DL_LIST_ENTRY(list->pstNext, LosTaskCB, threadList);
        if ((OsTaskIsInactive(taskCB) ||
            ((taskCB->taskStatus & OS_TASK_STATUS_READY) && !taskCB->sig.sigIntLock)) &&
            !(taskCB->taskStatus & OS_TASK_STATUS_RUNNING)) {
            OsInactiveTaskDelete(taskCB);
        } else if (taskCB != currTask) {
            ThreadGroupActiveTaskKilled(taskCB);
        } else {
            /* Skip the current task */
            list = list->pstNext;
        }
    } while (head != list->pstNext);
 
    SCHEDULER_UNLOCK(intSave);
 
    LOS_ASSERT(processCB->threadNumber == 1);
#endif
    return;
}

函数调用图:

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

OsRecycleZombiesProcess()

LITE_OS_SEC_TEXT STATIC VOID OsRecycleZombiesProcess	(	LosProcessCB *	childCB,
		ProcessGroup **	group
	)

回收僵死状态进程的资源

在文件 los_process.c 第 482 行定义.

{
    OsExitProcessGroup(childCB, group);//退出进程组
    LOS_ListDelete(&childCB->siblingList);//从父亲大人的子孙链表上摘除
    if (childCB->processStatus & OS_PROCESS_STATUS_ZOMBIES) {//如果身上僵死状态的标签
        OsDeleteTaskFromProcess(OS_TCB_FROM_TID(childCB->threadGroupID));
        childCB->processStatus &= ~OS_PROCESS_STATUS_ZOMBIES;//去掉僵死标签
        childCB->processStatus |= OS_PROCESS_FLAG_UNUSED;//贴上没使用标签，进程由进程池分配，进程退出后重新回到空闲进程池
    }
 
    LOS_ListDelete(&childCB->pendList);//将自己从阻塞链表上摘除，注意有很多原因引起阻塞，pendList挂在哪里就以为这属于哪类阻塞
    if (childCB->processStatus & OS_PROCESS_FLAG_EXIT) {//如果有退出标签
        LOS_ListHeadInsert(&g_processRecycleList, &childCB->pendList);//从头部插入，注意g_processRecyleList挂的是pendList节点,所以要通过OS_PCB_FROM_PENDLIST找.
    } else if (childCB->processStatus & OS_PROCESS_FLAG_GROUP_LEADER) {//如果是进程组的组长
        LOS_ListTailInsert(&g_processRecycleList, &childCB->pendList);//从尾部插入，意思就是组长尽量最后一个处理
    } else {
        OsInsertPCBToFreeList(childCB);//直接插到freeList中去，可用于重新分配了。
    }
}

函数调用图:

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

OsSendSignalToAllProcess()

LITE_OS_SEC_TEXT INT32 OsSendSignalToAllProcess	(	siginfo_t *	info,
		INT32	permission
	)

给所有进程发送指定信号

在文件 los_process.c 第 242 行定义.

{
    INT32 ret, success, err;
    ProcessGroup *group = NULL;
 
    success = 0;
    err = OsSendSignalToSpecifyProcessGroup(g_processGroup, info, permission);//给g_processGroup进程组发送信号
    success |= !err;
    ret = err;
    /* all processes group */
    LOS_DL_LIST_FOR_EACH_ENTRY(group, &g_processGroup->groupList, ProcessGroup, groupList) {//遍历进程组
        /* all processes in the process group. */
        err = OsSendSignalToSpecifyProcessGroup(group, info, permission);
        success |= !err;
        ret = err;
    }
    return success ? LOS_OK : ret;
}

函数调用图:

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

OsSendSignalToProcessGroup()

LITE_OS_SEC_TEXT INT32 OsSendSignalToProcessGroup	(	INT32	pid,
		siginfo_t *	info,
		INT32	permission
	)

发送指定信号给给进程组

在文件 los_process.c 第 262 行定义.

{
    ProcessGroup *group = NULL;
    /* Send SIG to all processes in process group PGRP.
       If PGRP is zero, send SIG to all processes in
       the current process's process group. */
    group = OsFindProcessGroup(pid ? -pid : LOS_GetCurrProcessGroupID());
    if (group == NULL) {
        return -LOS_ESRCH;
    }
    /* all processes in the process group. */
    return OsSendSignalToSpecifyProcessGroup(group, info, permission);
}

函数调用图:

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

OsSendSignalToSpecifyProcessGroup()

STATIC INT32 OsSendSignalToSpecifyProcessGroup	(	ProcessGroup *	group,
		siginfo_t *	info,
		INT32	permission
	)

给指定进程组发送信号

在文件 los_process.c 第 221 行定义.

{
    INT32 ret, success, err;
    LosProcessCB *childCB = NULL;
 
    success = 0;
    ret = -LOS_ESRCH;
    LOS_DL_LIST_FOR_EACH_ENTRY(childCB, &(group->processList), LosProcessCB, subordinateGroupList) {//遍历进程组内的进程
        if (childCB->processID == 0) {//0号进程为KIdle进程,是让CPU休息的进程,不处理信号
            continue;
        }
 
        err = OsDispatch(childCB->processID, info, permission);//给进程发送信号
        success |= !err;
        ret = err;
    }
    /* At least one success. */
    return success ? LOS_OK : ret;
}

函数调用图:

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

OsSetCurrProcessGroupID()

LITE_OS_SEC_TEXT INT32 OsSetCurrProcessGroupID

(

UINT32

gid

)

在文件 los_process.c 第 1456 行定义.

{
    return OsSetProcessGroupID(OsCurrProcessGet()->processID, gid);
}

函数调用图:

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

OsSetProcessGroupCheck()

STATIC UINT32 OsSetProcessGroupCheck	(	const LosProcessCB *	processCB,
		UINT32	gid
	)

设置进程组检查

在文件 los_process.c 第 1365 行定义.

{
    LosProcessCB *runProcessCB = OsCurrProcessGet();//拿到当前运行进程
    LosProcessCB *groupProcessCB = OS_PCB_FROM_PID(gid);//通过组ID拿到组长PCB实体
 
    if (OsProcessIsInactive(processCB)) {//进程是否活动
        return LOS_ESRCH;
    }
    //参数进程不在用户态或者组长不在用户态
    if (!OsProcessIsUserMode(processCB) || !OsProcessIsUserMode(groupProcessCB)) {
        return LOS_EPERM;
    }
 
    if (runProcessCB->processID == processCB->parentProcessID) {
        if (processCB->processStatus & OS_PROCESS_FLAG_ALREADY_EXEC) {
            return LOS_EACCES;
        }
    } else if (processCB->processID != runProcessCB->processID) {
        return LOS_ESRCH;
    }
 
    /* Add the process to another existing process group */
    if (processCB->processID != gid) {
        if (!(groupProcessCB->processStatus & OS_PROCESS_FLAG_GROUP_LEADER)) {
            return LOS_EPERM;
        }
 
        if ((groupProcessCB->parentProcessID != processCB->parentProcessID) && (gid != processCB->parentProcessID)) {
            return LOS_EPERM;
        }
    }
 
    return LOS_OK;
}

函数调用图:

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

OsSetProcessGroupID()

LITE_OS_SEC_TEXT INT32 OsSetProcessGroupID	(	UINT32	pid,
		UINT32	gid
	)

在文件 los_process.c 第 1439 行定义.

{
    ProcessGroup *group = NULL;
    UINT32 ret;
    UINT32 intSave;
 
    if ((OS_PID_CHECK_INVALID(pid)) || (OS_PID_CHECK_INVALID(gid))) {
        return -LOS_EINVAL;
    }
 
    SCHEDULER_LOCK(intSave);
    ret = OsSetProcessGroupIDUnsafe(pid, gid, &group);
    SCHEDULER_UNLOCK(intSave);
    (VOID)LOS_MemFree(m_aucSysMem1, group);
    return -ret;
}

函数调用图:

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

OsSetProcessGroupIDUnsafe()

STATIC UINT32 OsSetProcessGroupIDUnsafe	(	UINT32	pid,
		UINT32	gid,
		ProcessGroup **	group
	)

在文件 los_process.c 第 1400 行定义.

{
    ProcessGroup *oldGroup = NULL;
    ProcessGroup *newGroup = NULL;
    LosProcessCB *processCB = OS_PCB_FROM_PID(pid);
    UINT32 ret = OsSetProcessGroupCheck(processCB, gid);
    if (ret != LOS_OK) {
        return ret;
    }
 
    if (processCB->group->groupID == gid) {
        return LOS_OK;
    }
 
    oldGroup = processCB->group;
    OsExitProcessGroup(processCB, group);
 
    newGroup = OsFindProcessGroup(gid);
    if (newGroup != NULL) {
        LOS_ListTailInsert(&newGroup->processList, &processCB->subordinateGroupList);
        processCB->group = newGroup;
        return LOS_OK;
    }
 
    newGroup = OsCreateProcessGroup(gid);
    if (newGroup == NULL) {
        LOS_ListTailInsert(&oldGroup->processList, &processCB->subordinateGroupList);
        processCB->group = oldGroup;
        if (*group != NULL) {
            LOS_ListTailInsert(&g_processGroup->groupList, &oldGroup->groupList);
            processCB = OS_PCB_FROM_PID(oldGroup->groupID);
            processCB->processStatus |= OS_PROCESS_FLAG_GROUP_LEADER;
            *group = NULL;
        }
        return LOS_EPERM;
    }
    return LOS_OK;
}

函数调用图:

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

OsSetProcessName()

UINT32 OsSetProcessName	(	LosProcessCB *	processCB,
		const CHAR *	name
	)

设置进程的名字

在文件 los_process.c 第 704 行定义.

{
    errno_t errRet;
 
    if (processCB == NULL) {
        return LOS_EINVAL;
    }
 
    if (name != NULL) {
        errRet = strncpy_s(processCB->processName, OS_PCB_NAME_LEN, name, OS_PCB_NAME_LEN - 1);
        if (errRet == EOK) {
            return LOS_OK;
        }
    }
 
    switch (processCB->processMode) {
        case OS_KERNEL_MODE:
            errRet = snprintf_s(processCB->processName, OS_PCB_NAME_LEN, OS_PCB_NAME_LEN - 1,
                                "KerProcess%u", processCB->processID);
            break;
        default:
            errRet = snprintf_s(processCB->processName, OS_PCB_NAME_LEN, OS_PCB_NAME_LEN - 1,
                                "UserProcess%u", processCB->processID);
            break;
    }
 
    if (errRet < 0) {
        return LOS_NOK;
    }
    return LOS_OK;
}

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

OsSetProcessScheduler()

LITE_OS_SEC_TEXT INT32 OsSetProcessScheduler	(	INT32	which,
		INT32	pid,
		UINT16	prio,
		UINT16	policy
	)

设置进程调度计划

在文件 los_process.c 第 983 行定义.

{
    SchedParam param = { 0 };
    UINT32 intSave;
 
    INT32 ret = OsProcessSchedlerParamCheck(which, pid, prio, policy);
    if (ret != LOS_OK) {
        return -ret;
    }
 
    LosProcessCB *processCB = OS_PCB_FROM_PID(pid);
    SCHEDULER_LOCK(intSave);//持有调度自旋锁,多CPU情况下调度期间需要原子处理
    if (OsProcessIsInactive(processCB)) {//进程未活动的处理
        ret = LOS_ESRCH;
        goto EXIT;
    }
 
#ifdef LOSCFG_SECURITY_CAPABILITY
    if (!OsProcessCapPermitCheck(processCB, &param, prio)) {
        ret = LOS_EPERM;
        goto EXIT;
    }
#endif
 
    LosTaskCB *taskCB = OS_TCB_FROM_TID(processCB->threadGroupID);
    taskCB->ops->schedParamGet(taskCB, &param);
    param.basePrio = prio;
 
    BOOL needSched = taskCB->ops->schedParamModify(taskCB, &param);
    SCHEDULER_UNLOCK(intSave);//还锁
 
    LOS_MpSchedule(OS_MP_CPU_ALL);//核间中断
    if (needSched && OS_SCHEDULER_ACTIVE) {
        LOS_Schedule();//发起调度
    }
    return LOS_OK;
 
EXIT:
    SCHEDULER_UNLOCK(intSave);//还锁
    return -ret;
}

函数调用图:

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

OsSetSigHandler()

LITE_OS_SEC_TEXT VOID OsSetSigHandler

(

UINTPTR

addr

)

设置进程的信号处理函数

在文件 los_process.c 第 2259 行定义.

{
    OsCurrProcessGet()->sigHandler = addr;
}

函数调用图:

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

OsSystemProcessCreate()

LITE_OS_SEC_TEXT_INIT UINT32 OsSystemProcessCreate

(

VOID

)

创建2,0号进程,即内核态进程的老祖宗

在文件 los_process.c 第 896 行定义.

{
    UINT32 ret = OsProcessInit();
    if (ret != LOS_OK) {
        return ret;
    }
 
    LosProcessCB *kerInitProcess = OS_PCB_FROM_PID(g_kernelInitProcess);//获取进程池中2号实体
    ret = OsProcessCreateInit(kerInitProcess, OS_KERNEL_MODE, "KProcess");//创建内核态祖宗进程
    if (ret != LOS_OK) {
        return ret;
    }
 
    kerInitProcess->processStatus &= ~OS_PROCESS_STATUS_INIT;//去掉初始化标签
    g_processGroup = kerInitProcess->group;//进程组ID就是2号进程本身
    LOS_ListInit(&g_processGroup->groupList);//初始化进程组链表
 
    LosProcessCB *idleProcess = OS_PCB_FROM_PID(g_kernelIdleProcess);//获取进程池中0号实体
    ret = OsInitPCB(idleProcess, OS_KERNEL_MODE, "KIdle");//创建内核态0号进程
    if (ret != LOS_OK) {
        return ret;
    }
    idleProcess->parentProcessID = kerInitProcess->processID;//认2号进程为父,它可是长子.
    LOS_ListTailInsert(&kerInitProcess->childrenList, &idleProcess->siblingList);//挂到内核态祖宗进程的子孙链接上
    idleProcess->group = kerInitProcess->group;//和老祖宗一个进程组,注意是父子并不代表是朋友.
    LOS_ListTailInsert(&kerInitProcess->group->processList, &idleProcess->subordinateGroupList);//挂到老祖宗的进程组链表上,进入了老祖宗的朋友圈.
#ifdef LOSCFG_SECURITY_CAPABILITY
    idleProcess->user = kerInitProcess->user;//共享用户
#endif
#ifdef LOSCFG_FS_VFS
    idleProcess->files = kerInitProcess->files;//共享文件
#endif
    idleProcess->processStatus &= ~OS_PROCESS_STATUS_INIT;
 
    ret = OsIdleTaskCreate();//创建cpu的idle任务,从此当前CPU OsPercpuGet()->idleTaskID 有了休息的地方.
    if (ret != LOS_OK) {
        return ret;
    }
    idleProcess->threadGroupID = OsGetIdleTaskId();
 
    return LOS_OK;
}

函数调用图:

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

OsUserInitProcess()

LITE_OS_SEC_TEXT_INIT UINT32 OsUserInitProcess

(

VOID

)

在文件 los_process.c 第 1746 行定义.

{
    UINT32 ret;
    UINT32 size;
    TSK_INIT_PARAM_S param = { 0 };
    VOID *stack = NULL;
 
    LosProcessCB *processCB = OS_PCB_FROM_PID(g_userInitProcess);
    ret = OsProcessCreateInit(processCB, OS_USER_MODE, "Init");
    if (ret != LOS_OK) {
        return ret;
    }
 
    ret = OsLoadUserInit(processCB);
    if (ret != LOS_OK) {
        goto ERROR;
    }
 
    stack = OsUserInitStackAlloc(processCB, &size);
    if (stack == NULL) {
        PRINT_ERR("Alloc user init process user stack failed!\n");
        goto ERROR;
    }
 
    param.pfnTaskEntry = (TSK_ENTRY_FUNC)(CHAR *)&__user_init_entry;
    param.userParam.userSP = (UINTPTR)stack + size;
    param.userParam.userMapBase = (UINTPTR)stack;
    param.userParam.userMapSize = size;
    param.uwResved = OS_TASK_FLAG_PTHREAD_JOIN;
    ret = OsUserInitProcessStart(processCB, &param);
    if (ret != LOS_OK) {
        (VOID)OsUnMMap(processCB->vmSpace, param.userParam.userMapBase, param.userParam.userMapSize);
        goto ERROR;
    }
 
    return LOS_OK;
 
ERROR:
    OsDeInitPCB(processCB);
    return ret;
}

函数调用图:

OsUserInitProcessStart()

STATIC UINT32 OsUserInitProcessStart	(	LosProcessCB *	processCB,
		TSK_INIT_PARAM_S *	param
	)

用户进程开始初始化

在文件 los_process.c 第 1648 行定义.

{
    UINT32 intSave;
    INT32 ret;
 
    UINT32 taskID = OsCreateUserTask(processCB->processID, param);
    if (taskID == OS_INVALID_VALUE) {
        return LOS_NOK;
    }
 
    ret = LOS_SetProcessPriority(processCB->processID, OS_PROCESS_USERINIT_PRIORITY);
    if (ret != LOS_OK) {
        PRINT_ERR("User init process set priority failed! ERROR:%d \n", ret);
        goto EXIT;
    }
 
    SCHEDULER_LOCK(intSave);
    processCB->processStatus &= ~OS_PROCESS_STATUS_INIT;
    SCHEDULER_UNLOCK(intSave);
 
    ret = LOS_SetTaskScheduler(taskID, LOS_SCHED_RR, OS_TASK_PRIORITY_LOWEST);//调度器:设置为抢占式调度和最低任务优先级(31级)
    if (ret != LOS_OK) {
        PRINT_ERR("User init process set scheduler failed! ERROR:%d \n", ret);
        goto EXIT;
    }
 
    return LOS_OK;
 
EXIT:
    (VOID)LOS_TaskDelete(taskID);
    return ret;
}

函数调用图:

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

OsUserInitStackAlloc()

STATIC VOID * OsUserInitStackAlloc	(	LosProcessCB *	processCB,
		UINT32 *	size
	)

在文件 los_process.c 第 1510 行定义.

{
    LosVmMapRegion *region = NULL;
    UINT32 stackSize = ALIGN(OS_USER_TASK_STACK_SIZE, PAGE_SIZE);//1M栈空间 按页对齐
    //线性区分配虚拟内存
    region = LOS_RegionAlloc(processCB->vmSpace, 0, stackSize,
                             VM_MAP_REGION_FLAG_PERM_USER | VM_MAP_REGION_FLAG_PERM_READ |
                             VM_MAP_REGION_FLAG_PERM_WRITE, 0);//可使用可读可写区
    if (region == NULL) {
        return NULL;
    }
 
    LOS_SetRegionTypeAnon(region);//匿名映射
    region->regionFlags |= VM_MAP_REGION_FLAG_STACK;//标记该线性区为栈区
 
    *size = stackSize;//记录栈大小
 
    return (VOID *)(UINTPTR)region->range.base;
}

函数调用图:

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

OsWait()

STATIC INT32 OsWait	(	INT32	pid,
		USER INT32 *	status,
		USER siginfo_t *	info,
		UINT32	options,
		VOID *	rusage
	)

等待子进程结束并回收子进程,返回已经终止的子进程的进程ID号，并清除僵死进程。

在文件 los_process.c 第 1265 行定义.

{
    (VOID)rusage;
    UINT32 ret;
    UINT32 intSave;
    LosProcessCB *childCB = NULL;
 
    LosProcessCB *processCB = OsCurrProcessGet();
    LosTaskCB *runTask = OsCurrTaskGet();
    SCHEDULER_LOCK(intSave);
    ret = OsWaitChildProcessCheck(processCB, pid, &childCB);//先检查下看能不能找到参数要求的退出子进程
    if (ret != LOS_OK) {
        pid = -ret;
        goto ERROR;
    }
 
    if (childCB != NULL) {//找到了进程
        return (INT32)OsWaitRecycleChildProcess(childCB, intSave, status, info);
    }
    //没有找到,看是否要返回还是去做个登记
    if ((options & LOS_WAIT_WNOHANG) != 0) {//有LOS_WAIT_WNOHANG标签
        runTask->waitFlag = 0;//等待标识置0
        pid = 0;//这里置0,是为了 return 0
        goto ERROR;
    }
    //等待孩子进程退出
    OsWaitInsertWaitListInOrder(runTask, processCB);//将当前任务挂入进程waitList链表
    //发起调度的目的是为了让出CPU,让其他进程/任务运行
    
    runTask->waitFlag = 0;
    if (runTask->waitID == OS_INVALID_VALUE) {
        pid = -LOS_ECHILD;//没有此子进程
        goto ERROR;
    }
 
    childCB = OS_PCB_FROM_PID(runTask->waitID);//获取当前任务的等待子进程ID
    if (!(childCB->processStatus & OS_PROCESS_STATUS_ZOMBIES)) {//子进程非僵死进程
        pid = -LOS_ESRCH;//没有此进程
        goto ERROR;
    }
    //回收僵死进程
    return (INT32)OsWaitRecycleChildProcess(childCB, intSave, status, info);
 
ERROR:
    SCHEDULER_UNLOCK(intSave);
    return pid;
}

函数调用图:

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

OsWaitCheckAndWakeParentProcess()

STATIC VOID OsWaitCheckAndWakeParentProcess	(	LosProcessCB *	parentCB,
		const LosProcessCB *	processCB
	)

检查父进程的等待任务并唤醒父进程去处理等待任务

在文件 los_process.c 第 368 行定义.

{
    LOS_DL_LIST *head = &parentCB->waitList;
    LOS_DL_LIST *list = NULL;
    LosTaskCB *taskCB = NULL;
    BOOL findSpecified = FALSE;
 
    if (LOS_ListEmpty(&parentCB->waitList)) {//父进程中是否有在等待子进程退出的任务?
        return;//没有就退出
    }
    // TODO 
    findSpecified = OsWaitWakeSpecifiedProcess(head, processCB, &list);//找到指定的任务
    if (findSpecified == TRUE) {
        /* No thread is waiting for any child process to finish */
        if (LOS_ListEmpty(&parentCB->waitList)) {//没有线程正在等待任何子进程结束
            return;//已经处理完了,注意在OsWaitWakeSpecifiedProcess中做了频繁的任务切换
        } else if (!LOS_ListEmpty(&parentCB->childrenList)) {
            /* Other child processes exist, and other threads that are waiting
             * for the child to finish continue to wait
             *///存在其他子进程，正在等待它们的子进程结束而将继续等待
            return;
        }
    }
 
    /* Waiting threads are waiting for a specified child process to finish */
    if (list == NULL) {//等待线程正在等待指定的子进程结束
        return;
    }
 
    /* No child processes exist and all waiting threads are awakened */
    if (findSpecified == TRUE) {//所有等待的任务都被一一唤醒
        while (list->pstNext != head) {
            taskCB = OS_TCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(list));
            OsWaitWakeTask(taskCB, OS_INVALID_VALUE);
        }
        return;
    }
 
    while (list->pstNext != head) {//处理 OS_PROCESS_WAIT_GID 标签
        taskCB = OS_TCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(list));
        if (taskCB->waitFlag == OS_PROCESS_WAIT_GID) {
            if (taskCB->waitID != processCB->group->groupID) {
                list = list->pstNext;
                continue;
            }
        }
 
        if (findSpecified == FALSE) {
            OsWaitWakeTask(taskCB, processCB->processID);
            findSpecified = TRUE;
        } else {
            OsWaitWakeTask(taskCB, OS_INVALID_VALUE);
        }
 
        if (!LOS_ListEmpty(&parentCB->childrenList)) {
            break;
        }
    }
 
    return;
}

函数调用图:

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

OsWaitChildProcessCheck()

STATIC UINT32 OsWaitChildProcessCheck	(	LosProcessCB *	processCB,
		INT32	pid,
		LosProcessCB **	childCB
	)

检查要等待的孩子进程

在文件 los_process.c 第 1236 行定义.

{   //当进程没有孩子且没有退出的孩子进程
    if (LOS_ListEmpty(&(processCB->childrenList)) && LOS_ListEmpty(&(processCB->exitChildList))) {
        return LOS_ECHILD;
    }
 
    return OsWaitSetFlag(processCB, pid, childCB);//设置等待子进程退出方式方法
}

函数调用图:

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

OsWaitidOptionsCheck()

STATIC UINT32 OsWaitidOptionsCheck

(

UINT32

options

)

在文件 los_process.c 第 1326 行定义.

{
    UINT32 flag = LOS_WAIT_WNOHANG | LOS_WAIT_WSTOPPED | LOS_WAIT_WCONTINUED | LOS_WAIT_WEXITED | LOS_WAIT_WNOWAIT;
 
    flag = ~flag & options;
    if ((flag != 0) || (options == 0)) {
        return LOS_EINVAL;
    }
 
    /*
     * only support LOS_WAIT_WNOHANG | LOS_WAIT_WEXITED
     * notsupport LOS_WAIT_WSTOPPED | LOS_WAIT_WCONTINUED | LOS_WAIT_WNOWAIT
     */
    if ((options & (LOS_WAIT_WSTOPPED | LOS_WAIT_WCONTINUED | LOS_WAIT_WNOWAIT)) != 0) {
        return LOS_EOPNOTSUPP;
    }
 
    if (OS_INT_ACTIVE) {
        return LOS_EINTR;
    }
 
    return LOS_OK;
}

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

OsWaitInsertWaitListInOrder()

STATIC VOID OsWaitInsertWaitListInOrder	(	LosTaskCB *	runTask,
		LosProcessCB *	processCB
	)

将任务挂入进程的waitList链表,表示这个任务在等待某个进程的退出 当被等待进程退出时候会将自己挂到父进程的退出子进程链表和进程组的退出进程链表.

在文件 los_process.c 第 1092 行定义.

{
    LOS_DL_LIST *head = &processCB->waitList;
    LOS_DL_LIST *list = head;
    LosTaskCB *taskCB = NULL;
 
    if (runTask->waitFlag == OS_PROCESS_WAIT_GID) {
        while (list->pstNext != head) {
            taskCB = OS_TCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(list));
            if (taskCB->waitFlag == OS_PROCESS_WAIT_PRO) {
                list = list->pstNext;
                continue;
            }
            break;
        }
    } else if (runTask->waitFlag == OS_PROCESS_WAIT_ANY) {
        while (list->pstNext != head) {
            taskCB = OS_TCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(list));
            if (taskCB->waitFlag != OS_PROCESS_WAIT_ANY) {
                list = list->pstNext;
                continue;
            }
            break;
        }
    }
    /* if runTask->waitFlag == OS_PROCESS_WAIT_PRO,
     * this node is inserted directly into the header of the waitList
     */
    (VOID)runTask->ops->wait(runTask, list->pstNext, LOS_WAIT_FOREVER);
    return;
}

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

OsWaitOptionsCheck()

STATIC UINT32 OsWaitOptionsCheck

(

UINT32

options

)

在文件 los_process.c 第 1245 行定义.

{
    UINT32 flag = LOS_WAIT_WNOHANG | LOS_WAIT_WUNTRACED | LOS_WAIT_WCONTINUED;
 
    flag = ~flag & options;
    if (flag != 0) {//三种方式中一种都没有
        return LOS_EINVAL;//无效参数
    }
 
    if ((options & (LOS_WAIT_WCONTINUED | LOS_WAIT_WUNTRACED)) != 0) {//暂不支持这两种方式.
        return LOS_EOPNOTSUPP;//不支持
    }
 
    if (OS_INT_ACTIVE) {//中断发生期间
        return LOS_EINTR;//中断提示
    }
 
    return LOS_OK;
}   

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

OsWaitRecycleChildProcess()

STATIC UINT32 OsWaitRecycleChildProcess	(	const LosProcessCB *	childCB,
		UINT32	intSave,
		INT32 *	status,
		siginfo_t *	info
	)

等待回收孩子进程 @note_thinking 这样写Porcess不太好吧

在文件 los_process.c 第 1181 行定义.

{
    ProcessGroup *group = NULL;
    UINT32 pid = childCB->processID;
    UINT16 mode = childCB->processMode;
    INT32 exitCode = childCB->exitCode;
    UINT32 uid = 0;
 
#ifdef LOSCFG_SECURITY_CAPABILITY
    if (childCB->user != NULL) {
        uid = childCB->user->userID;
    }
#endif
 
    OsRecycleZombiesProcess((LosProcessCB *)childCB, &group);//回收僵尸进程
    SCHEDULER_UNLOCK(intSave);
 
    if (status != NULL) {
        if (mode == OS_USER_MODE) {//孩子为用户态进程
            (VOID)LOS_ArchCopyToUser((VOID *)status, (const VOID *)(&(exitCode)), sizeof(INT32));//从内核空间拷贝退出码
        } else {
            *status = exitCode;
        }
    }
    /* get signal info */
    if (info != NULL) {
        siginfo_t tempinfo = { 0 };
 
        tempinfo.si_signo = SIGCHLD;
        tempinfo.si_errno = 0;
        tempinfo.si_pid = pid;
        tempinfo.si_uid = uid;
        /*
         * Process exit code
         * 31    15           8           7        0
         * |     | exit code  | core dump | signal |
         */
        if ((exitCode & 0x7f) == 0) {
            tempinfo.si_code = CLD_EXITED;
            tempinfo.si_status = (exitCode >> 8U);
        } else {
            tempinfo.si_code = (exitCode & 0x80) ? CLD_DUMPED : CLD_KILLED;
            tempinfo.si_status = (exitCode & 0x7f);
        }
 
        if (mode == OS_USER_MODE) {
            (VOID)LOS_ArchCopyToUser((VOID *)(info), (const VOID *)(&(tempinfo)), sizeof(siginfo_t));
        } else {
            (VOID)memcpy_s((VOID *)(info), sizeof(siginfo_t), (const VOID *)(&(tempinfo)), sizeof(siginfo_t));
        }
    }
    (VOID)LOS_MemFree(m_aucSysMem1, group);
    return pid;
}

函数调用图:

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

OsWaitSetFlag()

STATIC UINT32 OsWaitSetFlag	(	const LosProcessCB *	processCB,
		INT32	pid,
		LosProcessCB **	child
	)

设置等待子进程退出方式方法

在文件 los_process.c 第 1124 行定义.

{
    LosProcessCB *childCB = NULL;
    ProcessGroup *group = NULL;
    LosTaskCB *runTask = OsCurrTaskGet();
    UINT32 ret;
 
    if (pid > 0) {//等待进程号为pid的子进程结束
        /* Wait for the child process whose process number is pid. */
        childCB = OsFindExitChildProcess(processCB, pid);//看能否从退出的孩子链表中找到PID
        if (childCB != NULL) {//找到了,确实有一个已经退出的PID,注意一个进程退出时会挂到父进程的exitChildList上
            goto WAIT_BACK;//直接成功返回
        }
 
        ret = OsFindChildProcess(processCB, pid);//看能否从现有的孩子链表中找到PID
        if (ret != LOS_OK) {
            return LOS_ECHILD;//参数进程并没有这个PID孩子,返回孩子进程失败.
        }
        runTask->waitFlag = OS_PROCESS_WAIT_PRO;//设置当前任务的等待类型
        runTask->waitID = pid;  //当前任务要等待进程ID结束
    } else if (pid == 0) {//等待同一进程组中的任何子进程
        /* Wait for any child process in the same process group */
        childCB = OsFindGroupExitProcess(processCB->group, OS_INVALID_VALUE);//看能否从退出的孩子链表中找到PID
        if (childCB != NULL) {//找到了,确实有一个已经退出的PID
            goto WAIT_BACK;//直接成功返回
        }
        runTask->waitID = processCB->group->groupID;//等待进程组的任意一个子进程结束
        runTask->waitFlag = OS_PROCESS_WAIT_GID;//设置当前任务的等待类型
    } else if (pid == -1) {//等待任意子进程
        /* Wait for any child process */
        childCB = OsFindExitChildProcess(processCB, OS_INVALID_VALUE);//看能否从退出的孩子链表中找到PID
        if (childCB != NULL) {//找到了,确实有一个已经退出的PID
            goto WAIT_BACK;
        }
        runTask->waitID = pid;//等待PID,这个PID可以和当前进程没有任何关系
        runTask->waitFlag = OS_PROCESS_WAIT_ANY;//设置当前任务的等待类型
    } else { /* pid < -1 */ //等待指定进程组内为|pid|的所有子进程
        /* Wait for any child process whose group number is the pid absolute value. */
        group = OsFindProcessGroup(-pid);//先通过PID找到进程组
        if (group == NULL) {
            return LOS_ECHILD;
        }
 
        childCB = OsFindGroupExitProcess(group, OS_INVALID_VALUE);//在进程组里任意一个已经退出的子进程
        if (childCB != NULL) {
            goto WAIT_BACK;
        }
 
        runTask->waitID = -pid;//此处用负数是为了和(pid == 0)以示区别,因为二者的waitFlag都一样.
        runTask->waitFlag = OS_PROCESS_WAIT_GID;//设置当前任务的等待类型
    }
 
WAIT_BACK:
    *child = childCB;
    return LOS_OK;
}

函数调用图:

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

OsWaitWakeSpecifiedProcess()

STATIC BOOL OsWaitWakeSpecifiedProcess	(	LOS_DL_LIST *	head,
		const LosProcessCB *	processCB,
		LOS_DL_LIST **	anyList
	)

唤醒等待参数进程结束的任务

在文件 los_process.c 第 336 行定义.

{
    LOS_DL_LIST *list = head;
    LosTaskCB *taskCB = NULL;
    UINT32 pid = 0;
    BOOL find = FALSE;
 
    while (list->pstNext != head) {//遍历等待链表 processCB->waitList
        taskCB = OS_TCB_FROM_PENDLIST(LOS_DL_LIST_FIRST(list));//一个一个来
        if ((taskCB->waitFlag == OS_PROCESS_WAIT_PRO) && (taskCB->waitID == processCB->processID)) {//符合OS_PROCESS_WAIT_PRO方式的
            if (pid == 0) {
                pid = processCB->processID;//等待的进程
                find = TRUE;//找到了
            } else {// @note_thinking 这个代码有点多余吧,会执行到吗?
                pid = OS_INVALID_VALUE;
            }
 
            OsWaitWakeTask(taskCB, pid);//唤醒这个任务,此时会切到 LOS_Wait runTask->waitFlag = 0;处运行
            continue;
        }
 
        if (taskCB->waitFlag != OS_PROCESS_WAIT_PRO) {
            *anyList = list;
            break;
        }
        list = list->pstNext;
    }
 
    return find;
}

函数调用图:

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

OsWaitWakeTask()

VOID OsWaitWakeTask	(	LosTaskCB *	taskCB,
		UINT32	wakePID
	)

唤醒等待wakePID结束的任务

在文件 los_process.c 第 326 行定义.

{
    taskCB->waitID = wakePID;
    taskCB->ops->wake(taskCB);
#ifdef LOSCFG_KERNEL_SMP
    LOS_MpSchedule(OS_MP_CPU_ALL);//向所有cpu发送调度指令
#endif
}

函数调用图:

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

ThreadGroupActiveTaskKilled()

STATIC VOID ThreadGroupActiveTaskKilled

(

LosTaskCB *

taskCB

)

按指定状态退出指定进程

The other core that the thread is running on and is currently running in a non-system call

在文件 los_process.c 第 2167 行定义.

{
    INT32 ret;
 
    taskCB->taskStatus |= OS_TASK_FLAG_EXIT_KILL;
#ifdef LOSCFG_KERNEL_SMP
    /** The other core that the thread is running on and is currently running in a non-system call */
    if (!taskCB->sig.sigIntLock && (taskCB->taskStatus & OS_TASK_STATUS_RUNNING)) {
        taskCB->signal = SIGNAL_KILL;
        LOS_MpSchedule(taskCB->currCpu);
    } else
#endif
    {
        ret = OsTaskKillUnsafe(taskCB->taskID, SIGKILL);
        if (ret != LOS_OK) {
            PRINT_ERR("pid %u exit, Exit task group %u kill %u failed! ERROR: %d\n",
                      taskCB->processID, OsCurrTaskGet()->taskID, taskCB->taskID, ret);
        }
    }
 
    if (!(taskCB->taskStatus & OS_TASK_FLAG_PTHREAD_JOIN)) {
        taskCB->taskStatus |= OS_TASK_FLAG_PTHREAD_JOIN;
        LOS_ListInit(&taskCB->joinList);
    }
 
    ret = OsTaskJoinPendUnsafe(taskCB);
    if (ret != LOS_OK) {
        PRINT_ERR("pid %u exit, Exit task group %u to wait others task %u(0x%x) exit failed! ERROR: %d\n",
                  taskCB->processID, OsCurrTaskGet()->taskID, taskCB->taskID, taskCB->taskStatus, ret);
    }
}

函数调用图:

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

变量说明

g_freeProcess

LITE_OS_SEC_DATA_INIT STATIC LOS_DL_LIST g_freeProcess

空闲状态下的进程链表, .个人觉得应该取名为 g_freeProcessList @note_thinking

在文件 los_process.c 第 81 行定义.

g_kernelIdleProcess

LITE_OS_SEC_BSS UINT32 g_kernelIdleProcess = OS_INVALID_VALUE

0号进程 内核态idle进程,由Kprocess fork

在文件 los_process.c 第 85 行定义.

g_kernelInitProcess

LITE_OS_SEC_BSS UINT32 g_kernelInitProcess = OS_INVALID_VALUE

2号进程 内核态初始Kprocess进程,内核态下其他进程由它 fork

在文件 los_process.c 第 84 行定义.

g_processCBArray

LITE_OS_SEC_BSS LosProcessCB* g_processCBArray = NULL

进程池数组

进程池 OsProcessInit

在文件 los_process.c 第 80 行定义.

g_processGroup

LITE_OS_SEC_BSS ProcessGroup* g_processGroup = NULL

全局进程组,负责管理所有进程组

在文件 los_process.c 第 87 行定义.

g_processMaxNum

LITE_OS_SEC_BSS UINT32 g_processMaxNum

进程最大数量,默认64个

进程最大数量

在文件 los_process.c 第 86 行定义.

g_processRecycleList

LITE_OS_SEC_DATA_INIT STATIC LOS_DL_LIST g_processRecycleList

需要回收的进程列表

在文件 los_process.c 第 82 行定义.

g_userInitProcess

LITE_OS_SEC_BSS UINT32 g_userInitProcess = OS_INVALID_VALUE

1号进程 用户态的初始init进程,用户态下其他进程由它 fork

在文件 los_process.c 第 83 行定义.