dns.h

Go to the documentation of this file.

/*
 * services/cache/dns.h - Cache services for DNS using msg and rrset caches.
 *
 * Copyright (c) 2007, NLnet Labs. All rights reserved.
 *
 * This software is open source.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 
 * Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 * 
 * Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following disclaimer in the documentation
 * and/or other materials provided with the distribution.
 * 
 * Neither the name of the NLNET LABS nor the names of its contributors may
 * be used to endorse or promote products derived from this software without
 * specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

 
#ifndef SERVICES_CACHE_DNS_H
#define SERVICES_CACHE_DNS_H
#include "util/storage/lruhash.h"
#include "util/data/msgreply.h"
struct module_env;
struct query_info;
struct reply_info;
struct regional;
struct delegpt;


#define DNSCACHE_STORE_ZEROTTL 0x100000

struct dns_msg {
    struct query_info qinfo;
    struct reply_info *rep;
};

int dns_cache_store(struct module_env* env, struct query_info* qinf,
        struct reply_info* rep, int is_referral, time_t leeway, int pside,
    struct regional* region, uint32_t flags);

void dns_cache_store_msg(struct module_env* env, struct query_info* qinfo,
    hashvalue_type hash, struct reply_info* rep, time_t leeway, int pside,
    struct reply_info* qrep, uint32_t flags, struct regional* region);

struct delegpt* dns_cache_find_delegation(struct module_env* env, 
    uint8_t* qname, size_t qnamelen, uint16_t qtype, uint16_t qclass, 
    struct regional* region, struct dns_msg** msg, time_t timenow);

struct dns_msg* tomsg(struct module_env* env, struct query_info* q,
    struct reply_info* r, struct regional* region, time_t now,
    struct regional* scratch);

struct dns_msg* dns_cache_lookup(struct module_env* env,
    uint8_t* qname, size_t qnamelen, uint16_t qtype, uint16_t qclass,
    uint16_t flags, struct regional* region, struct regional* scratch,
    int no_partial);

int cache_fill_missing(struct module_env* env, uint16_t qclass, 
    struct regional* region, struct delegpt* dp);

struct dns_msg* dns_msg_create(uint8_t* qname, size_t qnamelen, uint16_t qtype, 
    uint16_t qclass, struct regional* region, size_t capacity);

int dns_msg_authadd(struct dns_msg* msg, struct regional* region, 
    struct ub_packed_rrset_key* rrset, time_t now);

int dns_msg_ansadd(struct dns_msg* msg, struct regional* region, 
    struct ub_packed_rrset_key* rrset, time_t now);

int dns_cache_prefetch_adjust(struct module_env* env, struct query_info* qinfo,
        time_t adjust, uint16_t flags);

struct msgreply_entry* msg_cache_lookup(struct module_env* env,
    uint8_t* qname, size_t qnamelen, uint16_t qtype, uint16_t qclass,
    uint16_t flags, time_t now, int wr);
 
#endif /* SERVICES_CACHE_DNS_H */