main/flail
main/flail
Watch
2
0
Fork
You've already forked flail
 0
Code Releases Activity
DNS stress testing tool
246 commits 4 branches 2 tags 1.5 MiB
  • Java 98.2%
  • CSS 1.8%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Mark Raynsford a5b33bf1c6
 Update workflows.
2026-07-31 18:42:51 +01:00
.forgejo Update workflows. 2026-07-31 18:42:51 +01:00
src Update site metadata. 2025-08-09 15:06:01 +00:00
.gitignore Update .gitignore. 2024-05-07 16:01:41 +00:00
.gitmodules Move to new organization. 2024-04-28 21:17:52 +00:00
doc7m-books.json Add doc7m-books.json 2026-07-31 18:36:42 +01:00
pom.xml Migrate project. 2026-06-27 11:06:21 +01:00
README-CHANGES.xml Mark release 1.0.0 2024-06-23 17:28:25 +00:00
README-LICENSE.txt Update LICENSE 2023-08-13 21:16:10 +00:00
README.in Migrate project. 2026-06-27 11:06:21 +01:00
README.md Migrate project. 2026-06-27 11:06:21 +01:00

README.md

flail

Maven Central Maven Central (snapshot) Java Version

com.io7m.flail

flail

The flail package provides a command-line DNS server stress testing tool. The tool is a paper-thin wrapper around the excellent DNSJava library.

Features

  • Command line tool for executing large numbers of requests against a DNS server.
  • ISC license.

Usage

Place a list of hostnames, one per line, in a file called names.txt.

$ cat names.txt
debian.org
example.com
freebsd.org
www.debian.org
www.example.com
www.freebsd.org

Assuming the DNS server under test is at dns.example.com on port 53:

java -jar flail.jar names.txt dns.example.com 53

The program will make random requests for A records for all the names in names.txt as quickly as possible. The program will produce lines such as:

17:22:52.483 [main] INFO com.io7m.flail.FlailMain -- requests: 280/280/0 (total/successes/failures)
17:22:52.544 [main] INFO com.io7m.flail.FlailMain -- requests: 290/290/0 (total/successes/failures)
17:22:52.604 [main] INFO com.io7m.flail.FlailMain -- requests: 300/300/0 (total/successes/failures)
17:22:52.663 [main] INFO com.io7m.flail.FlailMain -- requests: 310/310/0 (total/successes/failures)
17:22:52.724 [main] INFO com.io7m.flail.FlailMain -- requests: 320/320/0 (total/successes/failures)
17:22:52.784 [main] INFO com.io7m.flail.FlailMain -- requests: 330/330/0 (total/successes/failures)
17:22:52.844 [main] INFO com.io7m.flail.FlailMain -- requests: 340/340/0 (total/successes/failures)
17:22:52.905 [main] INFO com.io7m.flail.FlailMain -- requests: 350/350/0 (total/successes/failures)

The program will run indefinitely until it is interrupted.