APUE和UNP1/2（包裹函数）

本文，记录与分析apue与unp1/2的库、demo的解析与使用。

分析步骤：

1. 解析包裹函数，并对比非包裹函数的使用情况和案例分析，以此来理解”包裹“一词。
2. 讲述错误处理函数中使用到的Linux syslog，并根据此讲述守护进程的基本概念。

包裹函数（错误处理函数解析）

---

     在学习APUE、UNP1/2的这三套书籍时候，发现，其实可以使用强大的包裹函数，直接封装了错误信息提示，为调试代码，维护代码，带来了巨大的提升。APUE、UNP1/2（下面简称：参考书），参考书上的错误处理，都是封装了多个重要应用的。我们来看看。 包裹函数最关键一步，是错误处理，其余所有的系统/非系统的调用API接口，都经过包裹封装，而封装内部，都会含有错误处理函数。

/* 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（日志）的err_xxx

---

上面的错误处理函数，封装了syslog函数，在这里讲解析：

1. Linux syslog：
   1. 参考博客：Linux日志文件与Syslog函数介绍
   2. 快速教程： [学习]Linux (sys)Log
2. Linux daemon（守护进程）：UNP1--30章
   1. 普通进程转为守护进程的一般方法