log.h revision 1d761cb453c76353deb8423c78e98d00c5f86ffa
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews/*
1fdd2470b625a58b57d0b155e6caf8c4fc0afe8aAutomatic Updater * Copyright (C) 2004-2007, 2009, 2011-2013 Internet Systems Consortium, Inc. ("ISC")
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * Copyright (C) 1999-2001, 2003 Internet Software Consortium.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews *
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater * Permission to use, copy, modify, and/or distribute this software for any
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * purpose with or without fee is hereby granted, provided that the above
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * copyright notice and this permission notice appear in all copies.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews *
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * PERFORMANCE OF THIS SOFTWARE.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews */
3b2c6af63e0367c6eabe0a21ca23841ca87cd22fAutomatic Updater
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews/* $Id: log.h,v 1.47 2011/10/13 22:48:24 tbox Exp $ */
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews/*! \file dns/log.h
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * \author Principal Authors: DCL */
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#ifndef DNS_LOG_H
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOG_H 1
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#include <isc/lang.h>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#include <isc/log.h>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsLIBDNS_EXTERNAL_DATA extern isc_log_t *dns_lctx;
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsLIBDNS_EXTERNAL_DATA extern isc_logcategory_t dns_categories[];
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsLIBDNS_EXTERNAL_DATA extern isc_logmodule_t dns_modules[];
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_NOTIFY (&dns_categories[0])
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater#define DNS_LOGCATEGORY_DATABASE (&dns_categories[1])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_SECURITY (&dns_categories[2])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews/* DNS_LOGCATEGORY_CONFIG superseded by CFG_LOGCATEGORY_CONFIG */
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_DNSSEC (&dns_categories[4])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_RESOLVER (&dns_categories[5])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_XFER_IN (&dns_categories[6])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_XFER_OUT (&dns_categories[7])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_DISPATCH (&dns_categories[8])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_LAME_SERVERS (&dns_categories[9])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_DELEGATION_ONLY (&dns_categories[10])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_EDNS_DISABLED (&dns_categories[11])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_RPZ (&dns_categories[12])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_RRL (&dns_categories[13])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews/* Backwards compatibility. */
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGCATEGORY_GENERAL ISC_LOGCATEGORY_GENERAL
8de0d8a6905e397ed0a26054815420685f9b435eAutomatic Updater
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_DB (&dns_modules[0])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_RBTDB (&dns_modules[1])
3b2c6af63e0367c6eabe0a21ca23841ca87cd22fAutomatic Updater#define DNS_LOGMODULE_RBTDB64 (&dns_modules[2])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_RBT (&dns_modules[3])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_RDATA (&dns_modules[4])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_MASTER (&dns_modules[5])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_MESSAGE (&dns_modules[6])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_CACHE (&dns_modules[7])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_CONFIG (&dns_modules[8])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_RESOLVER (&dns_modules[9])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_ZONE (&dns_modules[10])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_JOURNAL (&dns_modules[11])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_ADB (&dns_modules[12])
3b2c6af63e0367c6eabe0a21ca23841ca87cd22fAutomatic Updater#define DNS_LOGMODULE_XFER_IN (&dns_modules[13])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_XFER_OUT (&dns_modules[14])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_ACL (&dns_modules[15])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_VALIDATOR (&dns_modules[16])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_DISPATCH (&dns_modules[17])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_REQUEST (&dns_modules[18])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_MASTERDUMP (&dns_modules[19])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_TSIG (&dns_modules[20])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_TKEY (&dns_modules[21])
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#define DNS_LOGMODULE_SDB (&dns_modules[22])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_DIFF (&dns_modules[23])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_HINTS (&dns_modules[24])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_ACACHE (&dns_modules[25])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_DLZ (&dns_modules[26])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_DNSSEC (&dns_modules[27])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_CRYPTO (&dns_modules[28])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater#define DNS_LOGMODULE_PACKETS (&dns_modules[29])
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic UpdaterISC_LANG_BEGINDECLS
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updatervoid
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updaterdns_log_init(isc_log_t *lctx);
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater/*%
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater * Make the libdns categories and modules available for use with the
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater * ISC logging library.
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater *
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater * Requires:
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater *\li lctx is a valid logging context.
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater *
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater *\li dns_log_init() is called only once.
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater *
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater * Ensures:
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater * \li The categories and modules defined above are available for
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater * use by isc_log_usechannnel() and isc_log_write().
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater */
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updatervoid
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updaterdns_log_setcontext(isc_log_t *lctx);
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater/*%
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater * Make the libdns library use the provided context for logging internal
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater * messages.
0a7ed88633a680bb881868b75ded4d09a7bbbc50Automatic Updater *
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews * Requires:
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews *\li lctx is a valid logging context.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews */
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark AndrewsISC_LANG_ENDDECLS
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews#endif /* DNS_LOG_H */
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews