capability_api.h 文件参考

浏览源代码.

函数
BOOL	IsCapPermit (UINT32 capIndex)
VOID	OsInitCapability (LosProcessCB *processCB)
	初始化进程安全能力 更多...
VOID	OsCopyCapability (LosProcessCB *from, LosProcessCB *to)
	进程间安全能力的拷贝 更多...
UINT32	SysCapSet (UINT32 caps)
	为进程设置权限项 更多...
UINT32	SysCapGet (pid_t pid, UINT32 *caps)
	获取参数进程的权限集 更多...

函数说明

IsCapPermit()

BOOL IsCapPermit

(

UINT32

capIndex

)

在文件 capability.c 第 43 行定义.

{
    UINT32 capability = OsCurrProcessGet()->capability;
    if (capIndex > CAPABILITY_MAX || capIndex < 0) {
        PRINTK("%s,%d, get invalid capIndex %u\n", __FUNCTION__, __LINE__, capIndex);
        return FALSE;
    }
 
    return (capability & (CAPABILITY_GET_CAP_MASK(capIndex)));
}

函数调用图:

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

OsCopyCapability()

VOID OsCopyCapability	(	LosProcessCB *	from,
		LosProcessCB *	to
	)

进程间安全能力的拷贝

在文件 capability.c 第 59 行定义.

{
    UINT32 intSave;
 
    SCHEDULER_LOCK(intSave);
    to->capability = from->capability;
    SCHEDULER_UNLOCK(intSave);
}

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

OsInitCapability()

VOID OsInitCapability

(

LosProcessCB *

processCB

)

初始化进程安全能力

在文件 capability.c 第 54 行定义.

{
    processCB->capability = CAPABILITY_INIT_STAT;
}

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

SysCapGet()

UINT32 SysCapGet	(	pid_t	pid,
		UINT32 *	caps
	)

获取参数进程的权限集

在文件 capability.c 第 88 行定义.

{
    UINT32 intSave;
    UINT32 kCaps;
    LosProcessCB *processCB = NULL;
 
    if ((OS_PID_CHECK_INVALID((UINT32)pid))) {
        return -EINVAL;
    }
 
    if (pid == 0) {
        processCB = OsCurrProcessGet();
    } else {
        processCB = OS_PCB_FROM_PID(pid);
    }
 
    SCHEDULER_LOCK(intSave);
    if (OsProcessIsInactive(processCB)) {
        SCHEDULER_UNLOCK(intSave);
        return -ESRCH;
    }
 
    kCaps = processCB->capability;
    SCHEDULER_UNLOCK(intSave);
    //@note_thinking 感觉这里可以不用 LOS_ArchCopyToUser 直接返回kCaps
    if (LOS_ArchCopyToUser(caps, &kCaps, sizeof(UINT32)) != LOS_OK) {//内核空间向用户空间拷贝 
        return -EFAULT;
    }
 
    return LOS_OK;
}

函数调用图:

SysCapSet()

UINT32 SysCapSet

(

UINT32

caps

)

为进程设置权限项

在文件 capability.c 第 68 行定义.

{
    UINT32 intSave;
 
    SCHEDULER_LOCK(intSave);
    if (!IsCapPermit(CAP_CAPSET)) {//先检查进程是否有权限
        SCHEDULER_UNLOCK(intSave);
        return -EPERM;
    }
 
    if (VALID_CAPS(caps, OsCurrProcessGet()->capability)) {//验证参数有效性
        SCHEDULER_UNLOCK(intSave);
        return -EPERM;
    }
 
    OsCurrProcessGet()->capability = caps;//改变当前进程的权限集,相当于自己给自己加减权限
    SCHEDULER_UNLOCK(intSave);
    return LOS_OK;
}

函数调用图: