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
  5. /* Deprecated; see note at the end of this section */
  6. #define _EVENT_LOG_DEBUG EVENT_LOG_DEBUG
  7. #define _EVENT_LOG_MSG EVENT_LOG_MSG
  8. #define _EVENT_LOG_WARN EVENT_LOG_WARN
  9. #define _EVENT_LOG_ERR EVENT_LOG_ERR
  10. typedef void (*event_log_cb)(int severity, const char *msg);
  11. 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>
  3. static void discard_cb(int severity, const char *msg)
  4. {
  5. /* This callback does nothing. */
  6. }
  7. static FILE *logfile = NULL;
  8. static void write_to_file_cb(int severity, const char *msg)
  9. {
  10. const char *s;
  11. if (!logfile)
  12. return;
  13. switch (severity) {
  14. case _EVENT_LOG_DEBUG: s = "debug"; break;
  15. case _EVENT_LOG_MSG: s = "msg"; break;
  16. case _EVENT_LOG_WARN: s = "warn"; break;
  17. case _EVENT_LOG_ERR: s = "error"; break;
  18. default: s = "?"; break; /* never reached */
  19. }
  20. fprintf(logfile, "[%s] %s\n", s, msg);
  21. }
  22. /* Turn off all logging from Libevent. */
  23. void suppress_logging(void)
  24. {
  25. event_set_log_callback(discard_cb);
  26. }
  27. /* Redirect all Libevent log messages to the C stdio file 'f'. */
  28. void set_logfile(FILE *f)
  29. {
  30. logfile = f;
  31. event_set_log_callback(write_to_file_cb);
  32. }

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

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

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