los_process_pri.h 文件参考

浏览源代码.

结构体
struct	User
struct	ProcessGroup
struct	ProcessCB

类型定义
typedef struct ProcessCB	LosProcessCB

函数
STATIC INLINE BOOL	OsProcessIsUnused (const LosProcessCB *processCB)
STATIC INLINE BOOL	OsProcessIsInactive (const LosProcessCB *processCB)
	进程不活跃函数定义:身上贴有不使用且不活跃标签的进程 更多...
STATIC INLINE BOOL	OsProcessIsDead (const LosProcessCB *processCB)
	进程死啦死啦的定义: 身上贴有不使用且状态为僵死的进程 更多...
STATIC INLINE BOOL	OsProcessIsInit (const LosProcessCB *processCB)
STATIC INLINE BOOL	OsProcessIsUserMode (const LosProcessCB *processCB)
STATIC INLINE VOID	OsProcessExitCodeCoreDumpSet (LosProcessCB *processCB)
	置进程退出码第七位为1 更多...
STATIC INLINE VOID	OsProcessExitCodeSignalSet (LosProcessCB *processCB, UINT32 signal)
	设置进程退出信号(0 ~ 7) 更多...
STATIC INLINE VOID	OsProcessExitCodeSignalClear (LosProcessCB *processCB)
	清除进程退出信号(0 ~ 7) 更多...
STATIC INLINE BOOL	OsProcessExitCodeSignalIsSet (LosProcessCB *processCB)
	进程退出码是否被设置过,默认是 0 ,如果 & 0x7FU 还是 0 ,说明没有被设置过. 更多...
STATIC INLINE VOID	OsProcessExitCodeSet (LosProcessCB *processCB, UINT32 code)
	设置进程退出号(8 ~ 15) 更多...
STATIC INLINE BOOL	OsProcessIDUserCheckInvalid (UINT32 pid)
STATIC INLINE LosProcessCB *	OsCurrProcessGet (VOID)
STATIC INLINE User *	OsCurrUserGet (VOID)
STATIC INLINE UINT32	OsProcessUserIDGet (const LosTaskCB *taskCB)
STATIC INLINE UINT32	OsProcessThreadGroupIDGet (const LosTaskCB *taskCB)
STATIC INLINE UINT32	OsProcessThreadNumberGet (const LosTaskCB *taskCB)
STATIC INLINE LosVmSpace *	OsProcessVmSpaceGet (const LosProcessCB *processCB)
STATIC INLINE struct Vnode *	OsProcessExecVnodeGet (const LosProcessCB *processCB)
UINT32	OsSystemProcessCreate (VOID)
VOID	OsProcessNaturalExit (LosProcessCB *processCB, UINT32 status)
VOID	OsProcessCBRecycleToFree (VOID)
VOID	OsProcessResourcesToFree (LosProcessCB *processCB)
UINT32	OsUserInitProcess (VOID)
INT32	OsClone (UINT32 flags, UINTPTR sp, UINT32 size)
	OsClone 进程克隆 更多...
VOID	OsExecProcessVmSpaceRestore (LosVmSpace *oldSpace)
LosVmSpace *	OsExecProcessVmSpaceReplace (LosVmSpace *newSpace, UINTPTR stackBase, INT32 randomDevFD)
UINT32	OsExecRecycleAndInit (LosProcessCB *processCB, const CHAR *name, LosVmSpace *oldAspace, UINTPTR oldFiles)
	进程的回收再利用,被LOS_DoExecveFile调用 更多...
UINT32	OsExecStart (const TSK_ENTRY_FUNC entry, UINTPTR sp, UINTPTR mapBase, UINT32 mapSize)
	执行用户态任务, entry为入口函数 ,其中 创建好task,task上下文 等待调度真正执行, sp:栈指针 mapBase:栈底 mapSize:栈大小 更多...
UINT32	OsSetProcessName (LosProcessCB *processCB, const CHAR *name)
INT32	OsSetProcessScheduler (INT32 which, INT32 pid, UINT16 prio, UINT16 policy)
	设置进程调度计划 更多...
INT32	OsGetProcessPriority (INT32 which, INT32 pid)
	接口封装 - 获取进程优先级 which:标识进程,进程组,用户 更多...
UINT32	OsGetUserInitProcessID (VOID)
	获取用户态进程的根进程,所有用户进程都是g_processCBArray[g_userInitProcess] fork来的 更多...
UINT32	OsGetIdleProcessID (VOID)
	获取内核态空闲进程 更多...
INT32	OsSetProcessGroupID (UINT32 pid, UINT32 gid)
INT32	OsSetCurrProcessGroupID (UINT32 gid)
UINT32	OsGetKernelInitProcessID (VOID)
	获取内核态根进程 更多...
VOID	OsSetSigHandler (UINTPTR addr)
	设置进程的信号处理函数 更多...
UINTPTR	OsGetSigHandler (VOID)
	获取进程的信号处理函数 更多...
