dmesg.h 文件参考

浏览源代码.

函数
UINT32	LOS_DmesgMemSet (const VOID *addr, UINT32 size)
	Set dmesg buffer. 更多...
INT32	LOS_DmesgRead (CHAR *buf, UINT32 len)
	Read log from dmesg buffer. 更多...
VOID	LOS_DmesgClear (VOID)
	Clear dmesg log. 更多...
INT32	LOS_DmesgToFile (const CHAR *filename)
	Copy log to file. 更多...
UINT32	LOS_DmesgLvSet (UINT32 level)
	Set the dmesg level 更多...

函数说明

LOS_DmesgClear()

VOID LOS_DmesgClear

(

VOID

)

Clear dmesg log.

Description:

This API is used to clear dmesg log.

注意

None.

参数

None.

返回值

None.

Dependency:

• dmesg.h: the header file that contains the API declaration.

参见

LOS_DmesgClear

在文件 dmesg.c 第 621 行定义.

{
    UINT32 intSave;
 
    LOS_SpinLockSave(&g_dmesgSpin, &intSave);
    (VOID)memset_s(g_dmesgInfo->logBuf, g_logBufSize, 0, g_logBufSize);
    g_dmesgInfo->logHead = 0;
    g_dmesgInfo->logTail = 0;
    g_dmesgInfo->logSize = 0;
    LOS_SpinUnlockRestore(&g_dmesgSpin, intSave);
}

函数调用图:

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

LOS_DmesgLvSet()

UINT32 LOS_DmesgLvSet

(

UINT32

level

)

Set the dmesg level

Description:

This API is used to set the level of log that want to stored in dmesg buffer.

注意

• It would be useless if the level is less than print level.

参数

level

[IN] Type UINT32 The level expected to set, range from 0 to 5.

返回值

#1	Set dmesg level fail.
#0	Set dmesg level success.

Dependency:

• dmesg.h: the header file that contains the API declaration.

参见

LOS_DmesgLvSet

在文件 dmesg.c 第 611 行定义.

{
    if (level > 5) { /* 5: count of level */
        return LOS_NOK;
    }
 
    g_dmesgLogLevel = level;
    return LOS_OK;
}

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

LOS_DmesgMemSet()

UINT32 LOS_DmesgMemSet	(	const VOID *	addr,
		UINT32	size
	)

Set dmesg buffer.

Description:

This API is used to set dmesg buffer to memory-assigned, or just change the buffer size.

注意

• If the addr is NULL, this function will only change the buffer size.

参数

addr	[IN] Type #VOID* The addr of memory space to set.
size	[IN] Type UINT32 The dmesg buffer size to set, depend on the app user, should be a valid value, otherwise system will crash, and should not larger than MAX_KERNEL_LOG_BUF_SIZE.

返回值

#LOS_NOK	Set dmesg buffer fail.
#LOS_OK	Set dmesg buffer success.

Dependency:

• dmesg.h: the header file that contains the API declaration.

参见

LOS_DmesgMemSet

Set dmesg buffer.

在文件 dmesg.c 第 633 行定义.

{
    UINT32 ret = 0;
 
    if (addr == NULL) {
        ret = OsDmesgChangeSize(size);
    } else {
        ret = OsDmesgResetMem(addr, size);
    }
    return ret;
}

函数调用图:

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

LOS_DmesgRead()

INT32 LOS_DmesgRead	(	CHAR *	buf,
		UINT32	len
	)

Read log from dmesg buffer.

Description:

This API is used to get log from dmesg buffer in core and copy to the point buffer.

注意

• Length of log been read may be less than the len if log in dmesg buffer is not enough.

参数

buf	[IN] Type CHAR* The buffer expected copy to.
len	[IN] Type UINT32 The maximum number of bytes that can be accommodated in the buf.

返回值

#-1	Read log from dmesg buffer fail.
#0	Nothing has been read.
INT32	The length of log has been read.

Dependency:

• dmesg.h: the header file that contains the API declaration.

参见

LOS_DmesgRead

Read log from dmesg buffer.

在文件 dmesg.c 第 645 行定义.

{
    INT32 ret;
    UINT32 intSave;
 
    if (buf == NULL) {
        return -1;
    }
    if (len == 0) {
        return 0;
    }
 
    LOS_SpinLockSave(&g_dmesgSpin, &intSave);
    ret = OsDmesgRead(buf, len);
    LOS_SpinUnlockRestore(&g_dmesgSpin, intSave);
    return ret;
}

函数调用图:

LOS_DmesgToFile()

INT32 LOS_DmesgToFile

(

const CHAR *

filename

)

Copy log to file.

Description:

This API is used to copy all log from dmesg buffer and write it to the file.

注意

• Files rely on file system, the file system of filename dependent must be already mounted.

参数

filename

[IN] Type CHAR* The buffer expected copy to.

返回值

#-1	Copy log to file fail.
#0	Maybe there is no log in the buffer.
INT32	The length of log has been written to file.

Dependency:

• dmesg.h: the header file that contains the API declaration.

参见

LOS_DmesgToFile

Copy log to file.

在文件 dmesg.c 第 678 行定义.

{
    CHAR *fullpath = NULL;
    CHAR *buf = NULL;
    INT32 ret;
    CHAR *shellWorkingDirectory = OsShellGetWorkingDirectory();//获取工作路径
    UINT32 logSize, bufSize, head, tail, intSave;
    CHAR *logBuf = NULL;
 
    LOS_SpinLockSave(&g_dmesgSpin, &intSave);
    if (OsCheckError()) {
        LOS_SpinUnlockRestore(&g_dmesgSpin, intSave);
        return -1;
    }
    logSize = g_dmesgInfo->logSize;
    bufSize = g_logBufSize;
    head = g_dmesgInfo->logHead;
    tail = g_dmesgInfo->logTail;
    logBuf = g_dmesgInfo->logBuf;
    LOS_SpinUnlockRestore(&g_dmesgSpin, intSave);
 
    ret = vfs_normalize_path(shellWorkingDirectory, filename, &fullpath);//获取绝对路径
    if (ret != 0) {
        return -1;
    }
 
    buf = (CHAR *)malloc(logSize);
    if (buf == NULL) {
        goto ERR_OUT2;
    }
 
    if (head < tail) {
        ret = memcpy_s(buf, logSize, logBuf + head, logSize);
        if (ret != EOK) {
            goto ERR_OUT3;
        }
    } else {
        ret = memcpy_s(buf, logSize, logBuf + head, bufSize - head);
        if (ret != EOK) {
            goto ERR_OUT3;
        }
        ret = memcpy_s(buf + bufSize - head, logSize - (bufSize - head), logBuf, tail);
        if (ret != EOK) {
            goto ERR_OUT3;
        }
    }
 
    ret = OsDmesgWrite2File(fullpath, buf, logSize);//写文件
ERR_OUT3:
    free(buf);
ERR_OUT2:
    free(fullpath);
    return ret;
}

函数调用图:

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