lighttpd1.4.16 库 （一）log 日志

 lighttpd的日志输出很简单，只有两个文件（因此代码没有注明行号）。

 

一、log.h头文件分析

 

摘录log.h文件代码如下

代码1

 

1. #ifndef _LOG_H_
2. #define _LOG_H_
4. #include "server.h"
6. #define WP() log_error_write(srv, __FILE__, __LINE__, "");
8. int log_error_open(server *srv);
9. int log_error_close(server *srv);
10. int log_error_write(server *srv, const char *filename, unsigned int line, const char *fmt, ...);
11. int log_error_cycle(server *srv);
13. #endif

此头文件定义了日志输出所用到的函数，可以看出，真正的输出函数只有一个，就是log_error_write，而且不区分日志的级别。

 

宏定义WP，只是预先定义了文件名和行号，可变参数直接只有一个，就是""（空字符串），以方便输出。

 

二、log.c源文件。

我们重点看

int log_error_write(server *srv, const char *filename, unsigned int line, const char *fmt, ...) 函数

 

其他函数都是一般的普通的日志文件的写法。（创建或追加文件，关闭文件等）

 

log_error_write函数代码摘录如下：

代码2

 

1. int log_error_write(server *srv, const char *filename, unsigned int line, const char *fmt, ...) {
2.     va_list ap;
4.     switch(srv->errorlog_mode) {
5.     case ERRORLOG_FILE:
6.     case ERRORLOG_STDERR:
7.         /* cache the generated timestamp */
8.         if (srv->cur_ts != srv->last_generated_debug_ts) {
9.             buffer_prepare_copy(srv->ts_debug_str, 255);
10.             strftime(srv->ts_debug_str->ptr, srv->ts_debug_str->size - 1, "%Y-%m-%d %H:%M:%S", localtime(&(srv->cur_ts)));
11.             srv->ts_debug_str->used = strlen(srv->ts_debug_str->ptr) + 1;
13.             srv->last_generated_debug_ts = srv->cur_ts;
14.         }
16.         buffer_copy_string_buffer(srv->errorlog_buf, srv->ts_debug_str);
17.         BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, ": (");
18.         break;
19.     case ERRORLOG_SYSLOG:
20.         /* syslog is generating its own timestamps */
21.         BUFFER_COPY_STRING_CONST(srv->errorlog_buf, "(");
22.         break;
23.     }
25.     buffer_append_string(srv->errorlog_buf, filename);
26.     BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, ".");
27.     buffer_append_long(srv->errorlog_buf, line);
28.     BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, ") ");
31.     for(va_start(ap, fmt); *fmt; fmt++) {
32.         int d;
33.         char *s;
34.         buffer *b;
35.         off_t o;
37.         switch(*fmt) {
38.         case 's':           /* string */
39.             s = va_arg(ap, char *);
40.             buffer_append_string(srv->errorlog_buf, s);
41.             BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, " ");
42.             break;
43.         case 'b':           /* buffer */
44.             b = va_arg(ap, buffer *);
45.             buffer_append_string_buffer(srv->errorlog_buf, b);
46.             BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, " ");
47.             break;
48.         case 'd':           /* int */
49.             d = va_arg(ap, int);
50.             buffer_append_long(srv->errorlog_buf, d);
51.             BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, " ");
52.             break;
53.         case 'o':           /* off_t */
54.             o = va_arg(ap, off_t);
55.             buffer_append_off_t(srv->errorlog_buf, o);
56.             BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, " ");
57.             break;
58.         case 'x':           /* int (hex) */
59.             d = va_arg(ap, int);
60.             BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, "0x");
61.             buffer_append_long_hex(srv->errorlog_buf, d);
62.             BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, " ");
63.             break;
64.         case 'S':           /* string */
65.             s = va_arg(ap, char *);
66.             buffer_append_string(srv->errorlog_buf, s);
67.             break;
68.         case 'B':           /* buffer */
69.             b = va_arg(ap, buffer *);
70.             buffer_append_string_buffer(srv->errorlog_buf, b);
71.             break;
72.         case 'D':           /* int */
73.             d = va_arg(ap, int);
74.             buffer_append_long(srv->errorlog_buf, d);
75.             break;
76.         case '(':
77.         case ')':
78.         case '<':
79.         case '>':
80.         case ',':
81.         case ' ':
82.             buffer_append_string_len(srv->errorlog_buf, fmt, 1);
83.             break;
84.         }
85.     }
86.     va_end(ap);
88.     switch(srv->errorlog_mode) {
89.     case ERRORLOG_FILE:
90.         BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, "/n");
91.         write(srv->errorlog_fd, srv->errorlog_buf->ptr, srv->errorlog_buf->used - 1);
92.         break;
93.     case ERRORLOG_STDERR:
94.         BUFFER_APPEND_STRING_CONST(srv->errorlog_buf, "/n");
95.         write(STDERR_FILENO, srv->errorlog_buf->ptr, srv->errorlog_buf->used - 1);
96.         break;
97.     case ERRORLOG_SYSLOG:
98.         syslog(LOG_ERR, "%s", srv->errorlog_buf->ptr);
99.         break;
100.     }
102.     return 0;
103. }

分析此函数代码可以知道，日志输出实际上定义了自己可以解析的格式。

通常的日志输出有两种：

1、自定义格式输出。

2、使用系统的库函数printf支持的格式输出。

 

两者的比较：

1、定义自己的输出格式。（1）只解析自己定义的错误的格式，这样避免了接口调用者发生系统级的错误（2）调用者要重新学习按此接口提供的格式输出，如果输出格式定义设计要最大程度的满足调用者的需要

2、printf格式输出。（1）很好的兼容，不需要重新遵循新的接口定义。

（2）printf格式基本满足了调用者的最大需求，体现了printf输出格式f的灵活性。

 

lighttpd的日志输出文件没有自定义了文件名和行号的宏，所以使用的使用要手动加上文件名和行号，比较不方便。