/ 
DNS-LDNS-0.63
River stage zero No dependents
/ DNS::LDNS::Resolver

NAME

DNS::LDNS::Resolver - DNS resolver

SYNOPSIS

use DNS::LDNS ();

my r = DNS::LDNS::Resolver->new(filename => '/my/resolv.conf')
my r = DNS::LDNS::Resolver->new(file => \*FILE)
my r = DNS::LDNS::Resolver->new

bool = r->dnssec
r->set_dnssec(bool)

bool = r->dnssec_cd        # Resolver sets the CD bit
r->set_dnssec_cd(bool)

port = r->port
r->set_port(port)

bool = r->recursive
r->set_recursive(bool)

bool = r->debug
r->set_debug(bool)

count = r->retry
r->set_retry(count)

count = r->retrans
r->set_retrans(count)

bool = r->fallback          # Resolver truncation fallback mechanism
r->set_fallback(bool)

bool = r->ip6
r->set_ip6(bool)

size = r->edns_udp_size
r->set_edns_udp_size(size)

bool = r->usevc             # Use virtual circuit (TCP)
r->set_usevc(bool)

r->fail
r->set_fail

r->defnames
r->set_defnames

r->dnsrch
r->set_dnsrch

r->igntc
r->set_igntc

bool = r->random            # randomize nameserver before usage
r->set_random(bool)

rrlist = r->dnssec_anchors  # list of trusted DNSSEC anchors
r->push_dnssec_anchor(rr)
r->set_dnssec_anchors(rrlist)

rdata = r->domain           # Domain to add to relative queries
r->set_domain(rdata)

@rdata = r->nameservers
count = r->nameserver_count
r->push_nameserver(rdata)
rdata = r->pop_nameserver
r->nameservers_randomize

str = r->tsig_keyname
r->set_tsig_keyname(str)

str = r->tsig_algorithm
r->set_tsig_algorithm(str)

str = r->tsig_keydata
r->set_tsig_keydata(str)

count = r->searchlist_count
r->push_searchlist(rdata)
@rdata = r->searchlist

@times = r->rtt              # Round trip times
r->set_rtt(@rtt)
time = r->nameserver_rtt(pos)
r->set_nameserver_rtt(pos, time)

(sec, usec) = r->timeout
r->set_timeout(sec, usec)

# DNSSec validation
rrlist = r->fetch_valid_domain_keys(domain, keys)
rrlist = r->fetch_valid_domain_keys_time(domain, keys, checktime)
rrlist = r->validate_domain_ds(domain, keys)
rrlist = r->validate_domain_ds_time(domain, keys, checktime)
rrlist = r->validate_domain_dnskey(domain, keys)
rrlist = r->validate_domain_dnskey_time(domain, keys, checktime)
status = r->verify_trusted(rrset, rrsigs, validation_keys)
status = r->verify_trusted_time(rrset, rrsigs, checktime, validation_keys)
bool = r->trusted_key(keys, trusted_keys)
chain = r->build_data_chain(qflags, dataset, pkt, orig_rr)

# Query
pkt = r->query(rdata, type, class, flags)
pkt = r->search(rdata, type, class, flags)
query = r->prepare_query_pkt(rdata, type, class, flags)
answer = r->send(rdata, type, class, flags)
answer = r->send_pkt(query)
rrlist = r->get_rr_list_addr_by_name(name, class, flags)
rrlist = r->get_rr_list_name_by_addr(addr, class, flags)

SEE ALSO

http://www.nlnetlabs.nl/projects/ldns

AUTHOR

Erik Pihl Ostlyngen, <erik.ostlyngen@uninett.no>

COPYRIGHT AND LICENSE

Copyright (C) 2013 by UNINETT Norid AS

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.