/*
* Copyright (C) 1999-2009, 2011-2017 Internet Systems Consortium, Inc. ("ISC")
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
/* $Id: cache.c,v 1.91 2011/08/26 05:12:56 marka Exp $ */
/*! \file */
#include <config.h>
#include <dns/dbiterator.h>
#include <dns/masterdump.h>
#include <dns/rdataset.h>
#include <dns/rdatasetiter.h>
#include "rbtdb.h"
/*!
* Control incremental cleaning.
* DNS_CACHE_MINSIZE is how many bytes is the floor for dns_cache_setcachesize().
* See also DNS_CACHE_CLEANERINCREMENT
*/
/*!
* Control incremental cleaning.
* CLEANERINCREMENT is how many nodes are examined in one pass.
* See also DNS_CACHE_MINSIZE
*/
/***
*** Types
***/
/*
* A cache_cleaner_t encapsulates the state of the periodic
* cache cleaning.
*/
typedef enum {
/*
* Convenience macros for comprehensive assertion checking.
*/
(c)->resched_event != NULL)
(c)->resched_event == NULL)
/*%
* Accesses to a cache cleaner object are synchronized through
*/
struct cache_cleaner {
/*%<
* Locks overmem_event, overmem. Note: never allocate memory
* while holding this lock - that could lead to deadlock since
* the lock is take by water() which is called from the memory
* allocator.
*/
named.conf, in seconds. */
itself to reschedule */
clean in one increment */
};
/*%
* The actual cache object.
*/
struct dns_cache {
/* Unlocked. */
unsigned int magic;
char *name;
/* Locked by 'lock'. */
int references;
int live_tasks;
char *db_type;
int db_argc;
char **db_argv;
/* Locked by 'filelock'. */
char *filename;
/* Access to the on-disk cache file is also locked by 'filelock'. */
};
/***
*** Functions
***/
static isc_result_t
static void
static void
static void
static void
static inline isc_result_t
}
{
}
{
cachep));
}
{
int i, extra = 0;
return (ISC_R_NOMEMORY);
goto cleanup_mem;
}
}
if (result != ISC_R_SUCCESS)
goto cleanup_mem;
if (result != ISC_R_SUCCESS)
goto cleanup_lock;
cache->live_tasks = 0;
if (result != ISC_R_SUCCESS)
goto cleanup_filelock;
goto cleanup_stats;
}
/*
* For databases of type "rbt" we pass hmctx to dns_db_create()
* via cache->db_argv, followed by the rest of the arguments in
* db_argv (of which there really shouldn't be any).
*/
extra = 1;
goto cleanup_dbtype;
}
goto cleanup_dbargv;
}
}
}
/*
* Create the database
*/
if (result != ISC_R_SUCCESS)
goto cleanup_dbargv;
if (result != ISC_R_SUCCESS)
goto cleanup_db;
}
/*
* RBT-type cache DB has its own mechanism of cache cleaning and doesn't
* need the control of the generic cleaner.
*/
else {
}
if (result != ISC_R_SUCCESS)
goto cleanup_db;
if (result != ISC_R_SUCCESS)
goto cleanup_db;
return (ISC_R_SUCCESS);
return (result);
}
static void
int i;
}
/*
* We don't free db_argv[0] in "rbt" cache databases
* as it's a pointer to hmctx
*/
int extra = 0;
extra = 1;
}
}
void
cache->references++;
}
void
cache->references--;
if (cache->references == 0) {
}
if (free_cache) {
/*
* When the cache is shut down, dump it to a file if one is
* specified.
*/
if (result != ISC_R_SUCCESS)
"error dumping cache: %s ",
/*
* If the cleaner task exists, let it free the cache.
*/
if (cache->live_tasks > 0) {
}
}
if (free_cache)
}
void
}
char *newname;
return (ISC_R_NOMEMORY);
return (ISC_R_SUCCESS);
}
return (ISC_R_SUCCESS);
return (result);
}
return (ISC_R_SUCCESS);
return (result);
}
void
/*
* It may be the case that the cache has already shut down.
* If so, it has no timer.
*/
goto unlock;
if (t == 0) {
} else {
0);
}
if (result != ISC_R_SUCCESS)
"could not set cache cleaning interval: %s",
}
unsigned int
unsigned int t;
return (t);
}
const char *
}
/*
* Initialize the cache cleaner object at *cleaner.
* Space for the object must be allocated by the caller.
*/
static isc_result_t
{
if (result != ISC_R_SUCCESS)
goto fail;
if (result != ISC_R_SUCCESS)
goto cleanup;
if (result != ISC_R_SUCCESS) {
"isc_task_create() failed: %s",
goto cleanup;
}
if (result != ISC_R_SUCCESS) {
"cache cleaner: "
"isc_task_onshutdown() failed: %s",
goto cleanup;
}
if (result != ISC_R_SUCCESS) {
"isc_timer_create() failed: %s",
goto cleanup;
}
cleaner, sizeof(isc_event_t));
goto cleanup;
}
cleaner, sizeof(isc_event_t));
goto cleanup;
}
}
return (ISC_R_SUCCESS);
fail:
return (result);
}
static void
/*
* Create an iterator, if it does not already exist, and
* position it at the beginning of the cache.
*/
if (result != ISC_R_SUCCESS)
"cache cleaner could not create "
else {
}
if (result != ISC_R_SUCCESS) {
/*
* If the result is ISC_R_NOMORE, the database is empty,
* so there is nothing to be cleaned.
*/
"cache cleaner: "
"dns_dbiterator_first() failed: %s",
}
} else {
/*
* Pause the iterator to free its lock.
*/
"begin cache cleaning, mem inuse %lu",
}
return;
}
static void
if (result != ISC_R_SUCCESS)
}
/*
* This is run once for every cache-cleaning-interval as defined in named.conf.
*/
static void
}
/*
* This is called when the cache either surpasses its upper limit
* or shrinks beyond its lower limit.
*/
static void
} else {
/*
* end_cleaning() can't be called here because
* then both cleaner->overmem_event and
* cleaner->resched_event will point to this
* event. Set the state to done, and then
* when the incremental_cleaning_action() event
* is posted, it will handle the end_cleaning.
*/
}
if (want_cleaning)
}
/*
* Do incremental cleaning.
*/
static void
unsigned int n_names;
if (cleaner->replaceiterator) {
}
return;
}
while (n_names-- > 0) {
NULL);
if (result != ISC_R_SUCCESS) {
"cache cleaner: dns_dbiterator_current() "
return;
}
/*
* The node was not needed, but was required by
* dns_dbiterator_current(). Give up its reference.
*/
/*
* Step to the next node.
*/
if (result != ISC_R_SUCCESS) {
/*
* Either the end was reached (ISC_R_NOMORE) or
* some error was signaled. If the cache is still
* overmem and no error was encountered,
* keep trying to clean it, otherwise stop cleaning.
*/
if (result != ISC_R_NOMORE)
"cache cleaner: "
"dns_dbiterator_next() "
"failed: %s",
iterator);
if (result == ISC_R_SUCCESS) {
ISC_LOG_DEBUG(1),
"cache cleaner: "
"still overmem, "
"reset and try again");
continue;
}
}
return;
}
}
/*
* We have successfully performed a cleaning increment but have
* not gone through the entire cache. Free the iterator locks
* and reschedule another batch. If it fails, just try to continue
* anyway.
*/
return;
}
/*
* Do immediate cleaning.
*/
if (result != ISC_R_SUCCESS)
return result;
while (result == ISC_R_SUCCESS) {
(dns_name_t *)NULL);
if (result != ISC_R_SUCCESS)
break;
/*
* Check TTLs, mark expired rdatasets stale.
*/
if (result != ISC_R_SUCCESS) {
"cache cleaner: dns_db_expirenode() "
"failed: %s",
/*
* Continue anyway.
*/
}
/*
* This is where the actual freeing takes place.
*/
}
if (result == ISC_R_NOMORE)
return (result);
}
static void
}
}
void
/*
* Impose a minimum cache size; pathological things happen if there
* is too little room.
*/
/*
* If the cache was overmem and cleaning, but now with the new limits
* it is no longer in an overmem condition, then the next
* isc_mem_put for cache memory will do the right thing and trigger
* water().
*/
/*
* Disable cache memory limiting.
*/
else
/*
* Establish new cache memory limits (either for the first
* time, or replacing other limits).
*/
}
return (size);
}
/*
* The cleaner task is shutting down; do the necessary cleanup.
*/
static void
else
cache->live_tasks--;
if (cache->references == 0)
/*
* By detaching the timer in the context of its task,
* we are guaranteed that there will be no further timer
* events.
*/
/* Make sure we don't reschedule anymore. */
if (should_free)
}
if (result != ISC_R_SUCCESS)
return (result);
if (result != ISC_R_SUCCESS) {
dns_db_detach(&db);
return (result);
}
dbiterator = NULL;
} else {
}
if (dbiterator != NULL)
if (olddbiterator != NULL)
return (ISC_R_SUCCESS);
}
static isc_result_t
if (result != ISC_R_SUCCESS)
return (result);
result == ISC_R_SUCCESS;
{
break;
}
if (result == ISC_R_NOMORE)
return (result);
}
static isc_result_t
/*
* Create the node if it doesn't exist so dns_dbiterator_seek()
* can find it. We will continue even if this fails.
*/
if (result != ISC_R_SUCCESS)
goto cleanup;
if (result == DNS_R_PARTIALMATCH)
if (result != ISC_R_SUCCESS)
goto cleanup;
while (result == ISC_R_SUCCESS) {
if (result == DNS_R_NEWORIGIN)
if (result != ISC_R_SUCCESS)
goto cleanup;
/*
* Are we done?
*/
goto cleanup;
/*
* If clearnode fails record and move onto the next node.
*/
}
return (answer);
}
}
{
return (dns_cache_flush(cache));
return (ISC_R_SUCCESS);
if (tree) {
} else {
if (result == ISC_R_NOTFOUND) {
goto cleanup_db;
}
if (result != ISC_R_SUCCESS)
goto cleanup_db;
}
dns_db_detach(&db);
return (result);
}
}
void
return;
switch (result) {
case ISC_R_SUCCESS:
case DNS_R_NCACHENXDOMAIN:
case DNS_R_NCACHENXRRSET:
case DNS_R_CNAME:
case DNS_R_DNAME:
case DNS_R_GLUE:
case DNS_R_ZONECUT:
break;
default:
}
}
/*
* XXX: Much of the following code has been copied in from statschannel.c.
* We should refactor this into a generic function in stats.c that can be
* called from both places.
*/
typedef struct
static void
}
static void
{
}
void
"cache hits");
"cache misses");
"cache hits (from query)");
"cache misses (from query)");
"cache records deleted due to memory exhaustion");
"cache records deleted due to TTL expiration");
"cache database nodes");
"cache database hash buckets");
"cache tree memory total");
"cache tree memory in use");
"cache tree highest memory in use");
"cache heap memory total");
"cache heap memory in use");
"cache heap highest memory in use");
}
#ifdef HAVE_LIBXML2
static int
int xmlrc;
value));
return (xmlrc);
}
int
int xmlrc;
return (xmlrc);
}
#endif
#ifdef HAVE_JSON
#define CHECKMEM(m) do { \
if (m == NULL) { \
result = ISC_R_NOMEMORY;\
goto error;\
} \
} while(0)
return (result);
}
#endif