日志

日志 的协作图:

宏定义
#define	XWLOGF_VERBOSE(tag, fmt, ...)   xwpf("V[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_DEBUG(tag, fmt, ...)   xwpf("D[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_INFO(tag, fmt, ...)   xwpf("I[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_NOTICE(tag, fmt, ...)   xwpf("N[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_WARNING(tag, fmt, ...)   xwpf("W[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_ERR(tag, fmt, ...)   xwpf("E[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_CRIT(tag, fmt, ...)   xwpf("C[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_ALERT(tag, fmt, ...)   xwpf("A[%s] " fmt, tag, ##__VA_ARGS__)
#define	XWLOGF_EMERG(tag, fmt, ...)   xwpf("G[%s] " fmt, tag, ##__VA_ARGS__)
#define	xwlogf(lv, tag, fmt, ...)   XWLOGF_##lv(tag, fmt, ##__VA_ARGS__)
	格式化日志，并输出

函数
int	xwpf (const char *fmt,...)
	格式化字符串并输出到日志，同 printf() 函数

详细描述

宏定义说明

xwlogf

#define xwlogf	(		lv,
			tag,
			fmt,
			...
	)		XWLOGF_##lv(tag, fmt, ##__VA_ARGS__)

格式化日志，并输出

参数

[in]	lv	等级，取值 VERBOSE，等级0 DEBUG，等级1 INFO，等级2 NOTICE，等级3 WARNING，等级4 ERR，等级5 CRIT，等级6 ALERT，等级7 EMERG，等级8
[in]	tag	日志标签
[in]	fmt	格式的字符串
[in]	...	需要格式化的参数

注解

• 同步/异步：依据BSP中 soc_log_write() 或 board_log_write() 的实现
• 上下文：依据BSP中 soc_log_write() 或 board_log_write() 的实现
• 重入性：依据BSP中 soc_log_write() 或 board_log_write() 的实现

在文件 xwlog.h 第 100 行定义.

XWLOGF_ALERT

#define XWLOGF_ALERT	(		tag,
			fmt,
			...
	)		xwpf("A[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 69 行定义.

XWLOGF_CRIT

#define XWLOGF_CRIT	(		tag,
			fmt,
			...
	)		xwpf("C[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 63 行定义.

XWLOGF_DEBUG

#define XWLOGF_DEBUG	(		tag,
			fmt,
			...
	)		xwpf("D[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 33 行定义.

XWLOGF_EMERG

#define XWLOGF_EMERG	(		tag,
			fmt,
			...
	)		xwpf("G[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 75 行定义.

XWLOGF_ERR

#define XWLOGF_ERR	(		tag,
			fmt,
			...
	)		xwpf("E[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 57 行定义.

XWLOGF_INFO

#define XWLOGF_INFO	(		tag,
			fmt,
			...
	)		xwpf("I[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 39 行定义.

XWLOGF_NOTICE

#define XWLOGF_NOTICE	(		tag,
			fmt,
			...
	)		xwpf("N[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 45 行定义.

XWLOGF_VERBOSE

#define XWLOGF_VERBOSE	(		tag,
			fmt,
			...
	)		xwpf("V[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 27 行定义.

XWLOGF_WARNING

#define XWLOGF_WARNING	(		tag,
			fmt,
			...
	)		xwpf("W[%s] " fmt, tag, ##__VA_ARGS__)

在文件 xwlog.h 第 51 行定义.

函数说明

xwpf()

int xwpf	(	const char *	fmt,
			...
	)

格式化字符串并输出到日志，同 printf() 函数

参数

[in]	fmt	格式的字符串
[in]	...	需要转换位字符串的其他参数

返回

同 vsnprintf() 函数

注解

• 同步/异步：依据BSP中 soc_log_write( )或 board_log_write() 的实现
• 上下文：依据BSP中 soc_log_write() 或 board_log_write() 的实现
• 重入性：依据BSP中 soc_log_write() 或 board_log_write() 的实现

在文件 xwlog.c 第 31 行定义.

{
        va_list args;
        xwer_t rc;
        int i;
        xwsz_t sz;
        char buf[XWLIBCFG_XWLOG_BUFSIZE];
 
        va_start(args, fmt);
        i = vsnprintf(buf, sizeof(buf), fmt, args);
        va_end(args);
        if (i < 0) {
                goto err_vsnprintf;
        }
        sz = (xwsz_t)i;
 
        /* Print the string */
#if defined(SOCCFG_LOG) && (1 == SOCCFG_LOG)
        rc = soc_log_write(buf, &sz);
        if (rc < 0) {
                i = (int)rc;
        } else {
                i = (int)sz;
        }
#elif defined(BRDCFG_LOG) && (1 == BRDCFG_LOG)
        rc = board_log_write(buf, &sz);
        if (rc < 0) {
                i = (int)rc;
        } else {
                i = (int)sz;
        }
#else
#  warning "Can't find the log configurations!"
        i = 0;
#endif
 
err_vsnprintf:
        return i;
}

函数调用图: