[技术思考]APUE UNP1/2 的包裹函数的解析与应用示例

在学习APUE、UNP1/2的这三套书籍时候，发现，其实可以使用强大的包裹函数，直接封装了错误信息提示，为调试代码，维护代码，带来了巨大的提升。

本文：将尝试解析，包裹函数的作用，并对比非包裹函数的使用情况和案例分析，以此来理解”包裹“一词。

首先，包裹函数最关键一步，是错误处理，其余所有的系统/非系统的调用API接口，都经过包裹封装，而封装内部，都会含有错误处理函数。

APUE、UNP1/2（下面简称：参考书），参考书上的错误处理，都是封装了多个重要应用的。我们来看看。

/* Fatal error related to system call
* Print message and terminate */

void
err_sys(const char *fmt, ...)
{
va_list		ap;

va_start(ap, fmt);
err_doit(1, LOG_ERR, fmt, ap);
va_end(ap);
exit(1);
}

这是使用最多的函数，大部分包裹函数都是由它来显示反馈信息。

1. 使用了类似printf函数格式的接口格式，使用非常方便。

2.函数内依赖可变参数实现

3.直接调用exit(1)，即可退出进程并清空所有缓冲

其中，又调用了关键封装：err_doit

/* Print message and return to caller
* Caller specifies "errnoflag" and "level" */

static void
err_doit(int errnoflag, int level, const char *fmt, va_list ap)
{
int		errno_save, n;
char	buf[MAXLINE + 1];

errno_save = errno;		/* value caller might want printed */
#ifdef	HAVE_VSNPRINTF
vsnprintf(buf, MAXLINE, fmt, ap);	/* safe */
#else
vsprintf(buf, fmt, ap);					/* not safe */
#endif
n = strlen(buf);
if (errnoflag)
snprintf(buf + n, MAXLINE - n, ": %s", strerror(errno_save));
strcat(buf, "\n");

if (daemon_proc) {
syslog(level, buf);
} else {
fflush(stdout);		/* in case stdout and stderr are the same */
fputs(buf, stderr);
fflush(stderr);
}
return;
}

该函数：

1. 马上保存errno全局变量，确保可靠性和错误信息的准确性

2. 调用vsnprintf（一般都是这个分支），将输出信息，导入buf

3. 是否启动系统sys的守护进程，是则讲错误信息输出到系统sys，否则输出到stderr并fflush确保

4. 又继续使用strcat，确保错误信息字符串一定是'\n'结束

5.为了提供由用户选择是否使用syslog日志功能，提供全局开关变量daemon_proc，而该变量，由daemon_init()函数确定，是否启动一个daemon守护进程。

解析该函数的参数：

errnoflag：选择是否加入errno错误源信息，调用strerror()返回错误字符串。下面是它的另一个调用（与上面第一个调用不同）

/* Nonfatal error unrelated to system call
* Print message and return */

void
err_msg(const char *fmt, ...)
{
va_list		ap;

va_start(ap, fmt);
err_doit(0, LOG_INFO, fmt, ap);
va_end(ap);
return;
}

可见，第一个参数是不一样的：

1则输出errno错误源信息；0则不输出errno错误源信息

其实，还是想说说这个err_msg函数：

它并不退出进程，只是直接向输出（先不管是syslog还是stderr）输出信息，在相当有用，通常在非致命错误下使用（err_sys是致命错误，所以退出进程）

level：决定本次err_doit的syslog等级（如果使用syslog的话）

具体等级由syslog系统实现决定，不详细解析。

总结：

上面的使用，或许对新手来说，确实是有点多，这里提供一点参数，作用以后重学习使用。

Linux日志文件与Syslog函数介绍