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

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

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

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

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

/* Fatal error related to system call * Print message and terminate */voiderr_sys(const char *fmt, ...){va_listap;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 voiderr_doit(int errnoflag, int level, const char *fmt, va_list ap){interrno_save, n;charbuf[MAXLINE + 1];errno_save = errno;/* value caller might want printed */#ifdefHAVE_VSNPRINTFvsnprintf(buf, MAXLINE, fmt, ap);/* safe */#elsevsprintf(buf, fmt, ap);/* not safe */#endifn = 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 */voiderr_msg(const char *fmt, ...){va_listap;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函数介绍