9.1 日志消息回调设置

libevent 可以记录内部错误和警告。如果编译进日志支持，还会记录调试信息。默认配置下 这些信息被写到stderr。通过提供定制的日志函数可以覆盖默认行为。

  1. #define EVENT_LOG_DEBUG 0
  2. #define EVENT_LOG_MSG   1
  3. #define EVENT_LOG_WARN  2
  4. #define EVENT_LOG_ERR   3
  6. /* Deprecated; see note at the end of this section */
  7. #define _EVENT_LOG_DEBUG EVENT_LOG_DEBUG
  8. #define _EVENT_LOG_MSG   EVENT_LOG_MSG
  9. #define _EVENT_LOG_WARN  EVENT_LOG_WARN
  10. #define _EVENT_LOG_ERR   EVENT_LOG_ERR
  13. typedef void (*event_log_cb)(int severity, const char *msg);
  14. void event_set_log_callback(event_log_cb cb);

要覆盖libevent 的日志行为，编写匹配event_log_cb 签名的定制函数，将其作为参数传递 给event_set_log_callback（）。

随后libevent 在日志信息的时候，将会把信息传递给你提供的函数。再次调用event_set_log_callback（），传递参数NULL，就可以恢复默认行为。

实例

  1. #include <event2/event.h>
  2. #include <stdio.h>
  4. static void discard_cb(int severity, const char *msg)
  5. {
  6.     /* This callback does nothing. */
  7. }
  9. static FILE *logfile = NULL;
  10. static void write_to_file_cb(int severity, const char *msg)
  11. {
  12.     const char *s;
  13.     if (!logfile)
  14.         return;
  15.     switch (severity) {
  16.         case _EVENT_LOG_DEBUG: s = "debug"; break;
  17.         case _EVENT_LOG_MSG:   s = "msg";   break;
  18.         case _EVENT_LOG_WARN:  s = "warn";  break;
  19.         case _EVENT_LOG_ERR:   s = "error"; break;
  20.         default:               s = "?";     break; /* never reached */
  21.     }
  22.     fprintf(logfile, "[%s] %s\n", s, msg);
  23. }
  25. /* Turn off all logging from Libevent. */
  26. void suppress_logging(void)
  27. {
  28.     event_set_log_callback(discard_cb);
  29. }
  31. /* Redirect all Libevent log messages to the C stdio file 'f'. */
  32. void set_logfile(FILE *f)
  33. {
  34.     logfile = f;
  35.     event_set_log_callback(write_to_file_cb);
  36. }

在用户提供的event_log_cb 回调函数中调用libevent 函数是不安全的。

比如说，如果试图编写一个使用bufferevent 将警告信息发送给某个套接字的日志回调函数，可能会遇到奇怪 而难以诊断的bug。未来版本libevent 的某些函数可能会移除这个限制。

这个函数在中声明，在libevent 1.0c 版本中首次出现。