contrib/bind9/lib/dns/include/dns/log.h

   1 /*
   2  * Copyright (C) 2004-2007, 2009, 2011, 2012  Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (C) 1999-2001, 2003  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and/or 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 WITH
  10  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  * PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 /* $Id$ */
  19
  20 /*! \file dns/log.h
  21  * \author  Principal Authors: DCL */
  22
  23 #ifndef DNS_LOG_H
  24 #define DNS_LOG_H 1
  25
  26 #include <isc/lang.h>
  27 #include <isc/log.h>
  28
  29 LIBDNS_EXTERNAL_DATA extern isc_log_t *dns_lctx;
  30 LIBDNS_EXTERNAL_DATA extern isc_logcategory_t dns_categories[];
  31 LIBDNS_EXTERNAL_DATA extern isc_logmodule_t dns_modules[];
  32
  33 #define DNS_LOGCATEGORY_NOTIFY          (&dns_categories[0])
  34 #define DNS_LOGCATEGORY_DATABASE        (&dns_categories[1])
  35 #define DNS_LOGCATEGORY_SECURITY        (&dns_categories[2])
  36 /* DNS_LOGCATEGORY_CONFIG superseded by CFG_LOGCATEGORY_CONFIG */
  37 #define DNS_LOGCATEGORY_DNSSEC          (&dns_categories[4])
  38 #define DNS_LOGCATEGORY_RESOLVER        (&dns_categories[5])
  39 #define DNS_LOGCATEGORY_XFER_IN         (&dns_categories[6])
  40 #define DNS_LOGCATEGORY_XFER_OUT        (&dns_categories[7])
  41 #define DNS_LOGCATEGORY_DISPATCH        (&dns_categories[8])
  42 #define DNS_LOGCATEGORY_LAME_SERVERS    (&dns_categories[9])
  43 #define DNS_LOGCATEGORY_DELEGATION_ONLY (&dns_categories[10])
  44 #define DNS_LOGCATEGORY_EDNS_DISABLED   (&dns_categories[11])
  45 #define DNS_LOGCATEGORY_RPZ             (&dns_categories[12])
  46
  47 /* Backwards compatibility. */
  48 #define DNS_LOGCATEGORY_GENERAL         ISC_LOGCATEGORY_GENERAL
  49
  50 #define DNS_LOGMODULE_DB                (&dns_modules[0])
  51 #define DNS_LOGMODULE_RBTDB             (&dns_modules[1])
  52 #define DNS_LOGMODULE_RBTDB64           (&dns_modules[2])
  53 #define DNS_LOGMODULE_RBT               (&dns_modules[3])
  54 #define DNS_LOGMODULE_RDATA             (&dns_modules[4])
  55 #define DNS_LOGMODULE_MASTER            (&dns_modules[5])
  56 #define DNS_LOGMODULE_MESSAGE           (&dns_modules[6])
  57 #define DNS_LOGMODULE_CACHE             (&dns_modules[7])
  58 #define DNS_LOGMODULE_CONFIG            (&dns_modules[8])
  59 #define DNS_LOGMODULE_RESOLVER          (&dns_modules[9])
  60 #define DNS_LOGMODULE_ZONE              (&dns_modules[10])
  61 #define DNS_LOGMODULE_JOURNAL           (&dns_modules[11])
  62 #define DNS_LOGMODULE_ADB               (&dns_modules[12])
  63 #define DNS_LOGMODULE_XFER_IN           (&dns_modules[13])
  64 #define DNS_LOGMODULE_XFER_OUT          (&dns_modules[14])
  65 #define DNS_LOGMODULE_ACL               (&dns_modules[15])
  66 #define DNS_LOGMODULE_VALIDATOR         (&dns_modules[16])
  67 #define DNS_LOGMODULE_DISPATCH          (&dns_modules[17])
  68 #define DNS_LOGMODULE_REQUEST           (&dns_modules[18])
  69 #define DNS_LOGMODULE_MASTERDUMP        (&dns_modules[19])
  70 #define DNS_LOGMODULE_TSIG              (&dns_modules[20])
  71 #define DNS_LOGMODULE_TKEY              (&dns_modules[21])
  72 #define DNS_LOGMODULE_SDB               (&dns_modules[22])
  73 #define DNS_LOGMODULE_DIFF              (&dns_modules[23])
  74 #define DNS_LOGMODULE_HINTS             (&dns_modules[24])
  75 #define DNS_LOGMODULE_ACACHE            (&dns_modules[25])
  76 #define DNS_LOGMODULE_DLZ               (&dns_modules[26])
  77 #define DNS_LOGMODULE_DNSSEC            (&dns_modules[27])
  78 #define DNS_LOGMODULE_CRYPTO            (&dns_modules[28])
  79
  80 ISC_LANG_BEGINDECLS
  81
  82 void
  83 dns_log_init(isc_log_t *lctx);
  84 /*%
  85  * Make the libdns categories and modules available for use with the
  86  * ISC logging library.
  87  *
  88  * Requires:
  89  *\li   lctx is a valid logging context.
  90  *
  91  *\li   dns_log_init() is called only once.
  92  *
  93  * Ensures:
  94  * \li  The categories and modules defined above are available for
  95  *      use by isc_log_usechannnel() and isc_log_write().
  96  */
  97
  98 void
  99 dns_log_setcontext(isc_log_t *lctx);
 100 /*%
 101  * Make the libdns library use the provided context for logging internal
 102  * messages.
 103  *
 104  * Requires:
 105  *\li   lctx is a valid logging context.
 106  */
 107
 108 ISC_LANG_ENDDECLS
 109
 110 #endif /* DNS_LOG_H */