VOID	OsWaitWakeTask (LosTaskCB *taskCB, UINT32 wakePID)
INT32	OsSendSignalToProcessGroup (INT32 pid, siginfo_t *info, INT32 permission)
INT32	OsSendSignalToAllProcess (siginfo_t *info, INT32 permission)
UINT32	OsProcessAddNewTask (UINT32 pid, LosTaskCB *taskCB, SchedParam *param)
VOID	OsDeleteTaskFromProcess (LosTaskCB *taskCB)
VOID	OsProcessThreadGroupDestroy (VOID)

变量
LosProcessCB *	g_processCBArray
	进程池 OsProcessInit 更多...
UINT32	g_processMaxNum
	进程最大数量 更多...
UINTPTR	__user_init_entry
	第一个用户态进程(init)的入口地址 查看 LITE_USER_SEC_ENTRY 更多...
UINTPTR	__user_init_bss
	查看 LITE_USER_SEC_BSS ,赋值由liteos.ld完成 更多...
UINTPTR	__user_init_end
	init 进程的用户空间初始化结束地址 更多...
UINTPTR	__user_init_load_addr
	init 进程的加载地址 ,由链接器赋值 更多...

类型定义说明

LosProcessCB

typedef struct ProcessCB LosProcessCB

进程控制块.

函数说明

OsClone()

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);
}

函数调用图:

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

OsCurrProcessGet()

STATIC INLINE LosProcessCB * OsCurrProcessGet

(

VOID

)

获取当前进程PCB

在文件 los_process_pri.h 第 353 行定义.

{
    UINT32 intSave;
 
    intSave = LOS_IntLock();
    LosProcessCB *runProcess = OS_PCB_FROM_PID(OsCurrTaskGet()->processID);
    LOS_IntRestore(intSave);
    return runProcess;
}

函数调用图:

OsCurrUserGet()

STATIC INLINE User * OsCurrUserGet

(

VOID

)

获取当前进程的所属用户

在文件 los_process_pri.h 第 365 行定义.

{
    User *user = NULL;
    UINT32 intSave;
 
    intSave = LOS_IntLock();
    user = OsCurrProcessGet()->user;
    LOS_IntRestore(intSave);
    return user;
}

函数调用图:

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

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()

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()

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()

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()

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;
}

函数调用图:

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

OsGetIdleProcessID()

UINT32 OsGetIdleProcessID

(

VOID

)

获取内核态空闲进程

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

{
    return g_kernelIdleProcess;
}

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

OsGetKernelInitProcessID()

UINT32 OsGetKernelInitProcessID

(

VOID

)

获取内核态根进程

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

{
    return g_kernelInitProcess;
}

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

OsGetProcessPriority()

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()

UINTPTR OsGetSigHandler

(

VOID

)

获取进程的信号处理函数

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

{
    return OsCurrProcessGet()->sigHandler;
}

函数调用图:

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

OsGetUserInitProcessID()

UINT32 OsGetUserInitProcessID

(

VOID

)

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

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

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

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

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;
}

函数调用图:

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

OsProcessCBRecycleToFree()

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);
}

函数调用图:

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

OsProcessExecVnodeGet()

STATIC INLINE struct Vnode * OsProcessExecVnodeGet

(

const LosProcessCB *

processCB

)

在文件 los_process_pri.h 第 408 行定义.

{
    return processCB->execVnode;
}

OsProcessExitCodeCoreDumpSet()

STATIC INLINE VOID OsProcessExitCodeCoreDumpSet

(

LosProcessCB *

processCB

)

置进程退出码第七位为1

在文件 los_process_pri.h 第 318 行定义.

{
    processCB->exitCode |= 0x80U;   //  0b10000000 
}

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

OsProcessExitCodeSet()

STATIC INLINE VOID OsProcessExitCodeSet	(	LosProcessCB *	processCB,
		UINT32	code
	)

设置进程退出号(8 ~ 15)

在文件 los_process_pri.h 第 338 行定义.

{
    processCB->exitCode |= ((code & 0x000000FFU) << 8U) & 0x0000FF00U; /* 8: Move 8 bits to the left, exitCode */
}

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

OsProcessExitCodeSignalClear()

STATIC INLINE VOID OsProcessExitCodeSignalClear

(

LosProcessCB *

processCB

)

清除进程退出信号(0 ~ 7)

在文件 los_process_pri.h 第 328 行定义.

{
    processCB->exitCode &= (~0x7FU);// 低7位全部清0
}

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

OsProcessExitCodeSignalIsSet()

STATIC INLINE BOOL OsProcessExitCodeSignalIsSet

(

LosProcessCB *

processCB

)

进程退出码是否被设置过,默认是 0 ,如果 & 0x7FU 还是 0 ,说明没有被设置过.

在文件 los_process_pri.h 第 333 行定义.

{
    return (processCB->exitCode) & 0x7FU;
}

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

OsProcessExitCodeSignalSet()

STATIC INLINE VOID OsProcessExitCodeSignalSet	(	LosProcessCB *	processCB,
		UINT32	signal
	)

设置进程退出信号(0 ~ 7)

在文件 los_process_pri.h 第 323 行定义.

{
    processCB->exitCode |= signal & 0x7FU;// 0b01111111
}

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

