/* * Copyright (C) 2004-2010 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 1999-2003 Internet Software Consortium. * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. */ /* $Id: server.h,v 1.110 2010/08/16 23:46:52 tbox Exp $ */ #ifndef NAMED_SERVER_H #define NAMED_SERVER_H 1 /*! \file */ #include #include #include #include #include #include #include #include #include #define NS_EVENTCLASS ISC_EVENTCLASS(0x4E43) #define NS_EVENT_RELOAD (NS_EVENTCLASS + 0) #define NS_EVENT_CLIENTCONTROL (NS_EVENTCLASS + 1) /*% * Name server state. Better here than in lots of separate global variables. */ struct ns_server { unsigned int magic; isc_mem_t * mctx; isc_task_t * task; /* Configurable data. */ isc_quota_t xfroutquota; isc_quota_t tcpquota; isc_quota_t recursionquota; dns_acl_t *blackholeacl; char * statsfile; /*%< Statistics file name */ char * dumpfile; /*%< Dump file name */ char * secrootsfile; /*%< Secroots file name */ char * bindkeysfile; /*%< bind.keys file name */ char * recfile; /*%< Recursive file name */ isc_boolean_t version_set; /*%< User has set version */ char * version; /*%< User-specified version */ isc_boolean_t hostname_set; /*%< User has set hostname */ char * hostname; /*%< User-specified hostname */ /*% Use hostname for server id */ isc_boolean_t server_usehostname; char * server_id; /*%< User-specified server id */ /*% * Current ACL environment. This defines the * current values of the localhost and localnets * ACLs. */ dns_aclenv_t aclenv; /* Server data structures. */ dns_loadmgr_t * loadmgr; dns_zonemgr_t * zonemgr; dns_viewlist_t viewlist; ns_interfacemgr_t * interfacemgr; dns_db_t * in_roothints; dns_tkeyctx_t * tkeyctx; isc_timer_t * interface_timer; isc_timer_t * heartbeat_timer; isc_timer_t * pps_timer; isc_uint32_t interface_interval; isc_uint32_t heartbeat_interval; isc_mutex_t reload_event_lock; isc_event_t * reload_event; isc_boolean_t flushonshutdown; isc_boolean_t log_queries; /*%< For BIND 8 compatibility */ ns_cachelist_t cachelist; /*%< Possibly shared caches */ isc_stats_t * nsstats; /*%< Server stats */ dns_stats_t * rcvquerystats; /*% Incoming query stats */ dns_stats_t * opcodestats; /*%< Incoming message stats */ isc_stats_t * zonestats; /*% Zone management stats */ isc_stats_t * resolverstats; /*% Resolver stats */ isc_stats_t * sockstats; /*%< Socket stats */ ns_controls_t * controls; /*%< Control channels */ unsigned int dispatchgen; ns_dispatchlist_t dispatches; dns_acache_t *acache; ns_statschannellist_t statschannels; dns_tsigkey_t *sessionkey; char *session_keyfile; dns_name_t *session_keyname; unsigned int session_keyalg; isc_uint16_t session_keybits; }; #define NS_SERVER_MAGIC ISC_MAGIC('S','V','E','R') #define NS_SERVER_VALID(s) ISC_MAGIC_VALID(s, NS_SERVER_MAGIC) /*% * Server statistics counters. Used as isc_statscounter_t values. */ enum { dns_nsstatscounter_requestv4 = 0, dns_nsstatscounter_requestv6 = 1, dns_nsstatscounter_edns0in = 2, dns_nsstatscounter_badednsver = 3, dns_nsstatscounter_tsigin = 4, dns_nsstatscounter_sig0in = 5, dns_nsstatscounter_invalidsig = 6, dns_nsstatscounter_tcp = 7, dns_nsstatscounter_authrej = 8, dns_nsstatscounter_recurserej = 9, dns_nsstatscounter_xfrrej = 10, dns_nsstatscounter_updaterej = 11, dns_nsstatscounter_response = 12, dns_nsstatscounter_truncatedresp = 13, dns_nsstatscounter_edns0out = 14, dns_nsstatscounter_tsigout = 15, dns_nsstatscounter_sig0out = 16, dns_nsstatscounter_success = 17, dns_nsstatscounter_authans = 18, dns_nsstatscounter_nonauthans = 19, dns_nsstatscounter_referral = 20, dns_nsstatscounter_nxrrset = 21, dns_nsstatscounter_servfail = 22, dns_nsstatscounter_formerr = 23, dns_nsstatscounter_nxdomain = 24, dns_nsstatscounter_recursion = 25, dns_nsstatscounter_duplicate = 26, dns_nsstatscounter_dropped = 27, dns_nsstatscounter_failure = 28, dns_nsstatscounter_xfrdone = 29, dns_nsstatscounter_updatereqfwd = 30, dns_nsstatscounter_updaterespfwd = 31, dns_nsstatscounter_updatefwdfail = 32, dns_nsstatscounter_updatedone = 33, dns_nsstatscounter_updatefail = 34, dns_nsstatscounter_updatebadprereq = 35, dns_nsstatscounter_max = 36 }; void ns_server_create(isc_mem_t *mctx, ns_server_t **serverp); /*%< * Create a server object with default settings. * This function either succeeds or causes the program to exit * with a fatal error. */ void ns_server_destroy(ns_server_t **serverp); /*%< * Destroy a server object, freeing its memory. */ void ns_server_reloadwanted(ns_server_t *server); /*%< * Inform a server that a reload is wanted. This function * may be called asynchronously, from outside the server's task. * If a reload is already scheduled or in progress, the call * is ignored. */ void ns_server_flushonshutdown(ns_server_t *server, isc_boolean_t flush); /*%< * Inform the server that the zones should be flushed to disk on shutdown. */ isc_result_t ns_server_reloadcommand(ns_server_t *server, char *args, isc_buffer_t *text); /*%< * Act on a "reload" command from the command channel. */ isc_result_t ns_server_reconfigcommand(ns_server_t *server, char *args); /*%< * Act on a "reconfig" command from the command channel. */ isc_result_t ns_server_notifycommand(ns_server_t *server, char *args, isc_buffer_t *text); /*%< * Act on a "notify" command from the command channel. */ isc_result_t ns_server_refreshcommand(ns_server_t *server, char *args, isc_buffer_t *text); /*%< * Act on a "refresh" command from the command channel. */ isc_result_t ns_server_retransfercommand(ns_server_t *server, char *args); /*%< * Act on a "retransfer" command from the command channel. */ isc_result_t ns_server_togglequerylog(ns_server_t *server); /*%< * Toggle logging of queries, as in BIND 8. */ /*% * Dump the current statistics to the statistics file. */ isc_result_t ns_server_dumpstats(ns_server_t *server); /*% * Dump the current cache to the dump file. */ isc_result_t ns_server_dumpdb(ns_server_t *server, char *args); /*% * Dump the current security roots to the secroots file. */ isc_result_t ns_server_dumpsecroots(ns_server_t *server, char *args); /*% * Change or increment the server debug level. */ isc_result_t ns_server_setdebuglevel(ns_server_t *server, char *args); /*% * Flush the server's cache(s) */ isc_result_t ns_server_flushcache(ns_server_t *server, char *args); /*% * Flush a particular name from the server's cache(s) */ isc_result_t ns_server_flushname(ns_server_t *server, char *args); /*% * Report the server's status. */ isc_result_t ns_server_status(ns_server_t *server, isc_buffer_t *text); /*% * Report a list of dynamic and static tsig keys, per view. */ isc_result_t ns_server_tsiglist(ns_server_t *server, isc_buffer_t *text); /*% * Delete a specific key (with optional view). */ isc_result_t ns_server_tsigdelete(ns_server_t *server, char *command, isc_buffer_t *text); /*% * Enable or disable updates for a zone. */ isc_result_t ns_server_freeze(ns_server_t *server, isc_boolean_t freeze, char *args, isc_buffer_t *text); /*% * Update a zone's DNSKEY set from the key repository. If * the command that triggered the call to this function was "sign", * then force a full signing of the zone. If it was "loadkeys", * then don't sign the zone; any needed changes to signatures can * take place incrementally. */ isc_result_t ns_server_rekey(ns_server_t *server, char *args); /*% * Dump the current recursive queries. */ isc_result_t ns_server_dumprecursing(ns_server_t *server); /*% * Maintain a list of dispatches that require reserved ports. */ void ns_add_reserved_dispatch(ns_server_t *server, const isc_sockaddr_t *addr); /*% * Enable or disable dnssec validation. */ isc_result_t ns_server_validation(ns_server_t *server, char *args); /*% * Add a zone to a running process */ isc_result_t ns_server_add_zone(ns_server_t *server, char *args); /*% * Deletes a zone from a running process */ isc_result_t ns_server_del_zone(ns_server_t *server, char *args); #endif /* NAMED_SERVER_H */