los_excinfo.c 文件参考

浏览源代码.

函数
VOID	SetExcInfoRW (log_read_write_fn func)
log_read_write_fn	GetExcInfoRW (VOID)
	获取异常信息读写函数 更多...
VOID	SetExcInfoBuf (CHAR *buf)
	设置异常信息的缓存 更多...
CHAR *	GetExcInfoBuf (VOID)
	获取异常信息的缓存 更多...
VOID	SetExcInfoIndex (UINT32 index)
	设置异常信息索引位 更多...
UINT32	GetExcInfoIndex (VOID)
	获取异常信息索引位 更多...
VOID	SetRecordAddr (UINT32 addr)
UINT32	GetRecordAddr (VOID)
VOID	SetRecordSpace (UINT32 space)
UINT32	GetRecordSpace (VOID)
VOID	WriteExcBufVa (const CHAR *format, va_list arglist)
	vsnprintf 为C标准库可变参数的实现函数 见于 ..\third_party\musl\kernel\src\stdio\vsnprintf.c 更多...
VOID	WriteExcInfoToBuf (const CHAR *format,...)
	写异常信息到系统异常信息中心 更多...
VOID	LOS_ExcInfoRegHook (UINT32 startAddr, UINT32 space, CHAR *buf, log_read_write_fn hook)
	用于注册记录异常信息函数，并指定位置、空间和大小 更多...
VOID	OsReadWriteExceptionInfo (UINT32 startAddr, UINT32 space, UINT32 flag, CHAR *buf)
VOID	OsRecordExcInfoTime (VOID)
	记录异常信息产生的时间 更多...
INT32	OsShellCmdReadExcInfo (INT32 argc, CHAR **argv)
	SHELLCMD_ENTRY (readExcInfo_shellcmd, CMD_TYPE_EX, "excInfo", 0,(CmdCallBackFunc) OsShellCmdReadExcInfo)

变量
STATIC log_read_write_fn	g_excInfoRW = NULL
STATIC CHAR *	g_excInfoBuf = NULL
STATIC UINT32	g_excInfoIndex = 0xFFFFFFFF
STATIC UINT32	g_recordAddr = 0
STATIC UINT32	g_recordSpace = 0

函数说明

GetExcInfoBuf()

CHAR * GetExcInfoBuf

(

VOID

)

获取异常信息的缓存

在文件 los_excinfo.c 第 64 行定义.

{
    return g_excInfoBuf;
}

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

GetExcInfoIndex()

UINT32 GetExcInfoIndex

(

VOID

)

获取异常信息索引位

在文件 los_excinfo.c 第 74 行定义.

{
    return g_excInfoIndex;
}

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

GetExcInfoRW()

log_read_write_fn GetExcInfoRW

(

VOID

)

获取异常信息读写函数

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

{
    return g_excInfoRW;
}

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

GetRecordAddr()

UINT32 GetRecordAddr

(

VOID

)

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

{
    return g_recordAddr;
}

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

GetRecordSpace()

UINT32 GetRecordSpace

(

VOID

)

在文件 los_excinfo.c 第 94 行定义.

{
    return g_recordSpace;
}

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

OsReadWriteExceptionInfo()

VOID OsReadWriteExceptionInfo	(	UINT32	startAddr,
		UINT32	space,
		UINT32	flag,
		CHAR *	buf
	)

在文件 los_excinfo.c 第 140 行定义.

{
    if ((buf == NULL) || (space == 0)) {
        PRINT_ERR("buffer is null or space is zero\n");
        return;
    }
    // user can write exception information to files here
}

OsRecordExcInfoTime()

VOID OsRecordExcInfoTime

(

VOID

)

记录异常信息产生的时间

在文件 los_excinfo.c 第 149 行定义.

{
#ifdef LOSCFG_FS_VFS
#define NOW_TIME_LENGTH 24
    time_t t;
    struct tm *tmTime = NULL;
    CHAR nowTime[NOW_TIME_LENGTH];
 
    (VOID)time(&t);
    tmTime = localtime(&t);//获取本地时间的标准C库函数
    if (tmTime == NULL) {
        return;
    }
    (VOID)memset_s(nowTime, sizeof(nowTime), 0, sizeof(nowTime));
    (VOID)strftime(nowTime, NOW_TIME_LENGTH, "%Y-%m-%d %H:%M:%S", tmTime);//生成时间格式
#undef NOW_TIME_LENGTH
    WriteExcInfoToBuf("%s \n", nowTime);
#endif
}

