Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 occurrences).

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 occurrence of every value  of  the  matchname  (for  in-
	    stance, 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 unde-
	    fined.

     -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 ex-
     pressions.

     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 percentages.

     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 <dns-team@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 PURPOSE.

				   1 Nov 2005				  dpa(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ldns-dpa&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help