日志

日志 的协作图:

宏定义
#define	XWLOGF_VERBOSE(tag, fmt, ...)   xwpf("V|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_V(tag, fmt, ...)   xwpf("V|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_DEBUG(tag, fmt, ...)   xwpf("D|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_D(tag, fmt, ...)   xwpf("D|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_INFO(tag, fmt, ...)   xwpf("I|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_I(tag, fmt, ...)   xwpf("I|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_NOTICE(tag, fmt, ...)   xwpf("N|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_N(tag, fmt, ...)   xwpf("N|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_WARNING(tag, fmt, ...)   xwpf("W|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_W(tag, fmt, ...)   xwpf("W|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_ERR(tag, fmt, ...)   xwpf("E|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_E(tag, fmt, ...)   xwpf("E|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_CRIT(tag, fmt, ...)   xwpf("C|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_C(tag, fmt, ...)   xwpf("C|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_ALERT(tag, fmt, ...)   xwpf("A|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_A(tag, fmt, ...)   xwpf("A|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_EMERG(tag, fmt, ...)   xwpf("G|" tag " " fmt, ##__VA_ARGS__)
#define	XWLOGF_G(tag, fmt, ...)   xwpf("G|" tag " " fmt, ##__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 | V，等级0 DEBUG | D，等级1 INFO | I，等级2 NOTICE | N，等级3 WARNING | W，等级4 ERR | E，等级5 CRIT | C，等级6 ALERT | A，等级7 EMERG | G，等级8
[in]	tag	日志标签
[in]	fmt	格式的字符串
[in]	...	需要格式化的参数

注解

• 上下文：依赖 soc_log_write() 或 board_log_write() 实现

如果底层 soc_log_write() 或 board_log_write() 的实现会导致线程睡眠， 不可在除线程外的其他上下文使用。

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

XWLOGF_A

#define XWLOGF_A	(		tag,
			fmt,
			...
	)		xwpf("A|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_ALERT

#define XWLOGF_ALERT	(		tag,
			fmt,
			...
	)		xwpf("A|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_C

#define XWLOGF_C	(		tag,
			fmt,
			...
	)		xwpf("C|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_CRIT

#define XWLOGF_CRIT	(		tag,
			fmt,
			...
	)		xwpf("C|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_D

#define XWLOGF_D	(		tag,
			fmt,
			...
	)		xwpf("D|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_DEBUG

#define XWLOGF_DEBUG	(		tag,
			fmt,
			...
	)		xwpf("D|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_E

#define XWLOGF_E	(		tag,
			fmt,
			...
	)		xwpf("E|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_EMERG

#define XWLOGF_EMERG	(		tag,
			fmt,
			...
	)		xwpf("G|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_ERR

#define XWLOGF_ERR	(		tag,
			fmt,
			...
	)		xwpf("E|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_G

#define XWLOGF_G	(		tag,
			fmt,
			...
	)		xwpf("G|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_I

#define XWLOGF_I	(		tag,
			fmt,
			...
	)		xwpf("I|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_INFO

#define XWLOGF_INFO	(		tag,
			fmt,
			...
	)		xwpf("I|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_N

#define XWLOGF_N	(		tag,
			fmt,
			...
	)		xwpf("N|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_NOTICE

#define XWLOGF_NOTICE	(		tag,
			fmt,
			...
	)		xwpf("N|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_V

#define XWLOGF_V	(		tag,
			fmt,
			...
	)		xwpf("V|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_VERBOSE

#define XWLOGF_VERBOSE	(		tag,
			fmt,
			...
	)		xwpf("V|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_W

#define XWLOGF_W	(		tag,
			fmt,
			...
	)		xwpf("W|" tag " " fmt, ##__VA_ARGS__)

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

XWLOGF_WARNING

#define XWLOGF_WARNING	(		tag,
			fmt,
			...
	)		xwpf("W|" tag " " fmt, ##__VA_ARGS__)

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

函数说明

xwpf()

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

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

参数

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

返回

同 vsnprintf() 函数

注解

• 上下文：依赖 soc_log_write() 或 board_log_write() 实现

如果底层 soc_log_write() 或 board_log_write() 的实现会导致线程睡眠， 不可在除线程外的其他上下文使用。

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

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

函数调用图: