ldns-test-edns(1) [centos man page]

ldns-test-edns(1)					      General Commands Manual						 ldns-test-edns(1)

NAME

       ldns-test-edns - test if dns cache supports EDNS and DNSSEC.

SYNOPSIS

       ldns-test-edns [ -i ] { ip }

DESCRIPTION

       ldns-test-edns tests a DNS cache and checks if it supports EDNS0 and DNSSEC types so that it can be used as a dnssec-enabled DNS cache.	It
       sends two queries to the cache, one for the root key and one for a DS record.  These must succeed, the answer must have EDNS, that type and
       signatures.

       If  the	IP address is good for DNSSEC, it is printed with 'OK'.  Otherwise short description is given of the failure.  If OK is given, the
       cache should be good to use as a cache for a local configured DNSSEC validator.

       The tool assumes the root is signed and Sweden is signed.  Also, the queries are sent with the CD flag, the tool does not  check  that  the
       results are validated, but that they can be validated.

OPTIONS

       -i  option  enables  a mode where the working IP addresses are printed after another, with no other explanations, and if none work or no IP
       addresses are on the input, 'off' is printed.

       ldns-test-edns takes one or more IP addresses, it checks them in turn.  IPv4 and IPv6 addresses can be given.  The exit value  is  for  the
       last checked IP address: 0 is OK, 1 is failure, 2 is some sort of network failure.

AUTHOR

       Written by the ldns team as an example for ldns usage.

REPORTING BUGS

       Report bugs to <ldns-team@nlnetlabs.nl>.

COPYRIGHT

       Copyright  (C)  2010 NLnet Labs. This is free software. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
       POSE.

								    14 Dec 2010 						 ldns-test-edns(1)

ldns(3) 						     Library Functions Manual							   ldns(3)

NAME

       ldns_pkt_edns,	 ldns_pkt_edns_udp_size,   ldns_pkt_edns_extended_rcode,   ldns_pkt_edns_version,   ldns_pkt_edns_z,   ldns_pkt_edns_data,
       ldns_pkt_set_edns_udp_size, ldns_pkt_set_edns_extended_rcode, ldns_pkt_set_edns_version, ldns_pkt_set_edns_z, ldns_pkt_set_edns_data-

SYNOPSIS

       #include <stdint.h>
       #include <stdbool.h>

       #include <ldns/ldns.h>

       bool ldns_pkt_edns(const ldns_pkt *packet);

       uint16_t ldns_pkt_edns_udp_size(const ldns_pkt *packet);

       uint8_t ldns_pkt_edns_extended_rcode(const ldns_pkt *packet);

       uint8_t ldns_pkt_edns_version(const ldns_pkt *packet);

       uint16_t ldns_pkt_edns_z(const ldns_pkt *packet);

       ldns_rdf* ldns_pkt_edns_data(const ldns_pkt *packet);

       void ldns_pkt_set_edns_udp_size(ldns_pkt *packet, uint16_t s);

       void ldns_pkt_set_edns_extended_rcode(ldns_pkt *packet, uint8_t c);

       void ldns_pkt_set_edns_version(ldns_pkt *packet, uint8_t v);

       void ldns_pkt_set_edns_z(ldns_pkt *packet, uint16_t z);

       void ldns_pkt_set_edns_data(ldns_pkt *packet, ldns_rdf *data);

DESCRIPTION

       ldns_pkt_edns() returns true if this packet needs and EDNS rr to be sent.  At the moment the only reason is an expected packet size  larger
	      than 512 bytes, but for instance dnssec would be a good reason too.

	      packet: the packet to check
	      Returns true if packet needs edns rr

       ldns_pkt_edns_udp_size() return the packet's edns udp size
	      packet: the packet
	      Returns the size

       ldns_pkt_edns_extended_rcode() return the packet's edns extended rcode
	      packet: the packet
	      Returns the rcode

       ldns_pkt_edns_version() return the packet's edns version
	      packet: the packet
	      Returns the version

       ldns_pkt_edns_z() return the packet's edns z value
	      packet: the packet
	      Returns the z value

       ldns_pkt_edns_data() return the packet's edns data
	      packet: the packet
	      Returns the data

       ldns_pkt_set_edns_udp_size() Set the packet's edns udp size
	      packet: the packet
	      s: the size

       ldns_pkt_set_edns_extended_rcode() Set the packet's edns extended rcode
	      packet: the packet
	      c: the code

       ldns_pkt_set_edns_version() Set the packet's edns version
	      packet: the packet
	      v: the version

       ldns_pkt_set_edns_z() Set the packet's edns z value
	      packet: the packet
	      z: the value

       ldns_pkt_set_edns_data() Set the packet's edns data
	      packet: the packet
	      data: the data

AUTHOR

       The ldns team at NLnet Labs. Which consists out of Jelte Jansen and Miek Gieben.

REPORTING BUGS

       Please report bugs to ldns-team@nlnetlabs.nl or in our bugzilla at http://www.nlnetlabs.nl/bugs/index.html

COPYRIGHT

       Copyright (c) 2004 - 2006 NLnet Labs.

       Licensed under the BSD License. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       ldns_pkt.  And perldoc Net::DNS, RFC1034, RFC1035, RFC4033, RFC4034  and RFC4035.

REMARKS

       This manpage was automaticly generated from the ldns source code by use of Doxygen and some perl.

								    30 May 2006 							   ldns(3)