.\" 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 "DNSTCPBENCH" "1" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
dnstcpbench \- ابزاری برای ارزیابی کارایی TCP در کارگزارهای نام
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnstcpbench\fP [\fIOPTION\fP]... \fIREMOTE\-ADDRESS\fP [\fIREMOTE\-PORT\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBdnstcpbench\fP پرس‌وجوهای DNS را (به‌طور پیش‌فرض از ورودی استاندارد) خوانده و آن‌ها را به‌صورت موازی به یک کارگزار نام دوردست ارسال می‌کند. به‌طور پیش‌فرض TCP/IP استفاده می‌شود، اما به‌صورت اختیاری، ابتدا UDP آزمایش می‌شود که امکان سنجش کارایی عقب‌نشینی (fallback) به TCP/IP را فراهم می‌سازد.
.sp
این برنامه مقادیر میانگین و میانه را برای پرس‌وجو بر ثانیه و همچنین تأخیر UDP و TCP گزارش می‌دهد. هر پرس‌وجو تنها یک‌بار شمرده می‌شود، حتی اگر ابتدا از طریق UDP آزمایش شده باشد. این امر در عمل بدان معناست که ارسال گزینهٔ \(aq\-u\(aq می‌تواند در صورت ارجاع بسیاری از پرس‌وجوها به TCP، نرخ پرس‌وجو را کاهش دهد.
.sp
قالب ورودی به‌صورت یک پرس‌وجو در هر خط است: qname تک\-فاصله qtype. یک مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
www.powerdns.com ANY
.EE
.UNINDENT
.UNINDENT
.sp
هنگام سنجش کارایی در اجراهای طولانی‌مدت، ممکن است فعال‌سازی بازیافت TIME_WAIT ضروری باشد، زیرا در غیر این صورت ممکن است تاپل‌های پورت TCP/IP تمام شوند. در لینوکس این کار با اجرای دستور زیر انجام می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
echo 1 > /proc/sys/net/ipv4/tcp_tw_recycle
.EE
.UNINDENT
.UNINDENT
.sp
معادل این مورد برای IPv6 شناخته‌شده نیست.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B REMOTE\-ADDRESS
آدرس IPv4 یا IPv6 مقصد برای ارزیابی.
.TP
.B REMOTE\-PORT
پورت مقصد برای ارزیابی؛ پیش‌فرض 53 است.
.UNINDENT
.INDENT 0.0
.TP
.BI \-f \ <FILENAME>\fR,\fB \ \-\-file \ <FILENAME>
مسیر \fIFILENAME\fP برای خواندن پرس‌وجوها از آن. در صورت عدم تعیین، به‌طور پیش‌فرض از ورودی استاندارد خوانده می‌شود.
.TP
.B  \-h\fP,\fB  \-\-help
نمایش پیام راهنما.
.TP
.BI \-\-timeout\-msec \ <MSEC>
مدت‌زمان انتظار برای پاسخ بر حسب میلی‌ثانیه (\fIMSEC\fP).
.TP
.B  \-u\fP,\fB  \-\-udp\-first
تلاش برای تحلیل دامنه ابتدا از طریق UDP؛ استفاده از TCP تنها در صورتی که پاسخی ناقص یا بریده‌شده (truncated) دریافت شود.
.TP
.B  \-v\fP,\fB  \-\-verbose
ارائه توضیحات تفصیلی در مورد اقدامات برنامه.
.TP
.BI \-\-workers \ <NUM>
استفاده از \fINUM\fP ریسه (thread) کارگر موازی.
.UNINDENT
.SH "گزارش باگ‌ها (BUGS)"
.sp
در حال حاضر کد مربوط به مهلت زمانی (timeout) در عمل اتصالات یا نوشتن‌های غیرمسدودکننده (non\-blocking) انجام نمی‌دهد. بنابراین یک اتصال کند یا نوشتن‌های کند همچنان موجب کاهش کارایی و بروز تأخیر خواهند شد.
.sp
آمار میانهٔ پرس‌وجو بر ثانیه برای اجراهای کمتر از یک ثانیه، 0 گزارش می‌شود.
.SH "نویسندگان (AUTHORS)"
PowerDNS.COM BV
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.