.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CALIDNS" "1" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
calidns \- A DNS recursor testing tool
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcalidns\fP [\fIOPTIONS\fP] \fIQUERY_FILE\fP \fIDESTINATION\fP \fIINITIAL_QPS\fP \fIHITRATE\fP
.SH "توضیحات (DESCRIPTION)"
.sp
\fBcalidns\fP reads queries from \fIQUERY_FILE\fP and sends them as a
recursive query to \fIDESTINATION\fP (an IPv4 or IPv6 address, optionally
with a port number), starting at INITIAL_QPS queries per second and
aims to have a cache hitrate of \fIHITRATE\fP percent.
.sp
It will then try to determine the maximum amount of queries per second
the recursor can handle with the aforementioned \fIHITRATE\fP\&.
.SH QUERY_FILE FORMAT
.sp
The format of the \fIQUERY_FILE\fP is very simple, it should contain
\(dqQNAME QTYPE\(dq tuples, one per line. For example:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
powerdns.com A
powerdns.com AAAA
google.com A
.EE
.UNINDENT
.UNINDENT
.sp
This is similar to Alexa top 1 million list.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.BI \-\-ecs \ <SUBNET>
Add EDNS Client Subnet option to outgoing queries using random
addresses from the specified \fISUBNET\fP range (IPv4 only).
.TP
.B  \-\-ecs\-from\-file
Read IP or subnet values from the query file and add them as EDNS
Client Subnet option to outgoing queries.
.TP
.BI \-\-increment \ <NUM>
On every subsequent run, multiply the number of queries per second
by \fINUM\fP\&. By default, this is 1.1.
.TP
.BI \-\-maximum\-qps \ <NUM>
Stop incrementing once this rate has been reached, to provide a
stable load.
.TP
.BI \-\-minimum\-success\-rate \ <NUM>
Stop the test as soon as the success rate drops below this value,
in percent.
.TP
.BI \-\-plot\-file \ <FILE>
Write results to the specified file.
.TP
.B  \-\-proxy\-protocol
Send a Proxy Protocol payload in front of outgoing queries using
random addresses from the specified range (IPv4 only) as the initial
source IP.
.TP
.B  \-\-proxy\-protocol\-from\-file
Read IP or subnet values from the query file and use them as the
source IP in Proxy Protocol payloads in front of outgoing queries.
.TP
.B  \-\-quiet
Whether to run quietly, outputting only the maximum QPS reached.
This option is mostly useful when used with \fB\-\-minimum\-success\-rate\fP\&.
.TP
.B  \-\-want\-recursion
Set this flag to send queries with the Recursion Desired flag set.
.UNINDENT
.SH "نویسنده (AUTHOR)"
PowerDNS.COM BV
.SH "حق نشر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.