dpa(1)							      General Commands Manual							    dpa(1)

NAME

       dpa - DNS Packet Analyzer. Analyze DNS packets in ip trace files

SYNOPSIS

       dpa [ OPTION ] TRACEFILE

DESCRIPTION

       dpa  is	used  to  analyze  dns	packets  in trace files. It has 3 main options: count, filter, and count uniques (i.e. count all different
       occurences).

OPTIONS

       -c expressionlist
	      Count occurrences of matching expressions

       -f expression
	      Filter: only process packets that match the expression

       -h     Show usage

       -p     Show the total number of correct DNS packets, and percentage of -u and -c values	(of the total of matching on the -f filter. if	no
	      filter is given, percentages are on all correct dns packets)

       -of file
	      Write all packets that match the -f flag to file, as pcap data.

       -ofh file
	      Write all packets that match the -f flag to file, in hexadecimal format, readable by drill.

       -s     Show possible match names

       -s matchname
	      show possible match operators and values for name

       -sf    Only evaluate packets (in representation format) that match the -f filter.  If no -f was given, evaluate all correct dns packets.

       -u matchnamelist
	      Count every occurence of every value of the matchname (for instance, count all packetsizes, see EXAMPLES in ldns-dpa(1) ).

       -ua    For  every  matchname  in  -u, show the average value of all matches. Behaviour for match types that do not have an integer value is
	      undefined.

       -uac   For every matchname in -u, show the average number of times this value was encountered.

       -um number
	      Only show the results from -u for values that occurred more than <number> times.

       -v level
	      Set verbosity to level (1-5, 5 being the highest). Mostly used for debugging.

       -notip file
	      Write packets that were not recognized as IP packets to file (as pcap data).

       -baddns file
	      Write dns packets that were too mangled to parse to file (as pcap data).

       -version
	      Show version and exit

LIST AND MATCHES

       A <matchnamelist> is a comma separated list of match names (use -s to see possible match names).  A <expressionlist> is a  comma  separated
       list of expressions.

       An expression has the following form: <expr>: (<expr>)
	       <expr> | <expr>
	       <expr> & <expr>
	       <match>

       <match>:        <matchname> <operator> <value>

       <operator>:	 =    equal  to  <value>       !=   not  equal	to  <value>	  >    greater	than <value>	  <    lesser than <value>
	    >=	 greater than or equal to <value>      <=   lesser than or equal to <value>	 ~=   contains <value>

       See the -s option for possible matchnames, operators and values.

EXAMPLES

       ldns-dpa -u packetsize -p test.tr
	      Count all different packetsizes in test.tr and show the precentages.

       ldns-dpa -f "edns=1&qr=0" -of edns.tr test.tr
	      Filter out all edns enable queries in test.tr and put them in edns.tr

       ldns-dpa -f edns=1 -c tc=1 -u rcode test.tr
	      For all edns packets, count the number of truncated packets and all their rcodes in test.tr.

       ldns-dpa -c tc=1,qr=0,qr=1,opcode=QUERY test.tr
	      For all packets, count the number of truncated packets, the number of packets with qr=0, the number of packets  with  qr=1  and  the
	      number of queries in test.tr.

       ldns-dpa -u packetsize -ua test.tr
	      Show all packet sizes and the average packet size per packet.

       ldns-dpa -u srcaddress -uac test.tr
	      Show all packet source addresses and the average number of packets sent from this address.

       sudo tcpdump -i eth0 -s 0 -U -w - port 53 | ldns-dpa -f qr=0 -sf
	      Print all query packets seen on the specified interface.

AUTHOR

       Written by Jelte Jansen for NLnetLabs.

REPORTING BUGS

       Report bugs to <jelte@nlnetlabs.nl>.

COPYRIGHT

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

								    1 Nov 2005								    dpa(1)