OsProcessIDUserCheckInvalid()

STATIC INLINE BOOL OsProcessIDUserCheckInvalid

(

UINT32

pid

)

内联函数 进程ID是否有效

在文件 los_process_pri.h 第 348 行定义.

{
    return ((pid >= g_processMaxNum) || (pid == 0));
}

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

OsProcessIsDead()

STATIC INLINE BOOL OsProcessIsDead

(

const LosProcessCB *

processCB

)

进程死啦死啦的定义: 身上贴有不使用且状态为僵死的进程

Used to check if the process is dead.

在文件 los_process_pri.h 第 252 行定义.

{
    return ((processCB->processStatus & (OS_PROCESS_FLAG_UNUSED | OS_PROCESS_STATUS_ZOMBIES)) != 0);
}

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

OsProcessIsInactive()

STATIC INLINE BOOL OsProcessIsInactive

(

const LosProcessCB *

processCB

)

进程不活跃函数定义:身上贴有不使用且不活跃标签的进程

Used to check if the process is inactive.

在文件 los_process_pri.h 第 243 行定义.

{
    return ((processCB->processStatus & (OS_PROCESS_FLAG_UNUSED | OS_PROCESS_STATUS_INACTIVE)) != 0);
}

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

OsProcessIsInit()

STATIC INLINE BOOL OsProcessIsInit

(

const LosProcessCB *

processCB

)

在文件 los_process_pri.h 第 257 行定义.

{
    return (processCB->processStatus & OS_PROCESS_STATUS_INIT);
}

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

OsProcessIsUnused()

STATIC INLINE BOOL OsProcessIsUnused

(

const LosProcessCB *

processCB

)

Used to check if the process control block is unused.

在文件 los_process_pri.h 第 234 行定义.

{
    return ((processCB->processStatus & OS_PROCESS_FLAG_UNUSED) != 0);
}

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

OsProcessIsUserMode()

STATIC INLINE BOOL OsProcessIsUserMode

(

const LosProcessCB *

processCB

)

用户态进程

在文件 los_process_pri.h 第 299 行定义.

{
    return (processCB->processMode == OS_USER_MODE);
}

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

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()

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;
    }
}

函数调用图:

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

OsProcessThreadGroupDestroy()

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;
}

函数调用图:

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

OsProcessThreadGroupIDGet()

STATIC INLINE UINT32 OsProcessThreadGroupIDGet

(

const LosTaskCB *

taskCB

)

在文件 los_process_pri.h 第 390 行定义.

{
    return OS_PCB_FROM_PID(taskCB->processID)->threadGroupID;
}

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

OsProcessThreadNumberGet()

STATIC INLINE UINT32 OsProcessThreadNumberGet

(

const LosTaskCB *

taskCB

)

在文件 los_process_pri.h 第 395 行定义.

{
    return OS_PCB_FROM_PID(taskCB->processID)->threadNumber;
}

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

OsProcessUserIDGet()

STATIC INLINE UINT32 OsProcessUserIDGet

(

const LosTaskCB *

taskCB

)

在文件 los_process_pri.h 第 376 行定义.

{
    UINT32 intSave = LOS_IntLock();
    UINT32 uid = OS_INVALID;
 
    LosProcessCB *process = OS_PCB_FROM_PID(taskCB->processID);
    if (process->user != NULL) {
        uid = process->user->userID;
    }
    LOS_IntRestore(intSave);
    return uid;
}

函数调用图:

OsProcessVmSpaceGet()

STATIC INLINE LosVmSpace * OsProcessVmSpaceGet

(

const LosProcessCB *

processCB

)

在文件 los_process_pri.h 第 401 行定义.

{
    return processCB->vmSpace;
}

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

OsSendSignalToAllProcess()

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()

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);
}

函数调用图:

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

OsSetCurrProcessGroupID()

INT32 OsSetCurrProcessGroupID

(

UINT32

gid

)

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

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

函数调用图:

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

OsSetProcessGroupID()

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;
}

函数调用图:

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

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()

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()

VOID OsSetSigHandler

(

UINTPTR

addr

)

设置进程的信号处理函数

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

{
    OsCurrProcessGet()->sigHandler = addr;
}

函数调用图:

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

OsSystemProcessCreate()

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()

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;
}

函数调用图:

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
}

函数调用图:

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

变量说明

__user_init_bss

UINTPTR __user_init_bss

extern

查看 LITE_USER_SEC_BSS ,赋值由liteos.ld完成

__user_init_end

UINTPTR __user_init_end

extern

init 进程的用户空间初始化结束地址

__user_init_entry

UINTPTR __user_init_entry

extern

第一个用户态进程(init)的入口地址 查看 LITE_USER_SEC_ENTRY

__user_init_load_addr

UINTPTR __user_init_load_addr

extern

init 进程的加载地址 ,由链接器赋值

g_processCBArray

LosProcessCB* g_processCBArray

extern

进程池 OsProcessInit

进程池 OsProcessInit

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

g_processMaxNum

UINT32 g_processMaxNum

extern

进程最大数量

进程最大数量

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