Unix/Linux Go Back    


CentOS 7.0 - man page for ldns-testns (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


ldns-testns(1)									   ldns-testns(1)

NAME
       ldns-testns - simple fake nameserver tool

SYNOPSYS
       ldns-testns [ OPTION ] datafile

DESCRIPTION
       ldns-testns  can  be  used to provide answers to DNS queries for testing.  The answers are
       premade, and can be tailored to testing needs.  The  answers  can  be  wildly  invalid  or
       unparseable.

       This  program is a debugging aid. It is not efficient, especially with a long config file,
       but it can give any reply to any query.	This can help the  developer  pre-script  replies
       for queries.

       It  listens  to IP4 UDP and TCP by default.  You can specify a packet RR by RR with header
       flags to return.

       ldns-testns is not meant for production use.

OPTIONS
       -r     Listens to a random port. The port number is printed to stdout.

       -p port
	      Listens to the specified port.

       -f num Forks this number of additional instances  that  serve  the  same  ports	and  same
	      datafile.  They  do  not	exit; printed is 'forked pid: <num>' and you have to kill
	      them yourself.

       -v     Outputs more debug information. It is possible to give this option  multiple  times
	      to increase verbosity level.

       -6     Bind to IP6 address instead of IP4. Use together with -p.

       datafile
	      The  data file is read on start up. It contains queries and the packets that should
	      be sent in answer to those queries. The data file format is explained below.

DATA FILE FORMAT
       The data file format has ';' to denote comment. A number of entries are processed first to
       last. The first matching entry is used to answer the query with. This is a line based for-
       mat. DNS resource records are entered in zone-file format.

       You can use $ORIGIN and $TTL directives. Zone file '(' and ')' to span multiple lines  are
       not allowed.

       $ORIGIN origin $TTL default_ttl

       ENTRY_BEGIN

       ;  first  give MATCH lines, that say what queries are matched ; by this entry.  ; 'opcode'
       makes the query match the opcode from the reply ; if you leave it out, any opcode  matches
       this  entry.  ; 'qtype' makes the query match the qtype from the reply ; 'qname' makes the
       query match the qname from the reply ; 'serial=1023' makes the query match if ixfr  serial
       is 1023.

       MATCH [opcode] [qtype] [qname] [serial=<value>] MATCH [UDP|TCP] MATCH ...

       ; Then the REPLY header is specified.

       REPLY opcode, rcode or flags.
	       (opcode)  QUERY IQUERY STATUS NOTIFY UPDATE
	       (rcode)	 NOERROR FORMERR SERVFAIL NXDOMAIN NOTIMPL YXDOMAIN
			       YXRRSET NXRRSET NOTAUTH NOTZONE
	       (flags)	 QR AA TC RD CD RA AD

       REPLY ...

       ; any additional actions to do.

       ADJUST copy_id  ; 'copy_id' copies the ID from the query to the answer.

       ; 'sleep=10' sleeps for 10 seconds before giving the answer (TCP is open)

       ADJUST  [sleep=<num>]	 ;  sleep  before giving any reply ADJUST [packet_sleep=<num>]	;
       sleep before this packet in sequence

       SECTION QUESTION <RRs, one per line>    ; the RRcount is determined automatically.

       SECTION ANSWER <RRs, one per line>

       SECTION AUTHORITY <RRs, one per line>

       SECTION ADDITIONAL <RRs, one per line>

       EXTRA_PACKET	       ; follow with SECTION, REPLY for more  packets.	 HEX_ANSWER_BEGIN
       ; follow with hex data
			       ; this replaces any answer packet constructed
			       ; with the SECTION keywords (only SECTION QUERY
			       ; is used to match queries). If the data cannot
			       ; be parsed, ADJUST rules for the answer packet
			       ; are ignored

       HEX_ANSWER_END

       ENTRY_END

AUTHOR
       Written by the ldns team as an example for ldns usage, and for testing purposes.

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

COPYRIGHT
       Copyright  (C) 2006-2008 NLnet Labs. This is free software. There is NO warranty; not even
       for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

					   14 Dec 2006				   ldns-testns(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 09:18 AM.