statzone

DNS zone file analyzer targeted at TLD zones
Log | Files | Refs | README | LICENSE

README.md (1681B)


      1 # StatZone
      2 
      3 StatZone is a DNS zone file analyzer targeted at TLD zones.
      4 
      5 After analyzing a zone, it returns counts for: IPv4 and IPv6 glue records,
      6 NS records (total and uniques), DS records, DNSSEC signed domains, IDNs
      7 domains, and total number of domains.
      8 
      9 It is currently used to generate TLD Zone File Statistics on [StatDNS][1].
     10 
     11 StatZone is written with security in mind, and has also been extensively
     12 fuzzed using AFL and Honggfuzz. Experimental seccomp support is available
     13 for selected architectures and can be enabled by setting the `ENABLE_SECCOMP`
     14 variable to `1` when invoking CMake.
     15 
     16 ## Dependencies
     17 
     18 StatZone uses the CMake build system.
     19 
     20 ## Building
     21 
     22 	mkdir build
     23 	cd build
     24 	cmake ..
     25 	make
     26 
     27 StatZone has been successfully built and tested on OpenBSD and Linux with
     28 both Clang and GCC.
     29 
     30 ## Usage
     31 
     32 	statzone [-hv] zonefile
     33 
     34 If file is a single dash (`-'), statzone reads from the standard input.
     35 
     36 The options are as follows:
     37 
     38 	-h	Display usage.
     39 	-v	Display version.
     40 
     41 StatZone outputs results to **stdout**.
     42 
     43 TLD zone files for .arpa can be found on [Internic FTP site][2], .se and
     44 .nu zones are available through AXFR at zonedata.iis.se.
     45 
     46 ## Features
     47 
     48 Currently implemented features:
     49 
     50 - Counting IPv4 and IPv6 glue
     51 - Counting name servers (total and unique)
     52 - Counting DS records
     53 - Counting DNSSEC signed domains
     54 - Counting IDNs domains
     55 - Counting domains
     56 
     57 ## License
     58 
     59 StatZone is released under the BSD 2-Clause license. See `LICENSE` file for
     60 details.
     61 
     62 ## Author
     63 
     64 StatZone is developed by Frederic Cambus.
     65 
     66 - Site: https://www.cambus.net
     67 
     68 ## Resources
     69 
     70 GitHub: https://github.com/fcambus/statzone
     71 
     72 [1]: https://www.statdns.com
     73 [2]: https://www.internic.net/domain/