One Level Up Top Level

src/core/ngx_log.h - nginx-1.7.10

Data types defined

Functions defined

Macros defined

Source code


  2. /*
  3. * Copyright (C) Igor Sysoev
  4. * Copyright (C) Nginx, Inc.
  5. */


  8. #ifndef _NGX_LOG_H_INCLUDED_
  9. ‌#define _NGX_LOG_H_INCLUDED_


  12. #include <ngx_config.h>
  13. #include <ngx_core.h>


  16. ‌#define NGX_LOG_STDERR            0
  17. ‌#define NGX_LOG_EMERG             1
  18. ‌#define NGX_LOG_ALERT             2
  19. ‌#define NGX_LOG_CRIT              3
  20. ‌#define NGX_LOG_ERR               4
  21. ‌#define NGX_LOG_WARN              5
  22. ‌#define NGX_LOG_NOTICE            6
  23. ‌#define NGX_LOG_INFO              7
  24. ‌#define NGX_LOG_DEBUG             8

  26. ‌#define NGX_LOG_DEBUG_CORE        0x010
  27. ‌#define NGX_LOG_DEBUG_ALLOC       0x020
  28. ‌#define NGX_LOG_DEBUG_MUTEX       0x040
  29. ‌#define NGX_LOG_DEBUG_EVENT       0x080
  30. ‌#define NGX_LOG_DEBUG_HTTP        0x100
  31. ‌#define NGX_LOG_DEBUG_MAIL        0x200
  32. ‌#define NGX_LOG_DEBUG_MYSQL       0x400

  34. /*
  35. * do not forget to update debug_levels[] in src/core/ngx_log.c
  36. * after the adding a new debug level
  37. */

  39. ‌#define NGX_LOG_DEBUG_FIRST       NGX_LOG_DEBUG_CORE
  40. ‌#define NGX_LOG_DEBUG_LAST        NGX_LOG_DEBUG_MYSQL
  41. ‌#define NGX_LOG_DEBUG_CONNECTION  0x80000000
  42. ‌#define NGX_LOG_DEBUG_ALL         0x7ffffff0


  45. ‌typedef u_char *(*ngx_log_handler_pt) (ngx_log_t *log, u_char *buf, size_t len);
  46. ‌typedef void (*ngx_log_writer_pt) (ngx_log_t *log, ngx_uint_t level,
  47.     u_char *buf, size_t len);


  50. ‌struct ngx_log_s {
  51.     ngx_uint_t           log_level;
  52.     ngx_open_file_t     *file;

  54.     ngx_atomic_uint_t    connection;

  56.     time_t               disk_full_time;

  58.     ngx_log_handler_pt   handler;
  59.     void                *data;

  61.     ngx_log_writer_pt    writer;
  62.     void                *wdata;

  64.     /*
  65.      * we declare "action" as "char *" because the actions are usually
  66.      * the static strings and in the "u_char *" case we have to override
  67.      * their types all the time
  68.      */

  70.     char                *action;

  72.     ngx_log_t           *next;
  73. };


  76. ‌#define NGX_MAX_ERROR_STR   2048


  79. /*********************************/

  81. #if (NGX_HAVE_C99_VARIADIC_MACROS)

  83. ‌#define NGX_HAVE_VARIADIC_MACROS  1

  85. ‌#define ngx_log_error(level, log, ...)                                        \
  86.     if ((log)->log_level >= level) ngx_log_error_core(level, log, __VA_ARGS__)

  88. void ngx_log_error_core(ngx_uint_t level, ngx_log_t *log, ngx_err_t err,
  89.     const char *fmt, ...);

  91. ‌#define ngx_log_debug(level, log, ...)                                        \
  92.     if ((log)->log_level & level)                                             \
  93.         ngx_log_error_core(NGX_LOG_DEBUG, log, __VA_ARGS__)

  95. /*********************************/

  97. #elif (NGX_HAVE_GCC_VARIADIC_MACROS)

  99. ‌#define NGX_HAVE_VARIADIC_MACROS  1

  101. ‌#define ngx_log_error(level, log, args...)                                    \
  102.     if ((log)->log_level >= level) ngx_log_error_core(level, log, args)

  104. void ngx_log_error_core(ngx_uint_t level, ngx_log_t *log, ngx_err_t err,
  105.     const char *fmt, ...);

  107. ‌#define ngx_log_debug(level, log, args...)                                    \
  108.     if ((log)->log_level & level)                                             \
  109.         ngx_log_error_core(NGX_LOG_DEBUG, log, args)

  111. /*********************************/

  113. #else /* NO VARIADIC MACROS */

  115. ‌#define NGX_HAVE_VARIADIC_MACROS  0

  117. void ngx_cdecl ngx_log_error(ngx_uint_t level, ngx_log_t *log, ngx_err_t err,
  118.     const char *fmt, ...);
  119. void ngx_log_error_core(ngx_uint_t level, ngx_log_t *log, ngx_err_t err,
  120.     const char *fmt, va_list args);
  121. void ngx_cdecl ngx_log_debug_core(ngx_log_t *log, ngx_err_t err,
  122.     const char *fmt, ...);


  125. #endif /* VARIADIC MACROS */


  128. /*********************************/

  130. #if (NGX_DEBUG)

  132. #if (NGX_HAVE_VARIADIC_MACROS)

  134. ‌#define ngx_log_debug0(level, log, err, fmt)                                  \
  135.         ngx_log_debug(level, log, err, fmt)

  137. ‌#define ngx_log_debug1(level, log, err, fmt, arg1)                            \
  138.         ngx_log_debug(level, log, err, fmt, arg1)

  140. ‌#define ngx_log_debug2(level, log, err, fmt, arg1, arg2)                      \
  141.         ngx_log_debug(level, log, err, fmt, arg1, arg2)

  143. ‌#define ngx_log_debug3(level, log, err, fmt, arg1, arg2, arg3)                \
  144.         ngx_log_debug(level, log, err, fmt, arg1, arg2, arg3)

  146. ‌#define ngx_log_debug4(level, log, err, fmt, arg1, arg2, arg3, arg4)          \
  147.         ngx_log_debug(level, log, err, fmt, arg1, arg2, arg3, arg4)

  149. ‌#define ngx_log_debug5(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5)    \
  150.         ngx_log_debug(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5)

  152. ‌#define ngx_log_debug6(level, log, err, fmt,                                  \
  153.                        arg1, arg2, arg3, arg4, arg5, arg6)                    \
  154.         ngx_log_debug(level, log, err, fmt,                                   \
  155.                        arg1, arg2, arg3, arg4, arg5, arg6)

  157. ‌#define ngx_log_debug7(level, log, err, fmt,                                  \
  158.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7)              \
  159.         ngx_log_debug(level, log, err, fmt,                                   \
  160.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7)

  162. ‌#define ngx_log_debug8(level, log, err, fmt,                                  \
  163.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)        \
  164.         ngx_log_debug(level, log, err, fmt,                                   \
  165.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)


  168. #else /* NO VARIADIC MACROS */

  170. ‌#define ngx_log_debug0(level, log, err, fmt)                                  \
  171.     if ((log)->log_level & level)                                             \
  172.         ngx_log_debug_core(log, err, fmt)

  174. ‌#define ngx_log_debug1(level, log, err, fmt, arg1)                            \
  175.     if ((log)->log_level & level)                                             \
  176.         ngx_log_debug_core(log, err, fmt, arg1)

  178. ‌#define ngx_log_debug2(level, log, err, fmt, arg1, arg2)                      \
  179.     if ((log)->log_level & level)                                             \
  180.         ngx_log_debug_core(log, err, fmt, arg1, arg2)

  182. ‌#define ngx_log_debug3(level, log, err, fmt, arg1, arg2, arg3)                \
  183.     if ((log)->log_level & level)                                             \
  184.         ngx_log_debug_core(log, err, fmt, arg1, arg2, arg3)

  186. ‌#define ngx_log_debug4(level, log, err, fmt, arg1, arg2, arg3, arg4)          \
  187.     if ((log)->log_level & level)                                             \
  188.         ngx_log_debug_core(log, err, fmt, arg1, arg2, arg3, arg4)

  190. ‌#define ngx_log_debug5(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5)    \
  191.     if ((log)->log_level & level)                                             \
  192.         ngx_log_debug_core(log, err, fmt, arg1, arg2, arg3, arg4, arg5)

  194. ‌#define ngx_log_debug6(level, log, err, fmt,                                  \
  195.                        arg1, arg2, arg3, arg4, arg5, arg6)                    \
  196.     if ((log)->log_level & level)                                             \
  197.         ngx_log_debug_core(log, err, fmt, arg1, arg2, arg3, arg4, arg5, arg6)

  199. ‌#define ngx_log_debug7(level, log, err, fmt,                                  \
  200.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7)              \
  201.     if ((log)->log_level & level)                                             \
  202.         ngx_log_debug_core(log, err, fmt,                                     \
  203.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7)

  205. ‌#define ngx_log_debug8(level, log, err, fmt,                                  \
  206.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)        \
  207.     if ((log)->log_level & level)                                             \
  208.         ngx_log_debug_core(log, err, fmt,                                     \
  209.                        arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)

  211. #endif

  213. #else /* NO NGX_DEBUG */

  215. ‌#define ngx_log_debug0(level, log, err, fmt)
  216. ‌#define ngx_log_debug1(level, log, err, fmt, arg1)
  217. ‌#define ngx_log_debug2(level, log, err, fmt, arg1, arg2)
  218. ‌#define ngx_log_debug3(level, log, err, fmt, arg1, arg2, arg3)
  219. ‌#define ngx_log_debug4(level, log, err, fmt, arg1, arg2, arg3, arg4)
  220. ‌#define ngx_log_debug5(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5)
  221. ‌#define ngx_log_debug6(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5, arg6)
  222. ‌#define ngx_log_debug7(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5,    \
  223.                        arg6, arg7)
  224. ‌#define ngx_log_debug8(level, log, err, fmt, arg1, arg2, arg3, arg4, arg5,    \
  225.                        arg6, arg7, arg8)

  227. #endif

  229. /*********************************/

  231. ngx_log_t *ngx_log_init(u_char *prefix);
  232. void ngx_cdecl ngx_log_abort(ngx_err_t err, const char *fmt, ...);
  233. void ngx_cdecl ngx_log_stderr(ngx_err_t err, const char *fmt, ...);
  234. u_char *ngx_log_errno(u_char *buf, u_char *last, ngx_err_t err);
  235. ngx_int_t ngx_log_open_default(ngx_cycle_t *cycle);
  236. ngx_int_t ngx_log_redirect_stderr(ngx_cycle_t *cycle);
  237. ngx_log_t *ngx_log_get_file_log(ngx_log_t *head);
  238. char *ngx_log_set_log(ngx_conf_t *cf, ngx_log_t **head);


  241. /*
  242. * ngx_write_stderr() cannot be implemented as macro, since
  243. * MSVC does not allow to use #ifdef inside macro parameters.
  244. *
  245. * ngx_write_fd() is used instead of ngx_write_console(), since
  246. * CharToOemBuff() inside ngx_write_console() cannot be used with
  247. * read only buffer as destination and CharToOemBuff() is not needed
  248. * for ngx_write_stderr() anyway.
  249. */
  250. static ngx_inline void
  251. ‌ngx_write_stderr(char *text)
  252. {
  253.     (void) ngx_write_fd(ngx_stderr, text, ngx_strlen(text));
  254. }


  257. extern ngx_module_t  ngx_errlog_module;
  258. extern ngx_uint_t    ngx_use_stderr;


  261. #endif /* _NGX_LOG_H_INCLUDED_ */

One Level Up Top Level