external/bsd/libbind/dist/include/isc/logging.h

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