Reference implementation of the DNS-Class algorithm in Python
Python C C++ Shell M
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



dnsclass: open source, reference implementation of the DNS-Class algorithm in Python.

The classifier takes as input ARFF files generated with the Flowcalc program (using the dns and lpi plugins). dnsclass classifies given network traffic flows basing on their DNS context and outputs a classification report.

The classification process is divided into several steps, into script files named stepN_*, e.g. There are also scripts named cvN_* that support cross-validation.

For scientific works, please cite the following paper:

Foremski P., Callegari C., Pagano M., "DNS-Class: Immediate classification of IP flows using DNS"

Author: Paweł Foremski
Copyright (C) 2012-2013 IITiS PAN Gliwice
Licensed under GNU GPL v3

This software package uses libshorttext, which is included in the dnsclass repository, but may be licensed differently.

Classifier steps

The purpose of the steps:

  • reformat input ARFF files into the target text input format; skip all flows but those of selected protocols; some corrections may be required to match your ARFF files
  • divide the dataset into training and testing (may be skipped)
  • convert the training dataset into the libsvm format (Vector Space Model (VSM))
  • train the model
  • as step 3, but for the testing dataset
  • classify the testing dataset
  • show the confusion matrix and errors made in step 6

Project information

Project realized at The Institute of Theoretical and Applied Informatics of the Polish Academy of Sciences, under grant nr 2011/01/N/ST6/07202 of the Polish National Science Centre.

Project website: