.\" 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 \- ابزاری برای آزمایش بازگشت‌دهنده DNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcalidns\fP [\fIOPTIONS\fP] \fIQUERY_FILE\fP \fIDESTINATION\fP \fIINITIAL_QPS\fP \fIHITRATE\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBcalidns\fP پرس‌وجوها را از \fIQUERY_FILE\fP خوانده و آن‌ها را به‌صورت یک پرس‌وجوی بازگشتی به \fIDESTINATION\fP (یک نشانی IPv4 یا IPv6، به همراه شماره درگاه اختیاری) ارسال می‌کند؛ کار با نرخ اولیه \fIINITIAL_QPS\fP پرس‌وجو در ثانیه آغاز می‌شود و هدف، دستیابی به نرخ برخورد حافظه نهان (cache hitrate) معادل \fIHITRATE\fP درصد است.
.sp
سپس برنامه تلاش می‌کند تا بیشینه تعداد پرس‌وجو در ثانیه‌ای که بازگشت‌دهنده می‌تواند با \fIHITRATE\fP یادشده مدیریت کند را تعیین نماید\&.
.SH "قالب QUERY_FILE (QUERY_FILE FORMAT)"
.sp
قالب \fIQUERY_FILE\fP بسیار ساده است؛ این فایل باید شامل تاپل‌های \(dqQNAME QTYPE\(dq باشد، یک مورد در هر خط. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
powerdns.com A
powerdns.com AAAA
google.com A
.EE
.UNINDENT
.UNINDENT
.sp
این ساختار مشابه فهرست ۱ میلیون سایت برتر Alexa است.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.BI \-\-ecs \ <SUBNET>
افزودن گزینه EDNS Client Subnet به پرس‌وجوهای خروجی با استفاده از نشانی‌های تصادفی از محدوده مشخص‌شده در \fISUBNET\fP (تنها برای IPv4).
.TP
.B  \-\-ecs\-from\-file
خواندن مقادیر IP یا زیرشبکه (subnet) از فایل پرس‌وجو و افزودن آن‌ها به‌عنوان گزینه EDNS Client Subnet به پرس‌وجوهای خروجی.
.TP
.BI \-\-increment \ <NUM>
در هر اجرای متوالی، تعداد پرس‌وجو در ثانیه را در \fINUM\fP ضرب می‌کند\&. به‌طور پیش‌فرض، این مقدار 1.1 است.
.TP
.BI \-\-maximum\-qps \ <NUM>
به منظور ایجاد یک بار پایدار، افزایش نرخ پس از رسیدن به این مقدار متوقف می‌شود.
.TP
.BI \-\-minimum\-success\-rate \ <NUM>
توقف آزمایش به محض اینکه نرخ موفقیت بر حسب درصد، به زیر این مقدار افت کند.
.TP
.BI \-\-plot\-file \ <FILE>
نوشتن نتایج در فایل مشخص‌شده.
.TP
.B  \-\-proxy\-protocol
ارسال یک داده‌بار (payload) پروتکل Proxy پیش از پرس‌وجوهای خروجی با استفاده از نشانی‌های تصادفی از محدوده مشخص‌شده (تنها IPv4) به‌عنوان IP مبدا اولیه.
.TP
.B  \-\-proxy\-protocol\-from\-file
خواندن مقادیر IP یا زیرشبکه از فایل پرس‌وجو و استفاده از آن‌ها به‌عنوان IP مبدا در داده‌بارهای پروتکل Proxy پیش از پرس‌وجوهای خروجی.
.TP
.B  \-\-quiet
اجرا در حالت بی‌صدا، به‌طوری که تنها بیشینه QPS حاصل‌شده در خروجی نمایش داده شود. این گزینه بیشتر هنگامی مفید است که به همراه \fB\-\-minimum\-success\-rate\fP استفاده شود\&.
.TP
.B  \-\-want\-recursion
تنظیم این پرچم جهت ارسال پرس‌وجوها با پرچم فعال Recursion Desired.
.UNINDENT
.SH "نویسندگان (AUTHORS)"
PowerDNS.COM BV
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.