statzone

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

README.md (1806B)


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