iter_utils.h

Go to the documentation of this file.

/*
 * iterator/iter_utils.h - iterative resolver module utility functions.
 *
 * 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 ITERATOR_ITER_UTILS_H
#define ITERATOR_ITER_UTILS_H
#include "iterator/iter_resptype.h"
struct sldns_buffer;
struct iter_env;
struct iter_hints;
struct iter_forwards;
struct config_file;
struct module_env;
struct delegpt_addr;
struct delegpt;
struct regional;
struct msg_parse;
struct ub_randstate;
struct query_info;
struct reply_info;
struct module_qstate;
struct sock_list;
struct ub_packed_rrset_key;

int iter_apply_cfg(struct iter_env* iter_env, struct config_file* cfg);

struct delegpt_addr* iter_server_selection(struct iter_env* iter_env, 
    struct module_env* env, struct delegpt* dp, uint8_t* name, 
    size_t namelen, uint16_t qtype, int* dnssec_lame,
    int* chase_to_rd, int open_target, struct sock_list* blacklist,
    time_t prefetch);

struct dns_msg* dns_alloc_msg(struct sldns_buffer* pkt, struct msg_parse* msg, 
    struct regional* regional);

struct dns_msg* dns_copy_msg(struct dns_msg* from, struct regional* regional);

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

int iter_ns_probability(struct ub_randstate* rnd, int n, int m);

void iter_mark_cycle_targets(struct module_qstate* qstate, struct delegpt* dp);

void iter_mark_pside_cycle_targets(struct module_qstate* qstate,
    struct delegpt* dp);

int iter_dp_is_useless(struct query_info* qinfo, uint16_t qflags, 
    struct delegpt* dp);

int iter_qname_indicates_dnssec(struct module_env* env,
    struct query_info *qinfo);

int iter_indicates_dnssec(struct module_env* env, struct delegpt* dp,
    struct dns_msg* msg, uint16_t dclass);

int iter_msg_has_dnssec(struct dns_msg* msg);

int iter_msg_from_zone(struct dns_msg* msg, struct delegpt* dp, 
    enum response_type type, uint16_t dclass);

int reply_equal(struct reply_info* p, struct reply_info* q, struct regional* region);

void caps_strip_reply(struct reply_info* rep);

int caps_failed_rcode(struct reply_info* rep);

void iter_store_parentside_rrset(struct module_env* env, 
    struct ub_packed_rrset_key* rrset);

void iter_store_parentside_NS(struct module_env* env, struct reply_info* rep);

void iter_store_parentside_neg(struct module_env* env, 
    struct query_info* qinfo, struct reply_info* rep);

int iter_lookup_parent_NS_from_cache(struct module_env* env,
    struct delegpt* dp, struct regional* region, struct query_info* qinfo);

int iter_lookup_parent_glue_from_cache(struct module_env* env,
    struct delegpt* dp, struct regional* region, struct query_info* qinfo);

int iter_get_next_root(struct iter_hints* hints, struct iter_forwards* fwd,
    uint16_t* c);

void iter_scrub_ds(struct dns_msg* msg, struct ub_packed_rrset_key* ns,
    uint8_t* z);

void iter_dec_attempts(struct delegpt* dp, int d);

void iter_merge_retry_counts(struct delegpt* dp, struct delegpt* old);

int iter_ds_toolow(struct dns_msg* msg, struct delegpt* dp);

int iter_dp_cangodown(struct query_info* qinfo, struct delegpt* dp);
 
#endif /* ITERATOR_ITER_UTILS_H */