Skip to content
Jim Hague edited this page Apr 19, 2021 · 56 revisions

DNS-STATS Compactor project homepage

The DNS-STATS Compactor project is a set of tools for capturing and working with DNS server traffic recorded in Compacted-DNS (C-DNS) files. C-DNS is a space-efficient file format for storing DNS traffic. It is defined in RFC8618.

Versions

Release 1.0.0 and later implement RFC8618. The previous Compactor production release (0.12) is based on the earlier Internet Draft draft-ietf-dnsop-dns-capture-format-04.

Supported Versions

Version 0.12 is no longer maintained.

License

DNS-STATS Compactor is an open source project licensed under the Mozilla Public License v2.0.

See About for more details.

Latest release

Experimental

Update 2021-04-19

1.2.0-rc1: This release adds DNSTAP capture from either file or a Unix socket. It also adds an implementation-specific C-DNS field to each block header recording the collection start time. This time is reported in .info files and used in the file duration calculation. Also corrected processed message count (RFC8618 quantity); this was previously the raw packet count, which is still reported but recorded as a compactor C-DNS extension.

Production

Update 2020-12-09

1.1.0: This release adds an implementation-specific C-DNS field to each block header recording the time the block rolls over. A new section in .info files reports the time range covered by a C-DNS file.

Documentation and Installation

For the production release see the PDF User Guide which includes detailed installation instructions.

Or download this nicer HTML User Guide to view offline (since the GitHub wiki will only show this as raw HTML - we are working on a better website!).

For the experimental release see the PDF User Guide or download the HTML User Guide.

Distribution Packages

Debian packages for the production 1.1.0 release are available from ppa:dns-stats/compactor.

Debian packages for experimental releases are available from ppa:dns-stats/compactor-unstable.

Code

Branches

As of the 1.0.0 release develop and master now contain the 1.0 code.

The 0.12 release is maintained from the 0.12 branch.

Support

Contributors

  • The Comcast Innovation Fund generously supported the work of implementing the RFC format in version 1.0 of compactor via a grant.
Clone this wiki locally