函数调用图:

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

OsShellCmdReadExcInfo()

INT32 OsShellCmdReadExcInfo	(	INT32	argc,
		CHAR **	argv
	)

在文件 los_excinfo.c 第 170 行定义.

{
#define EXCINFO_ALIGN_SIZE 64
    UINT32 recordSpace = GetRecordSpace();
 
    (VOID)argc;
    (VOID)argv;
 
    CHAR *buf = (CHAR *)LOS_MemAllocAlign((VOID *)OS_SYS_MEM_ADDR, recordSpace + 1, EXCINFO_ALIGN_SIZE);
    if (buf == NULL) {
        return LOS_NOK;
    }
    (VOID)memset_s(buf, recordSpace + 1, 0, recordSpace + 1);
 
    log_read_write_fn hook = GetExcInfoRW();
    if (hook != NULL) {
        hook(GetRecordAddr(), recordSpace, 1, buf);
    }
    PRINTK("%s\n", buf);
    (VOID)LOS_MemFree((void *)OS_SYS_MEM_ADDR, buf);
    buf = NULL;
    return LOS_OK;
}

函数调用图:

SetExcInfoBuf()

VOID SetExcInfoBuf

(

CHAR *

buf

)

设置异常信息的缓存

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

{
    g_excInfoBuf = buf;
}

SetExcInfoIndex()

VOID SetExcInfoIndex

(

UINT32

index

)

设置异常信息索引位

在文件 los_excinfo.c 第 69 行定义.

{
    g_excInfoIndex = index;
}

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

SetExcInfoRW()

VOID SetExcInfoRW

(

log_read_write_fn

func

)

在文件 los_excinfo.c 第 49 行定义.

{
    g_excInfoRW = func;
}

SetRecordAddr()

VOID SetRecordAddr

(

UINT32

addr

)

在文件 los_excinfo.c 第 79 行定义.

{
    g_recordAddr = addr;
}

SetRecordSpace()

VOID SetRecordSpace

(

UINT32

space

)

在文件 los_excinfo.c 第 89 行定义.

{
    g_recordSpace = space;
}

SHELLCMD_ENTRY()

SHELLCMD_ENTRY	(	readExcInfo_shellcmd	,
		CMD_TYPE_EX	,
		"excInfo"	,
		0	,
		(CmdCallBackFunc)	OsShellCmdReadExcInfo
	)

WriteExcBufVa()

VOID WriteExcBufVa	(	const CHAR *	format,
		va_list	arglist
	)

vsnprintf 为C标准库可变参数的实现函数 见于 ..\third_party\musl\kernel\src\stdio\vsnprintf.c

在文件 los_excinfo.c 第 99 行定义.

{
    errno_t ret;
 
    if (g_recordSpace > g_excInfoIndex) {
        ret = vsnprintf_s((g_excInfoBuf + g_excInfoIndex), (g_recordSpace - g_excInfoIndex),
                          (g_recordSpace - g_excInfoIndex - 1), format, arglist);
        if (ret == -1) {
            PRINT_ERR("exc info buffer is not enough or vsnprintf_s is error.\n");
            return;
        }
        g_excInfoIndex += ret;
    }
}

函数调用图:

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

WriteExcInfoToBuf()

VOID WriteExcInfoToBuf	(	const CHAR *	format,
			...
	)

写异常信息到系统异常信息中心

在文件 los_excinfo.c 第 114 行定义.

{
    va_list arglist;//va_arg
    va_start(arglist, format);//从任务栈中取出入栈参数
    WriteExcBufVa(format, arglist);//入栈参数列表作为实参传入交由vsnprintf处理
    va_end(arglist);//释放资源
}

函数调用图:

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

变量说明

g_excInfoBuf

STATIC CHAR* g_excInfoBuf = NULL

在文件 los_excinfo.c 第 44 行定义.

g_excInfoIndex

STATIC UINT32 g_excInfoIndex = 0xFFFFFFFF

在文件 los_excinfo.c 第 45 行定义.

g_excInfoRW

STATIC log_read_write_fn g_excInfoRW = NULL

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

g_recordAddr

STATIC UINT32 g_recordAddr = 0

在文件 los_excinfo.c 第 46 行定义.

g_recordSpace

STATIC UINT32 g_recordSpace = 0

在文件 los_excinfo.c 第 47 行定义.