contrib/bind-9.2.4rc7/lib/bind/include/isc/logging.h

   1 /*
   2  * Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (c) 1996-1999 by Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
  10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11  * MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
  12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  15  * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 #ifndef LOGGING_H
  19 #define LOGGING_H
  20
  21 #include <sys/types.h>
  22 #include <stdio.h>
  23 #include <stdarg.h>
  24 #include <unistd.h>
  25
  26 #define log_critical            (-5)
  27 #define log_error               (-4)
  28 #define log_warning             (-3)
  29 #define log_notice              (-2)
  30 #define log_info                (-1)
  31 #define log_debug(level)        (level)
  32
  33 typedef enum { log_syslog, log_file, log_null } log_channel_type;
  34
  35 #define LOG_MAX_VERSIONS 99
  36
  37 #define LOG_CLOSE_STREAM                0x0001
  38 #define LOG_TIMESTAMP                   0x0002
  39 #define LOG_TRUNCATE                    0x0004
  40 #define LOG_USE_CONTEXT_LEVEL           0x0008
  41 #define LOG_PRINT_LEVEL                 0x0010
  42 #define LOG_REQUIRE_DEBUG               0x0020
  43 #define LOG_CHANNEL_BROKEN              0x0040
  44 #define LOG_PRINT_CATEGORY              0x0080
  45 #define LOG_CHANNEL_OFF                 0x0100
  46
  47 typedef struct log_context *log_context;
  48 typedef struct log_channel *log_channel;
  49
  50 #define LOG_OPTION_DEBUG                0x01
  51 #define LOG_OPTION_LEVEL                0x02
  52
  53 #define log_open_stream         __log_open_stream
  54 #define log_close_stream        __log_close_stream
  55 #define log_get_stream          __log_get_stream
  56 #define log_get_filename        __log_get_filename
  57 #define log_check_channel       __log_check_channel
  58 #define log_check               __log_check
  59 #define log_vwrite              __log_vwrite
  60 #define log_write               __log_write
  61 #define log_new_context         __log_new_context
  62 #define log_free_context        __log_free_context
  63 #define log_add_channel         __log_add_channel
  64 #define log_remove_channel      __log_remove_channel
  65 #define log_option              __log_option
  66 #define log_category_is_active  __log_category_is_active
  67 #define log_new_syslog_channel  __log_new_syslog_channel
  68 #define log_new_file_channel    __log_new_file_channel
  69 #define log_set_file_owner      __log_set_file_owner
  70 #define log_new_null_channel    __log_new_null_channel
  71 #define log_inc_references      __log_inc_references
  72 #define log_dec_references      __log_dec_references
  73 #define log_get_channel_type    __log_get_channel_type
  74 #define log_free_channel        __log_free_channel
  75 #define log_close_debug_channels        __log_close_debug_channels
  76
  77 FILE *                  log_open_stream(log_channel);
  78 int                     log_close_stream(log_channel);
  79 FILE *                  log_get_stream(log_channel);
  80 char *                  log_get_filename(log_channel);
  81 int                     log_check_channel(log_context, int, log_channel);
  82 int                     log_check(log_context, int, int);
  83 #ifdef __GNUC__
  84 void                    log_vwrite(log_context, int, int, const char *,
  85                                    va_list args)
  86                                 __attribute__((__format__(__printf__, 4, 0)));
  87 void                    log_write(log_context, int, int, const char *, ...)
  88                                 __attribute__((__format__(__printf__, 4, 5)));
  89 #else
  90 void                    log_vwrite(log_context, int, int, const char *,
  91                                    va_list args);
  92 void                    log_write(log_context, int, int, const char *, ...);
  93 #endif
  94 int                     log_new_context(int, char **, log_context *);
  95 void                    log_free_context(log_context);
  96 int                     log_add_channel(log_context, int, log_channel);
  97 int                     log_remove_channel(log_context, int, log_channel);
  98 int                     log_option(log_context, int, int);
  99 int                     log_category_is_active(log_context, int);
 100 log_channel             log_new_syslog_channel(unsigned int, int, int);
 101 log_channel             log_new_file_channel(unsigned int, int, const char *,
 102                                              FILE *, unsigned int,
 103                                              unsigned long);
 104 int                     log_set_file_owner(log_channel, uid_t, gid_t);
 105 log_channel             log_new_null_channel(void);
 106 int                     log_inc_references(log_channel);
 107 int                     log_dec_references(log_channel);
 108 log_channel_type        log_get_channel_type(log_channel);
 109 int                     log_free_channel(log_channel);
 110 void                    log_close_debug_channels(log_context);
 111
 112 #endif /* !LOGGING_H */