.\" 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 "UNBOUND-CONTROL" "8" "Aug  4, 2026" "1.26.0" "Unbound"
.SH "نام (NAME)"
unbound-control \- ابزار کنترل و مدیریت راه دور سرور Unbound
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBunbound\-control\fP [\fB\-hq\fP] [\fB\-c cfgfile\fP] [\fB\-s server\fP] command
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBunbound\-control\fP عملیات مدیریت از راه دور را بر روی سرور DNS
\fI\%unbound(8)\fP انجام می‌دهد.
این ابزار فایل پیکربندی را می‌خواند، از طریق TLS با سرور Unbound ارتباط برقرار می‌کند، دستور را ارسال کرده و نتیجه را نمایش می‌دهد.
.sp
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.INDENT 0.0
.TP
.B \-h
نمایش نسخه و راهنمای گزینه‌های خط فرمان.
.UNINDENT
.INDENT 0.0
.TP
.B \-c <cfgfile>
فایل پیکربندی حاوی تنظیمات جهت خواندن.
در صورت مشخص نشدن، از فایل پیکربندی پیش‌فرض
\fB/etc/unbound/unbound.conf\fP استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-s <server[@port]>
آدرس IPv4 یا IPv6 سرور جهت برقراری ارتباط.
در صورت مشخص نشدن، آدرس از فایل پیکربندی خوانده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-q
حالت بی‌صدا؛ در صورت تعیین این گزینه، اگر عملیات با موفقیت انجام شود هیچ خروجی چاپ نمی‌شود.
.UNINDENT
.SH "دستورات (COMMANDS)"
.sp
چندین دستور وجود دارد که سرور آن‌ها را درک می‌کند:
.INDENT 0.0
.TP
.B start
راه‌اندازی سرور.
صرفاً دستور \fI\%unbound(8)\fP را اجرا می‌کند.
فایل اجرایی \fBunbound\fP در متغیر محیطی \fBPATH\fP جستجو می‌شود.
این برنامه با فایل پیکربندی مشخص‌شده از طریق گزینه \fI\%\-c\fP یا فایل پیش‌فرض شروع به کار می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B stop
توقف سرور.
دیمن سرور خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B reload
بارگذاری مجدد سرور.
این دستور حافظه نهان (cache) را پاک کرده و فایل پیکربندی را مجدداً از نو می‌خواند.
.UNINDENT
.INDENT 0.0
.TP
.B reload_keep_cache
بارگذاری مجدد سرور با تلاش برای حفظ حافظه نهان پیام‌ها و RRset در صورتی که پیکربندی (مجدد) اجازه دهد.
این بدان معناست که اندازه حافظه‌های نهان و تعداد رشته‌ها نباید بین دفعات بارگذاری مجدد تغییر کند.
.UNINDENT
.INDENT 0.0
.TP
.B fast_reload [\fB+dpv\fP]
بارگذاری مجدد سرور با به حداقل رساندن زمان از کارافتادگی، به گونه‌ای که پرس‌وجوهای کاربران بدون وقفه پاسخ داده شوند.
این قابلیت نیازمند کامپایل کد با پشتیبانی از رشته‌ها (threads) است.
پیکربندی در یک رشته جداگانه بارگذاری و آماده می‌شود، سپس به طور موقت سرور موجود را متوقف کرده و گزینه‌های پیکربندی را به‌روزرسانی می‌کند.
هدف این است که این توقف کوتاه اثری بر سرویس‌دهی به پرس‌وجوهای کاربران نگذارد.
حافظه نهان حفظ می‌شود.
همچنین پرس‌وجوهای کاربر که در حال پردازش هستند حفظ شده و با گزینه‌های پیکربندی جدید ادامه می‌یابند.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
این دستور در حال حاضر آزمایشی است.
.UNINDENT
.UNINDENT
.sp
میزان حافظه موقت مورد نیاز در حین fast_reload دو برابر مقدار مورد نیاز برای پیکربندی است.
این به این دلیل است که Unbound موقتاً باید هم مقادیر پیکربندی فعلی و هم مقادیر جدید را در حین fast_reload نگهداری کند.
ناحیه‌های (zones) بارگذاری‌شده از دیسک (ناحیه‌های معتبر و ناحیه‌های RPZ) نیز مشمول این میزان حافظه هستند.
.sp
گزینه‌هایی که می‌توان آن‌ها را تغییر داد عبارتند از:
\fI\%forwards\fP،
\fI\%stubs\fP،
\fI\%views\fP،
\fI\%authority zones\fP،
\fI\%RPZ zones\fP و
\fI\%local zones\fP\&.
.sp
همچنین گزینه‌های
\fI\%access\-control\fP و گزینه‌های مشابه،
\fI\%interface\-action\fP و گزینه‌های مشابه و
\fI\%tcp\-connection\-limit\fP\&.
این دستور می‌تواند برخی تغییرات
\fI\%define\-tag\fP
را مجدداً بارگذاری کند که توضیحات بیشتر آن در ادامه آمده است.
گزینه‌های دیگر شامل موارد زیر هستند:
\fI\%insecure\-lan\-zones\fP،
\fI\%domain\-insecure\fP،
\fI\%trust\-anchor\-file\fP،
\fI\%trust\-anchor\fP،
\fI\%trusted\-keys\-file\fP،
\fI\%auto\-trust\-anchor\-file\fP،
\fI\%edns\-client\-string\fP،
ipset،
\fI\%log\-identity\fP،
\fI\%infra\-cache\-numhosts\fP،
\fI\%msg\-cache\-size\fP،
\fI\%rrset\-cache\-size\fP،
\fI\%key\-cache\-size\fP،
\fI\%ratelimit\-size\fP،
\fI\%neg\-cache\-size\fP،
\fI\%num\-queries\-per\-thread\fP،
\fI\%jostle\-timeout\fP،
\fI\%use\-caps\-for\-id\fP،
\fI\%unwanted\-reply\-threshold\fP،
\fI\%tls\-use\-sni\fP،
\fI\%outgoing\-tcp\-mss\fP،
\fI\%ip\-dscp\fP،
\fI\%max\-reuse\-tcp\-queries\fP،
\fI\%tcp\-reuse\-timeout\fP،
\fI\%tcp\-auth\-query\-timeout\fP،
\fI\%delay\-close\fP\&،
\fI\%iter\-scrub\-promiscuous\fP\&،
\fI\%tls\-service\-key\fP\& و
\fI\%tls\-service\-pem\fP\&.
.sp
این دستور با تغییرات
\fI\%interface\fP و
\fI\%outgoing\-interface\fP کار نمی‌کند؛
همچنین با
\fI\%remote control\fP،
\fI\%outgoing\-port\-permit\fP،
\fI\%outgoing\-port\-avoid\fP،
\fI\%msg\-buffer\-size\fP،
تمامی گزینه‌های \fB*\-slabs\fP و
تغییرات \fI\%statistics\-interval\fP سازگار نیست.
.sp
برای \fI\%dnstap\fP این گزینه‌ها را می‌توان تغییر داد:
\fI\%dnstap\-log\-resolver\-query\-messages\fP،
\fI\%dnstap\-log\-resolver\-response\-messages\fP،
\fI\%dnstap\-log\-client\-query\-messages\fP،
\fI\%dnstap\-log\-client\-response\-messages\fP،
\fI\%dnstap\-log\-forwarder\-query\-messages\fP و
\fI\%dnstap\-log\-forwarder\-response\-messages\fP\&.
.sp
این دستور با این گزینه‌ها کار نمی‌کند:
\fI\%dnstap\-enable\fP،
\fI\%dnstap\-bidirectional\fP،
\fI\%dnstap\-socket\-path\fP،
\fI\%dnstap\-ip\fP،
\fI\%dnstap\-tls\fP،
\fI\%dnstap\-tls\-server\-name\fP،
\fI\%dnstap\-tls\-cert\-bundle\fP،
\fI\%dnstap\-tls\-client\-key\-file\fP و
\fI\%dnstap\-tls\-client\-cert\-file\fP\&.
.sp
گزینه‌های
\fI\%dnstap\-send\-identity\fP،
\fI\%dnstap\-send\-version\fP،
\fI\%dnstap\-identity\fP و
\fI\%dnstap\-version\fP زمانی که از \fB+p\fP استفاده نشود قابل بارگذاری هستند.
.sp
گزینه \fB+v\fP خروجی را با جزئیات بیشتر همراه می‌کند که شامل زمان صرف‌شده برای بارگذاری مجدد است.
با \fB+vv\fP خروجی جزئیات بیشتری خواهد داشت که شامل میزان حافظه‌ای است که به طور موقت برای انجام بارگذاری مجدد تخصیص یافته بود؛ این میزان حافظه در صورت داشتن فایل پیکربندی با محتوای بزرگ می‌تواند زیاد باشد.
در خروجی زمان‌بندی، عبارت 'reload' مدت زمانی است که سرور در طول آن متوقف شده بود.
.sp
گزینه \fB+p\fP باعث می‌شود بارگذاری مجدد رشته‌ها را متوقف نکند و آن‌ها به اجرا ادامه دهند.
قفل‌ها گرفته می‌شوند، اما موارد به ترتیب به‌روزرسانی می‌گردند؛ بنابراین ممکن است رشته‌ها وضعیت ناهمگونی را مشاهده کنند که در آن برخی گزینه‌ها مربوط به پیکربندی قدیمی و برخی مربوط به پیکربندی جدید باشند، مانند پارامترهای TTL حافظه نهان از پیکربندی قدیمی و فورواردرها از پیکربندی جدید.
استاب‌ها و فورواردرها همزمان به‌روزرسانی می‌شوند تا به صورت همگن دیده شوند، یعنی مقادیر قدیمی یا جدید با یکدیگر مشاهده شوند.
این گزینه باعث می‌شود زمان بارگذاری مجدد به جای ۰.۳ میلی‌ثانیه، حدود ۳ میکروثانیه طول بکشد که طی آن رشته‌های پردازشگر متوقف می‌شوند.
بنابراین، وقفه بسیار کوتاه‌تر خواهد بود، به قیمت مقداری ناهمگونی گذرا.
پس از بارگذاری مجدد، با تک‌تک رشته‌های پردازشگر مختصراً ارتباط برقرار می‌شود تا منابع را آزاد کنند؛ این موضوع زمان حذف را کمی طولانی‌تر می‌کند و مقداری از زمان رشته کنترل از راه دور را می‌گیرد.
.sp
با گزینه nopause (\fB+p\fP)، بارگذاری مجدد برای برخی گزینه‌ها که fast_reload بدون گزینه nopause روی آن‌ها کار می‌کند، کار نخواهد کرد:
\fI\%val\-bogus\-ttl\fP،
\fI\%val\-override\-date\fP،
\fI\%val\-sig\-skew\-min\fP،
\fI\%val\-sig\-skew\-max\fP،
\fI\%val\-max\-restart\fP،
\fI\%val\-nsec3\-keysize\-iterations\fP،
\fI\%target\-fetch\-policy\fP،
\fI\%outbound\-msg\-retry\fP،
\fI\%max\-sent\-count\fP،
\fI\%max\-query\-restarts\fP،
\fI\%do\-not\-query\-address\fP،
\fI\%do\-not\-query\-localhost\fP،
\fI\%private\-address\fP،
\fI\%private\-domain\fP،
\fI\%caps\-exempt\fP،
\fI\%nat64\-prefix\fP،
\fI\%do\-nat64\fP،
\fI\%infra\-host\-ttl\fP،
\fI\%infra\-keep\-probing\fP،
\fI\%ratelimit\fP،
\fI\%ip\-ratelimit\fP،
\fI\%ip\-ratelimit\-cookie\fP،
\fI\%wait\-limit\-netblock\fP،
\fI\%wait\-limit\-cookie\-netblock\fP،
\fI\%ratelimit\-below\-domain\fP و
\fI\%ratelimit\-for\-domain\fP\&.
.sp
گزینه \fB+d\fP باعث می‌شود بارگذاری مجدد، پرس‌وجوهایی را که رشته‌های پردازشگر در حال پردازش آن‌ها هستند رها کند (دور بریزد).
این شبیه به
\fI\%flush_requestlist\fP است.
بدون آن، پرس‌وجوها نگه داشته می‌شوند تا کاربران برای پرس‌وجوهایی که در حال حاضر در دست اقدام هستند پاسخ دریافت کنند.
رها کردن پرس‌وجوها باعث می‌شود که آن‌ها در طول چرخه پردازش خود، تنها گزینه‌های پیکربندی قدیمی یا فقط جدید را مشاهده کنند.
.sp
هنگامی که تغییراتی در برچسب‌های پیکربندی از طریق گزینه
\fI\%define\-tag\fP وجود داشته باشد، گزینه \fB+d\fP به طور ضمنی همراه با یک پیام هشدار فعال شده و پرس‌وجوها دور ریخته می‌شوند.
این کار برای جلوگیری از ارجاع پرس‌وجوهای قدیمی به اطلاعات برچسب‌های قدیمی است.
اگر تعداد برچسب‌ها در پیکربندی بارگذاری‌شده جدید با اضافه کردن برچسب‌ها در انتها افزایش یابد، گزینه ضمنی \fB+d\fP لازم نخواهد بود.
.sp
برای IP پاسخ، یعنی اقدامات مرتبط با آدرس‌های IP و احتمالاً اشتراک آن با برچسب‌های کنترل دسترسی و اطلاعات اقدام، این تنظیمات همراه با یک پرس‌وجو در هنگام دریافت، بر اساس آدرس IP مبدأ آن ذخیره می‌شوند.
اطلاعات قدیمی تا زمان اتمام پرس‌وجوها همراه با آن باقی می‌ماند.
این اطلاعات پس از حل‌وفصل و اتمام پرس‌وجوها از بین می‌روند، یا می‌توان فهرست درخواست‌ها را با \fB+d\fP پاکسازی کرد.
.UNINDENT
.INDENT 0.0
.TP
.B verbosity \fInumber\fP
تغییر مقدار پرگویی (verbosity) برای ثبت گزارش‌ها.
مشابه مقادیر کلیدواژه \fBverbosity:\fP در
\fI\%unbound.conf(5)\fP است.
این تنظیم جدید تا زمان بارگذاری مجدد سرور (که تنظیمات مجدداً از فایل پیکربندی خوانده می‌شوند) یا دستور بعدی تنظیم پرگویی باقی می‌ماند.
.UNINDENT
.INDENT 0.0
.TP
.B log_reopen
بازگشایی مجدد فایل گزارش (بستن و دوباره باز کردن آن).
برای چرخش گزارش‌ها (logrotate) جهت آزادسازی فایلی که دیمن در آن می‌نویسد کاربرد دارد.
در صورت استفاده از syslog، تلاش می‌کند syslog را ببندد و دوباره باز کند (که در صورت استفاده از chroot ممکن است کار نکند).
.UNINDENT
.INDENT 0.0
.TP
.B stats
چاپ آمارها.
شمارنده‌های داخلی را صفر می‌کند؛ این رفتار را می‌توان با گزاره پیکربندی
\fBstatistics\-cumulative:\fP کنترل کرد.
آمارها به صورت یک \fB[name]: [value]\fP در هر سطر چاپ می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B stats_noreset
مشاهده اجمالی آمارها.
آن‌ها را همانند دستور stats چاپ می‌کند، اما شمارنده‌های داخلی را صفر نمی‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B status
نمایش وضعیت سرور.
در صورت عدم اجرا کد خروج ۳ (ارتباط با پورت رد شده است)، در صورت بروز خطا ۱، و در صورت فعال بودن سرور کد ۰ برگردانده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B local_zone \fIname type\fP
افزودن ناحیه محلی جدید با نام و نوع مشخص‌شده.
مشابه گزاره پیکربندی local\-zone عمل می‌کند.
اگر ناحیه از قبل وجود داشته باشد، نوع آن به آرگومان داده‌شده تغییر می‌یابد.
.UNINDENT
.INDENT 0.0
.TP
.B local_zone_remove \fIname\fP
حذف ناحیه محلی با نام مشخص‌شده.
تمامی داده‌های محلی درون آن را حذف می‌کند.
اگر ناحیه وجود نداشته باشد، دستور با موفقیت خاتمه می‌یابد.
.UNINDENT
.INDENT 0.0
.TP
.B local_data \fIRR data...\fP
افزودن داده محلی جدید (رکورد منبع مشخص‌شده).
مشابه کلیدواژه \fBlocal\-data:\fP است، به جز زمانی که هیچ ناحیه پوشش‌دهنده‌ای وجود نداشته باشد؛
در این حالت، این دستور کنترل از راه دور یک ناحیه شفاف (transparent) با همان نام رکورد ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B local_data_remove \fIname\fP
حذف تمامی رکوردهای منبع (RR) از نام محلی.
اگر نام از قبل هیچ موردی نداشته باشد، هیچ اتفاقی رخ نمی‌دهد.
اغلب منجر به پاسخ NXDOMAIN برای نام (در یک ناحیه ایستا) می‌شود، اما اگر نام تبدیل به یک گره غیرپایانی تهی (empty nonterminal) شود (هنوز داده‌هایی در دامنه‌های زیر نام حذف‌شده وجود داشته باشد)، پاسخ‌های NOERROR nodata برای آن نام بازگردانده می‌شوند.
اگر به جای یک نام دامنه، یک رکورد منبع خاص داده شود، فقط همان رکورد خاص از داده‌های محلی حذف می‌شود و نه تمامی رکوردهای مربوط به آن نام.
.UNINDENT
.INDENT 0.0
.TP
.B local_zones
افزودن ناحیه‌های محلی با خواندن از ورودی استاندارد (stdin) در unbound\-control.
ورودی به صورت سطر به سطر خوانده می‌شود که در هر سطر نام، فاصله و نوع ناحیه قرار دارد.
جهت افزودن‌های دسته‌جمعی به کار می‌رود.
.UNINDENT
.INDENT 0.0
.TP
.B local_zones_remove
حذف ناحیه‌های محلی با خواندن از ورودی استاندارد در unbound\-control.
ورودی شامل یک نام در هر سطر است.
جهت حذف‌های دسته‌جمعی به کار می‌رود.
.UNINDENT
.INDENT 0.0
.TP
.B local_datas
افزودن رکوردهای داده محلی با خواندن از ورودی استاندارد در unbound\-control.
ورودی شامل یک رکورد منبع (RR) در هر سطر است.
جهت افزودن‌های دسته‌جمعی به کار می‌رود.
.UNINDENT
.INDENT 0.0
.TP
.B local_datas_remove
حذف رکوردهای داده محلی با خواندن از ورودی استاندارد در unbound\-control.
ورودی شامل یک نام در هر سطر است.
جهت حذف‌های دسته‌جمعی به کار می‌رود.
.UNINDENT
.INDENT 0.0
.TP
.B dump_cache
محتویات حافظه نهان به صورت متنی در خروجی استاندارد چاپ می‌شود.
می‌توانید آن را به یک فایل هدایت کنید تا حافظه نهان در یک فایل ذخیره شود.
در Unboundهای راه دور تحت عملیات چندپردازشی پشتیبانی نمی‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B load_cache
محتویات حافظه نهان را از ورودی استاندارد بارگذاری می‌کند.
از همان قالبی استفاده می‌کند که دستور dump_cache تولید می‌کند.
بارگذاری حافظه نهان با داده‌های قدیمی یا نادرست می‌تواند منجر به بازگرداندن داده‌های نامعتبر به کلاینت‌ها شود.
بارگذاری داده‌ها در حافظه نهان به این روش برای کمک به اشکال‌زدایی پشتیبانی می‌شود.
در Unboundهای راه دور تحت عملیات چندپردازشی پشتیبانی نمی‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B cache_lookup [\fB+t\fP] \fInames\fP
چاپ RRsetها و پیام‌های موجود در حافظه نهان در خروجی استاندارد.
برای هر نام ذکرشده، محتوای موجود در آن نام یا زیر آن چاپ می‌شود.
می‌توان چندین نام را که با فاصله از هم جدا شده‌اند مشخص کرد تا هر کدام چاپ شوند.
هنگامی که subnetcache فعال باشد، مدخل‌های منطبق از حافظه نهان زیرشبکه نیز چاپ می‌شوند.
.sp
گزینه \fB+t\fP اجازه استفاده از نام‌های ریشه و TLD را می‌دهد.
با استفاده از آن نام‌هایی مانند 'com' و '.' قابل استفاده هستند، اما جستجوی آن‌ها در حافظه نهان نیازمند پردازش سنگینی است.
.UNINDENT
.INDENT 0.0
.TP
.B lookup \fIname\fP
چاپ نام‌سرورهایی در خروجی استاندارد که برای جستجوی نام مشخص‌شده مورد استفاده قرار خواهند گرفت.
.UNINDENT
.INDENT 0.0
.TP
.B flush [\fB+c\fP] \fIname\fP
حذف نام از حافظه نهان.
انواع رکوردهای A، AAAA، NS، SOA، CNAME، DNAME، MX، PTR، SRV، NAPTR،
SVCB و HTTPS را پاک می‌کند؛ زیرا انجام این کار سریع است.
سایر انواع رکوردها را می‌توان با استفاده از \fBflush_type\fP یا \fBflush_zone\fP حذف کرد.
.sp
گزینه \fB+c\fP موارد را در صورت استفاده از cachedb، از حافظه نهان cachedb نیز حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B flush_type [\fB+c\fP] \fIname type\fP
حذف اطلاعات نام و نوع مشخص‌شده از حافظه نهان.
.sp
گزینه \fB+c\fP موارد را در صورت استفاده از cachedb، از حافظه نهان cachedb نیز حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B flush_zone [\fB+c\fP] name
حذف تمامی اطلاعات در نام مشخص‌شده یا زیر آن از حافظه نهان.
مجموعه‌های RRset و کلیدها حذف می‌شوند تا جستجوهای جدید انجام گیرند.
این دستور نیازمند پیمایش و بررسی کل حافظه نهان است و عملیاتی زمان‌بر به شمار می‌رود.
مدخل‌ها در پیاده‌سازی این دستور به عنوان منقضی‌شده علامت‌گذاری می‌شوند (بنابراین در صورت فعال بودن serve\-expired، آن اطلاعات ارائه شده اما واکشی مجدد برای اطلاعات جدید زمان‌بندی می‌شود).
.sp
گزینه \fB+c\fP موارد را در صورت استفاده از cachedb، از حافظه نهان cachedb نیز حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B flush_bogus [\fB+c\fP]
حذف تمامی داده‌های نامعتبر و جعلی (bogus) از حافظه نهان.
.sp
گزینه \fB+c\fP موارد را در صورت استفاده از cachedb، از حافظه نهان cachedb نیز حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B flush_negative [\fB+c\fP]
حذف تمامی داده‌های منفی از حافظه نهان.
این داده‌ها شامل پاسخ‌های nxdomain، nodata و servfail هستند.
همچنین کلیدهای خراب (که ممکن است ناشی از جستجوهای ناموفق باشند) از حافظه نهان کلید DNSSEC و شکست‌های جستجوی آخرین راه‌حل تکرارکننده (iterator) از حافظه نهان rrset حذف می‌شوند.
.sp
گزینه \fB+c\fP موارد را در صورت استفاده از cachedb، از حافظه نهان cachedb نیز حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B flush_stats
صفر کردن آمارها.
.UNINDENT
.INDENT 0.0
.TP
.B flush_requestlist
رها کردن پرس‌وجوهایی که در دست بررسی هستند.
رسیدگی به پرس‌وجوهایی که سرور در حال حاضر روی آن‌ها کار می‌کند متوقف می‌شود.
حافظه نهان دست‌نخورده باقی می‌ماند.
هیچ پاسخی برای آن پرس‌وجوها ارسال نمی‌شود که احتمالاً باعث می‌شود آن کاربران بعداً دوباره درخواست ارسال کنند.
برای راه‌اندازی مجدد پردازش پرس‌وجوها با تنظیمات جدید (مانند سطح پرگویی بالاتر) مفید است.
.UNINDENT
.INDENT 0.0
.TP
.B dump_requestlist
نمایش مواردی که در حال پردازش هستند.
تمامی پرس‌وجوهایی را که سرور در حال حاضر روی آن‌ها کار می‌کند چاپ می‌کند.
مدت زمانی را که کاربران منتظر مانده‌اند چاپ می‌کند.
برای درخواست‌های داخلی، زمانی چاپ نمی‌شود.
سپس وضعیت ماژول را چاپ می‌کند.
این دستور پرس‌وجوهای اولین رشته پردازشی را چاپ می‌کند و پرس‌وجوهایی که توسط سایر رشته‌ها سرویس‌دهی می‌شوند چاپ نمی‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B flush_infra \fIall|IP\fP
اگر all باشد، کل حافظه نهان زیرساخت (infra) خالی می‌شود.
اگر یک آدرس IP مشخص باشد، مدخل مربوط به آن آدرس از حافظه نهان حذف می‌شود.
این بخش شامل داده‌های EDNS، پینگ و وضعیت لنگی (lameness) است.
.UNINDENT
.INDENT 0.0
.TP
.B dump_infra
نمایش محتویات حافظه نهان زیرساخت.
.UNINDENT
.INDENT 0.0
.TP
.B set_option \fIopt: val\fP
تنظیم گزینه روی مقدار مشخص‌شده بدون نیاز به بارگذاری مجدد.
بنابراین حافظه نهان پاک نمی‌شود.
نام گزینه باید به یک \fB\(aq:\(aq\fP ختم شود و بین گزینه و مقدار باید فاصله خالی وجود داشته باشد.
برخی مقادیر در صورت تنظیم به این روش ممکن است اثری نداشته باشند، مقادیر جدید در فایل پیکربندی نوشته نمی‌شوند و همه گزینه‌ها پشتیبانی نمی‌شوند.
این رفتار با فراخوانی set_option در libunbound متفاوت است؛ در آنجا همه مقادیر کار می‌کنند زیرا Unbound هنوز مقداردهی اولیه نشده است.
.sp
مقادیری که کار می‌کنند عبارتند از: statistics\-interval، statistics\-cumulative،
do\-not\-query\-localhost، harden\-short\-bufsize، harden\-large\-queries،
harden\-glue، harden\-dnssec\-stripped، harden\-below\-nxdomain،
harden\-referral\-path، prefetch، prefetch\-key، log\-queries، hide\-identity،
hide\-version، identity، version، val\-log\-level، val\-log\-squelch،
ignore\-cd\-flag، add\-holddown، del\-holddown، keep\-missing، tcp\-upstream،
ssl\-upstream، max\-udp\-size، ratelimit، ip\-ratelimit، cache\-max\-ttl،
cache\-min\-ttl، cache\-max\-negative\-ttl\&.
.UNINDENT
.INDENT 0.0
.TP
.B get_option \fIopt\fP
دریافت مقدار گزینه.
نام گزینه را بدون کاراکتر پایانی \fB\(aq:\(aq\fP وارد کنید.
مقدار چاپ می‌شود.
اگر مقدار \fB\(dq\(dq\fP باشد، چیزی چاپ نشده و اتصال بسته می‌شود.
در صورت بروز خطا، \fB\(aqerror ...\(aq\fP چاپ می‌شود (روی گزینه‌های ناشناخته خطای ساختاری می‌دهد).
برای برخی گزینه‌ها، فهرستی از مقادیر که هر کدام در یک سطر هستند چاپ می‌شود.
گزینه‌ها همان‌طور که در فایل پیکربندی هستند یا با set_option اصلاح شده‌اند نمایش داده می‌شوند.
برای برخی گزینه‌ها ممکن است بازنویسی خاصی اعمال شده باشد که با این دستور نشان داده نشود، مانند نتایج حاصل از دستورات کنترل پرگویی و هدایت پرس‌وجو.
همه گزینه‌ها کار نمی‌کنند؛ برای آن‌ها به دستورات list_stubs، list_forwards، list_local_zones و list_local_data مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B list_stubs
فهرست کردن ناحیه‌های استاب (stub zones) در حال استفاده.
این موارد یک به یک در خروجی چاپ می‌شوند.
شامل نکات ریشه (root hints) در حال استفاده نیز می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B list_forwards
فهرست کردن ناحیه‌های هدایت (forward zones) در حال استفاده.
این موارد ناحیه به ناحیه در خروجی چاپ می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B list_insecure
فهرست کردن ناحیه‌ها با تنظیم domain\-insecure.
.UNINDENT
.INDENT 0.0
.TP
.B list_local_zones
فهرست کردن ناحیه‌های محلی در حال استفاده.
این موارد در هر سطر همراه با نوع ناحیه چاپ می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B list_local_data
فهرست کردن رکوردهای منبع (RR) داده محلی در حال استفاده.
رکوردهای منبع چاپ می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B insecure_add \fIzone\fP
افزودن domain\-insecure برای ناحیه داده‌شده، مشابه دستور موجود در unbound.conf.
به Unbound در حال اجرا اضافه می‌شود بدون اینکه بر محتوای حافظه نهان تأثیر بگذارد (که ممکن است هنوز نامعتبر باشد؛ برای حذف آن از flush_zone استفاده کنید)، و فایل پیکربندی را تغییر نمی‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B insecure_remove \fIzone\fP
حذف domain\-insecure برای ناحیه داده‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B forward_add [\fB+it\fP] \fIzone addr ...\fP
افزودن ناحیه هدایت جدید به Unbound در حال اجرا.
با گزینه \fB+i\fP یک domain\-insecure نیز برای ناحیه اضافه می‌شود (تا در صورت پیکربندی لنگر اعتماد ریشه DNSSEC برای سایر نام‌ها، بتواند به صورت ناامن حل‌وفصل شود).
پارامتر addr می‌تواند آدرس IP4، IP6 یا نام‌های سرور نام باشد، مشابه پیکربندی forward\-zone در unbound.conf.
گزینه \fB+t\fP آن را طوری تنظیم می‌کند که از TLS در بالادست استفاده کند، مشابه
\fI\%forward\-tls\-upstream: yes\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B forward_remove [\fB+i\fP] \fIzone\fP
حذف یک ناحیه هدایت از Unbound در حال اجرا.
گزینه \fB+i\fP همچنین domain\-insecure را برای آن ناحیه حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B stub_add [\fB+ipt\fP] \fIzone addr ...\fP
افزودن یک ناحیه استاب جدید به Unbound در حال اجرا.
با گزینه \fB+i\fP یک domain\-insecure نیز برای ناحیه اضافه می‌شود.
با \fB+p\fP ناحیه استاب در حالت prime تنظیم می‌شود، و بدون آن در حالت notprime تنظیم می‌گردد.
پارامتر addr می‌تواند آدرس IP4، IP6 یا نام‌های سرور نام باشد، مشابه پیکربندی \fBstub\-zone:\fP در unbound.conf.
گزینه \fB+t\fP آن را طوری تنظیم می‌کند که از TLS در بالادست استفاده کند، مشابه
\fI\%stub\-tls\-upstream: yes\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B stub_remove [\fB+i\fP] \fIzone\fP
حذف یک ناحیه استاب از Unbound در حال اجرا.
گزینه \fB+i\fP همچنین domain\-insecure را برای ناحیه حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B forward [\fIoff\fP | \fIaddr ...\fP ]
راه‌اندازی و تنظیم حالت هدایت (forwarding).
پیکربندی می‌کند که آیا سرور باید از سایر سرورهای نام بالادست پرس‌وجو کند، خودش به سرورهای نام ریشه اینترنت مراجعه کند، یا پیکربندی فعلی را نشان دهد.
می‌توانید سرورهای نام را پس از به‌روزرسانی DHCP ارسال کنید.
.sp
بدون آرگومان، فهرست فعلی آدرس‌هایی که برای هدایت تمامی پرس‌وجوها استفاده می‌شوند چاپ می‌شود.
در زمان راه‌اندازی، این اطلاعات از پیکربندی forward\-zone مربوط به \fB\(dq.\(dq\fP گرفته می‌شود.
پس از آن، وضعیت را نمایش می‌دهد.
در صورتی که هیچ هدایتی استفاده نشود، عبارت off چاپ می‌شود.
.sp
اگر مقدار off ارسال شود، هدایت غیرفعال شده و از سرورهای نام ریشه استفاده می‌شود.
این کار را می‌توان برای جلوگیری از سرورهای نام دارای اشکال یا عدم پشتیبانی از DNSSEC که از طریق DHCP دریافت شده‌اند، به کار برد.
اما ممکن است در هتل‌ها یا هات‌اسپات‌ها کار نکند.
.sp
اگر یک یا چند آدرس IPv4 یا IPv6 داده شود، از آن‌ها برای هدایت پرس‌وجوها استفاده می‌شود.
آدرس‌ها باید با فاصله از هم جدا شوند.
با \fB\(aq@port\(aq\fP می‌توان شماره پورت را صریحاً تنظیم کرد (پورت پیش‌فرض ۵۳ (DNS) است).
.sp
به طور پیش‌فرض، اطلاعات فورواردر از فایل پیکربندی برای ریشه \fB\(dq.\(dq\fP استفاده می‌شود.
فایل پیکربندی تغییر نمی‌کند، بنابراین پس از بارگذاری مجدد، این تغییرات از بین می‌روند.
سایر ناحیه‌های هدایت در فایل پیکربندی تحت تأثیر این دستور قرار نمی‌گیرند.
.UNINDENT
.INDENT 0.0
.TP
.B ratelimit_list [\fB+a\fP]
فهرست کردن دامنه‌هایی که مشمول محدودیت نرخ درخواست (ratelimit) شده‌اند.
در هر سطر همراه با تخمین فعلی پرس‌وجو در ثانیه (qps) و حد مجاز qps از پیکربندی چاپ می‌شود.
با گزینه \fB+a\fP تمامی دامنه‌ها را چاپ می‌کند، نه فقط دامنه‌های دارای محدودیت، همراه با مقدار تقریبی qps آن‌ها.
دامنه‌های دارای محدودیت برای پرس‌وجوهای جدید (که در حافظه نهان نیستند) خطا برمی‌گردانند، اما پرس‌وجوهای کش‌شده به طور معمول پاسخ داده می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B ip_ratelimit_list [\fB+a\fP]
فهرست کردن آدرس‌های IP که مشمول محدودیت نرخ درخواست شده‌اند.
در هر سطر همراه با تخمین فعلی qps و حد مجاز qps از پیکربندی چاپ می‌شود.
با گزینه \fB+a\fP تمامی آدرس‌های IP را همراه با مقدار تقریبی qps آن‌ها چاپ می‌کند.
آدرس‌های IP دارای محدودیت قبل از بررسی حافظه نهان دور ریخته می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B list_auth_zones
فهرست کردن ناحیه‌های معتبر (auth zones) پیکربندی‌شده.
در هر سطر همراه با وضعیت چاپ می‌شود که نشان می‌دهد آیا ناحیه منقضی شده است و شماره سریال فعلی چیست.
ناحیه‌های RPZ پیکربندی‌شده نیز در این فهرست گنجانده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B auth_zone_reload \fIzone\fP
بارگذاری مجدد ناحیه معتبر (یا ناحیه RPZ) از فایل ناحیه.
فایل ناحیه خوانده شده و محتوای فعلی ناحیه در حافظه بازنویسی می‌شود.
این کار محتوای خود ناحیه معتبر را تغییر می‌دهد و نه محتوای حافظه نهان را.
چنین محتوایی در حافظه نهان در صورتی وجود دارد که Unbound را برای اعتبارسنجی با \fBfor\-upstream: yes\fP تنظیم کرده باشید که با دستور \fBflush_zone\fP \fIzone\fP قابل پاکسازی است.
.UNINDENT
.INDENT 0.0
.TP
.B auth_zone_transfer \fIzone\fP
انتقال ناحیه معتبر (یا ناحیه RPZ) از سرور اصلی (master).
توالی بررسی ناحیه معتبر آغاز می‌شود که در آن سرورهای اصلی بررسی می‌شوند تا مشخص شود آیا ناحیه به‌روزرسانی‌شده‌ای دارند یا خیر (با بررسی سریال SOA).
سپس ناحیه برای دریافت نسخه جدیدتر منتقل می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B rpz_enable \fIzone\fP
فعال‌سازی مجدد ناحیه RPZ در صورتی که قبلاً غیرفعال شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B rpz_disable \fIzone\fP
غیرفعال‌سازی ناحیه RPZ.
.UNINDENT
.INDENT 0.0
.TP
.B view_list_local_zones \fIview\fP
اجرای دستور \fIlist_local_zones\fP برای نمای (view) مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B view_local_zone \fIview name type\fP
اجرای دستور \fIlocal_zone\fP برای نمای مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B view_local_zone_remove \fIview name\fP
اجرای دستور \fIlocal_zone_remove\fP برای نمای مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B view_list_local_data \fIview\fP
اجرای دستور \fIlist_local_data\fP برای نمای مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B view_local_data \fIview RR data...\fP
اجرای دستور \fIlocal_data\fP برای نمای مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B view_local_data_remove \fIview name\fP
اجرای دستور \fIlocal_data_remove\fP برای نمای مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B view_local_datas_remove \fIview\fP
حذف فهرستی از \fIlocal_data\fP برای نمای داده‌شده با خواندن از ورودی استاندارد.
مشابه \fIlocal_datas_remove\fP عمل می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B view_local_datas \fIview\fP
افزودن فهرستی از \fIlocal_data\fP برای نمای داده‌شده با خواندن از ورودی استاندارد.
مشابه \fIlocal_datas\fP عمل می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B add_cookie_secret \fIsecret\fP
افزودن یا جایگزینی دائمی رمز کوکی (cookie secret).
پارامتر \fIsecret\fP باید یک رشته هگزادسیمال ۱۲۸ بیتی باشد.
.sp
رمزهای کوکی می‌توانند در وضعیت \fBactive\fP یا \fBstaging\fP باشند.
رمزهای کوکی \fBActive\fP برای ایجاد کوکی‌های DNS استفاده می‌شوند، اما تأیید صحت یک کوکی DNS با هر یک از رمزهای کوکی \fBactive\fP یا \fBstaging\fP موفقیت‌آمیز خواهد بود.
وضعیت رمزهای کوکی فعلی را می‌توان با دستور
\fI\%print_cookie_secrets\fP
چاپ کرد.
.sp
هنگامی که هنوز هیچ رمز کوکی پیکربندی نشده باشد، پارامتر \fIsecret\fP به عنوان \fBactive\fP اضافه می‌شود.
اگر از قبل یک رمز کوکی \fBactive\fP وجود داشته باشد، پارامتر \fIsecret\fP به صورت \fBstaging\fP اضافه شده یا جایگزین رمز \fBstaging\fP موجود می‌شود.
.sp
برای چرخش (roll) رمز کوکی مورداستفاده در یک مجموعه anycast:
رمز جدید باید به عنوان رمز \fBstaging\fP به \fBتمام\fP گره‌های مجموعه anycast اضافه شود.
هنگامی که \fBتمام\fP گره‌ها بتوانند کوکی‌های DNS را با رمز جدید تأیید کنند، رمز جدید را می‌توان با دستور
\fI\%activate_cookie_secret\fP
فعال کرد.
پس از اینکه رمز جدید در \fBتمام\fP گره‌ها حداقل به مدت یک ساعت در وضعیت \fBactive\fP قرار داشت، می‌توان رمز قبلی را با دستور
\fI\%drop_cookie_secret\fP
حذف کرد.
.sp
ماندگاری تنظیمات با نوشتن در فایلی انجام می‌شود که با گزینه
\fI\%cookie\-secret\-file\fP
در بخش server فایل پیکربندی مشخص شده است.
این قابلیت به طور پیش‌فرض غیرفعال است ("").
.UNINDENT
.INDENT 0.0
.TP
.B drop_cookie_secret
حذف رمز کوکی در وضعیت \fBstaging\fP.
.UNINDENT
.INDENT 0.0
.TP
.B activate_cookie_secret
تبدیل رمز کوکی فعلی \fBstaging\fP به \fBactive\fP، و تبدیل رمز کوکی فعلی \fBactive\fP به \fBstaging\fP.
.UNINDENT
.INDENT 0.0
.TP
.B print_cookie_secrets
نمایش رمزهای کوکی پیکربندی‌شده فعلی همراه با وضعیت آن‌ها.
.UNINDENT
.SH "کد خروج (EXIT CODE)"
.sp
برنامه \fBunbound\-control\fP در صورت بروز خطا با کد وضعیت ۱، و در صورت موفقیت با کد ۰ خارج می‌شود.
.SH "راه‌اندازی (SET UP)"
.sp
راه‌اندازی نیازمند یک گواهی خودامضا (self\-signed) و کلیدهای خصوصی برای هر دو بخش سرور و کلاینت است.
اسکریپت \fBunbound\-control\-setup\fP این موارد را در پوشه اجرای پیش‌فرض، یا با گزینه \fB\-d\fP در پوشه دیگری تولید می‌کند.
اگر مجوزهای کنترل دسترسی فایل‌های کلید را تغییر دهید، می‌توانید تعیین کنید چه کسانی می‌توانند از \fBunbound\-control\fP استفاده کنند؛ به طور پیش‌فرض مالک و گروه دسترسی دارند اما نه همه کاربران.
اسکریپت را تحت همان نام کاربری که در
\fBunbound.conf\fP پیکربندی کرده‌اید یا به عنوان ریشه (root) اجرا کنید تا دیمن اجازه خواندن فایل‌ها را داشته باشد، به عنوان مثال با:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
sudo \-u unbound unbound\-control\-setup
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
اگر نام کاربری را در \fBunbound.conf\fP پیکربندی نکرده‌اید، کلیدها نیازمند مجوز خواندن برای اطلاعات هویتی کاربری هستند که دیمن تحت آن اجرا می‌شود.
این اسکریپت کلیدهای خصوصی موجود در پوشه را حفظ می‌کند.
پس از اجرای اسکریپت به عنوان root، گزینه
\fI\%control\-enable\fP را در
\fBunbound.conf\fP فعال کنید.
.SH "شمارنده‌های آماری (STATISTIC COUNTERS)"
.sp
دستورات \fI\%stats\fP و
\fI\%stats_noreset\fP تعدادی شمارنده آماری را نمایش می‌دهند:
.INDENT 0.0
.TP
.B threadX.num.queries
تعداد پرس‌وجوهای دریافت‌شده توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_ip_ratelimited
تعداد پرس‌وجوهای دارای محدودیت نرخ بر اساس IP توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_cookie_valid
تعداد پرس‌وجوهای دارای کوکی معتبر DNS توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_cookie_client
تعداد پرس‌وجوهای دارای بخش کلاینت کوکی DNS توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_cookie_invalid
تعداد پرس‌وجوهای دارای کوکی نامعتبر DNS توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_discard_timeout
تعداد پرس‌وجوهای حذف‌شده به دلیل سررسید مهلت دور انداختن (discard\-timeout) توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_replyaddr_limit
تعداد پرس‌وجوهای حذف‌شده به دلیل محدودیت‌های replyaddr توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_wait_limit
تعداد پرس‌وجوهای حذف‌شده به دلیل wait\-limit توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.cachehits
تعداد پرس‌وجوهایی که با موفقیت از طریق جستجو در حافظه نهان پاسخ داده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.cachemiss
تعداد پرس‌وجوهایی که نیازمند پردازش بازگشتی (recursive) بوده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.dnscrypt.crypted
تعداد پرس‌وجوهایی که رمزنگاری شده و توسط dnscrypt با موفقیت کپسول‌زدایی شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.dnscrypt.cert
تعداد پرس‌وجوهایی که درخواست گواهی‌های dnscrypt را داشته‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.dnscrypt.cleartext
تعداد پرس‌وجوهای دریافت‌شده روی پورت dnscrypt که به صورت متن آشکار بوده و درخواست گواهی نبوده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.dnscrypt.malformed
تعداد درخواست‌هایی که نه متن آشکار بودند و نه پیام‌های معتبر dnscrypt.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.dns_error_reports
تعداد گزارش‌های خطای DNS تولیدشده توسط رشته.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.prefetch
تعداد پیش‌واکشی‌های انجام‌شده در حافظه نهان.
این عدد در cachehits گنجانده شده است، زیرا پرس‌وجوی اصلی پاسخ پیش‌واکشی‌نشده را از حافظه نهان دریافت کرده و منجر به پردازش بازگشتی شده و یک جایگاه را در فهرست درخواست‌ها اشغال نموده است.
بخشی از recursivereplies (یا هیستوگرام آن) یا cachemiss نیست، زیرا پاسخ حافظه نهان ارسال شده است.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.expired
تعداد پاسخ‌هایی که با یک مدخل منقضی‌شده حافظه نهان ارائه شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.queries_timed_out
تعداد پرس‌وجوهایی که به دلیل انتظار بیش از حد در بافر سوکت UDP دور ریخته شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.query.queue_time_us.max
حداکثر زمان انتظار بسته‌ها در بافر سوکت، بر حسب میکروثانیه.
تنها زمانی گزارش می‌شود که گزینه
\fI\%sock\-queue\-timeout\fP فعال باشد.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.num.recursivereplies
تعداد پاسخ‌های ارسال‌شده به پرس‌وجوهایی که نیازمند پردازش بازگشتی بوده‌اند.
در صورتی که به دلیل اتمام مهلت زمانی (timeout) برای برخی پرس‌وجوها پاسخی ارسال نشده باشد، می‌تواند از threadX.num.cachemiss کمتر باشد.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.avg
میانگین تعداد درخواست‌ها در فهرست درخواست‌های پردازش بازگشتی داخلی هنگام درج یک پرس‌وجوی جدید ورودی.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.max
حداکثر اندازه به‌دست‌آمده توسط فهرست درخواست‌های پردازش بازگشتی داخلی.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.overwritten
تعداد درخواست‌های موجود در فهرست درخواست‌ها که توسط مدخل‌های جدیدتر رونویسی شده‌اند.
این اتفاق زمانی رخ می‌دهد که سیل عظیمی از پرس‌وجوها نیازمند پردازش بازگشتی باشند و سرور به سختی پاسخگو باشد.
هنگامی که در طول این هجوم، گزینه
\fI\%jostle\-timeout\fP
اجازه حذف یک پرس‌وجو را به نفع یک پرس‌وجوی جدید ورودی می‌دهد، این شمارنده افزایش می‌یابد.
پرس‌وجوی قدیمی‌تر برای ایجاد فضا دور ریخته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.exceeded
پرس‌وجوهایی که به دلیل پر بودن فهرست درخواست‌ها دور ریخته شده‌اند.
این اتفاق زمانی رخ می‌دهد که هجوم زیادی از پرس‌وجوها نیازمند پردازش بازگشتی باشند و سرور نتواند همگام شود.
هنگامی که در طول هجوم فضایی با کنار زدن یک پرس‌وجوی قدیمی‌تر ایجاد نشود و پرس‌وجوی جدید دور ریخته شود، این شمارنده افزایش می‌یابد.
از آنجا که پرس‌وجوی قدیمی‌تری حذف نمی‌شود (تنظیم \fI\%jostle\-timeout\fP را ببینید)، فضایی برای پرس‌وجوی جدید وجود ندارد.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.current.all
اندازه فعلی فهرست درخواست‌ها، شامل پرس‌وجوهای تولیدشده داخلی (مانند پرس‌وجوهای priming و جستجوهای glue).
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.current.user
اندازه فعلی فهرست درخواست‌ها، فقط شامل درخواست‌های حاصل از پرس‌وجوهای کلاینت.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.requestlist.current.replies
شمارش فعلی تعداد مدخل‌های پاسخ که در انتظار مدخل‌های فهرست درخواست هستند. از آنجا که یک مدخل فهرست درخواست می‌تواند نتایج را به چندین آدرس پاسخ ارسال کند، این عدد ممکن است از اندازه فهرست درخواست‌ها بزرگتر باشد.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.recursion.time.avg
میانگین زمان صرف‌شده برای پاسخگویی به پرس‌وجوهایی که نیازمند پردازش بازگشتی بوده‌اند.
توجه داشته باشید که پرس‌وجوهایی که از حافظه نهان پاسخ داده شده‌اند در این میانگین محاسبه نمی‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.recursion.time.median
میانه زمان صرف‌شده برای پاسخ به پرس‌وجوهایی که نیازمند پردازش بازگشتی بوده‌اند.
میانه به این معنی است که به ۵۰ درصد از پرس‌وجوهای کاربران در زمانی کمتر از این مقدار پاسخ داده شده است.
به دلیل وجود مقادیر پرت بزرگ (معمولاً پرس‌وجوها به سرورهای بدون پاسخ)، میانگین می‌تواند بزرگتر از میانه باشد.
این میانه با درونیابی از یک هیستوگرام محاسبه شده است.
.UNINDENT
.INDENT 0.0
.TP
.B threadX.tcpusage
بافرهای TCP فعلی نگه‌داری‌شده برای اتصالات ورودی.
یک مقدار نقطه‌ای در زمان درخواست.
این به شما کمک می‌کند متوجه شوید آیا بافرهای incoming\-num\-tcp پر هستند یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_ip_ratelimited
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_cookie_valid
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_cookie_client
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_cookie_invalid
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_discard_timeout
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_replyaddr_limit
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_wait_limit
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.cachehits
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.cachemiss
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.dnscrypt.crypted
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.dnscrypt.cert
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.dnscrypt.cleartext
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.dnscrypt.malformed
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.dns_error_reports
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.prefetch
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.expired
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.queries_timed_out
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.query.queue_time_us.max
حداکثر مقادیر رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.num.recursivereplies
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.avg
میانگین در تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.max
حداکثر مقدار requestlist.max در رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.overwritten
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.exceeded
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.current.all
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.current.user
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.requestlist.current.replies
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.recursion.time.median
میانگین در تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B total.tcpusage
مجموع تمامی رشته‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B time.now
زمان فعلی بر حسب ثانیه از سال ۱۹۷۰ (مبدأ زمان یونیکس).
.UNINDENT
.INDENT 0.0
.TP
.B time.up
زمان فعالیت (uptime) از زمان بوت سرور بر حسب ثانیه.
.UNINDENT
.INDENT 0.0
.TP
.B time.elapsed
زمان سپری‌شده از آخرین چاپ آمارها، بر حسب ثانیه.
.UNINDENT
.SH "آمارهای پیشرفته (EXTENDED STATISTICS)"
.INDENT 0.0
.TP
.B mem.cache.rrset
میزان حافظه بر حسب بایت مورد استفاده توسط حافظه نهان RRset.
.UNINDENT
.INDENT 0.0
.TP
.B mem.cache.message
میزان حافظه بر حسب بایت مورد استفاده توسط حافظه نهان پیام (message).
.UNINDENT
.INDENT 0.0
.TP
.B mem.cache.dnscrypt_shared_secret
میزان حافظه بر حسب بایت مورد استفاده توسط حافظه نهان رمزهای مشترک dnscrypt.
.UNINDENT
.INDENT 0.0
.TP
.B mem.cache.dnscrypt_nonce
میزان حافظه بر حسب بایت مورد استفاده توسط حافظه نهان nonce در dnscrypt.
.UNINDENT
.INDENT 0.0
.TP
.B mem.mod.iterator
میزان حافظه بر حسب بایت مورد استفاده توسط ماژول تکرارکننده (iterator).
.UNINDENT
.INDENT 0.0
.TP
.B mem.mod.validator
میزان حافظه بر حسب بایت مورد استفاده توسط ماژول اعتبارسنج (validator).
شامل حافظه نهان کلید و حافظه نهان منفی نیز می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B mem.streamwait
میزان حافظه بر حسب بایت مورد استفاده توسط بافرهای انتظار جریان‌های TCP و TLS.
این بافرها شامل پاسخ‌هایی هستند که در صف ارسال مجدد به کلاینت‌ها قرار دارند.
.UNINDENT
.INDENT 0.0
.TP
.B mem.http.query_buffer
میزان حافظه بر حسب بایت مورد استفاده توسط بافرهای پرس‌وجوی HTTP/2.
شامل پرس‌وجوهای DNS (جزئی) در انتظار تکمیل جریان درخواست است.
.UNINDENT
.INDENT 0.0
.TP
.B mem.http.response_buffer
میزان حافظه بر حسب بایت مورد استفاده توسط بافرهای پاسخ HTTP/2.
شامل پاسخ‌های DNS در انتظار ارسال به کلاینت‌ها است.
.UNINDENT
.INDENT 0.0
.TP
.B mem.quic
میزان حافظه بر حسب بایت مورد استفاده توسط پروتکل QUIC.
شامل اطلاعات اتصال، اطلاعات جریان، پرس‌وجوهای خوانده‌شده و پاسخ‌های ارسال‌شده به کلاینت‌ها است.
.UNINDENT
.INDENT 0.0
.TP
.B histogram.<sec>.<usec>.to.<sec>.<usec>
نمایش یک هیستوگرام، تجمیع‌شده روی تمامی رشته‌ها.
هر عنصر نشان‌دهنده تعداد پرس‌وجوهای بازگشتی است که زمان پاسخ آن‌ها بین حد پایین و حد بالا قرار دارد.
زمان‌ها بزرگتر یا مساوی حد پایین و کوچکتر از حد بالا هستند.
۴۰ سطل (bucket) وجود دارد که اندازه سطل‌ها به صورت تصاعدی دو برابر می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.type.A
تعداد کل پرس‌وجوها با نوع A در تمامی رشته‌ها.
برای سایر انواع پرس‌وجو نیز چاپ می‌شود، اما فقط برای انواعی که پرس‌وجویی برای آن‌ها دریافت شده است؛ بنابراین مواردی که برابر ۰ هستند برای اختصار حذف می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.type.other
تعداد پرس‌وجوها با انواع ۲۵۶ تا ۶۵۵۳۵.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.class.IN
تعداد کل پرس‌وجوها با کلاس پرس‌وجوی IN (اینترنت) در تمامی رشته‌ها.
همچنین برای سایر کلاس‌ها (مانند CH یا CHAOS که گاهی برای اشکال‌زدایی استفاده می‌شود) یا NONE و ANY که در به‌روزرسانی پویا کاربرد دارند چاپ می‌شود.
مقدار num.query.class.other برای کلاس‌های ۲۵۶ تا ۶۵۵۳۵ چاپ می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.opcode.QUERY
تعداد کل پرس‌وجوها با کد عملیاتی (opcode) برابر QUERY در تمامی رشته‌ها.
همچنین برای سایر آپ‌کدها نظیر UPDATE و... چاپ می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.tcp
تعداد پرس‌وجوهایی که با استفاده از پروتکل TCP به سمت سرور Unbound ارسال شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.tcpout
تعداد پرس‌وجوهایی که سرور Unbound با استفاده از پروتکل TCP به سمت سرورهای دیگر ارسال کرده است.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.udpout
تعداد پرس‌وجوهایی که سرور Unbound با استفاده از پروتکل UDP به سمت سرورهای دیگر ارسال کرده است.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.tls
تعداد پرس‌وجوهایی که با استفاده از TLS به سمت سرور Unbound ارسال شده‌اند.
این موارد در num.query.tcp نیز شمرده می‌شوند، زیرا TLS بر بستر TCP اجرا می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.tls.resume
تعداد ازسرگیری‌های نشست TLS؛ این‌ها پرس‌وجوهایی بر بستر TLS به سمت سرور Unbound هستند که کلاینت کلید ازسرگیری نشست TLS را مذاکره کرده است.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.https
تعداد پرس‌وجوهایی که با استفاده از HTTPS به سمت سرور Unbound ارسال شده‌اند.
این موارد در num.query.tcp و num.query.tls نیز شمرده می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.quic
تعداد پرس‌وجوهایی که با استفاده از پروتکل QUIC به سمت سرور Unbound ارسال شده‌اند.
این موارد در num.query.tls نیز شمرده می‌شوند، زیرا در این پرس‌وجوها از TLS استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.ipv6
تعداد پرس‌وجوهایی که با استفاده از IPv6 به سمت سرور Unbound ارسال شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.flags.RD
تعداد پرس‌وجوهایی که پرچم RD در هدر آن‌ها تنظیم شده بود.
همچنین برای پرچم‌های QR، AA، TC، RA، Z، AD و CD چاپ می‌شود.
توجه داشته باشید که پرس‌وجوهای دارای پرچم QR، AA یا TC ممکن است به همین دلیل رد شده باشند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.edns.present
تعداد پرس‌وجوهایی که رکورد EDNS OPT در آن‌ها موجود بوده است.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.edns.DO
تعداد پرس‌وجوهایی که رکورد EDNS OPT با بیت DO (DNSSEC OK) تنظیم‌شده داشته‌اند.
این پرس‌وجوها در مقدار num.query.edns.present نیز محاسبه شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.ratelimited
تعداد پرس‌وجوهایی که به دلیل محدودیت نرخ، از ارسال آن‌ها به سرور نام جلوگیری شده است.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.dnscrypt.shared_secret.cachemiss
تعداد پرس‌وجوهای dnscrypt که رمز مشترکی در حافظه نهان برای آن‌ها یافت نشد.
از این مقدار می‌توان برای محاسبه نرخ موفقیت (hitrate) رمز مشترک استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.dnscrypt.replay
تعداد پرس‌وجوهای dnscrypt که مقدار nonce منطبقی در حافظه نهان nonce پیدا کرده و در نتیجه به عنوان بازپخش پرس‌وجو (replay) تلقی شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.answer.rcode.NXDOMAIN
تعداد پاسخ‌ها به پرس‌وجوها (از حافظه نهان یا از بازگشت) که دارای کد وضعیت NXDOMAIN بودند.
همچنین برای سایر کدهای بازگشتی نیز چاپ می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.answer.rcode.nodata
تعداد پاسخ‌ها به پرس‌وجوها که دارای شبه‌کد بازگشتی nodata بودند.
این بدان معناست که کد بازگشتی واقعی NOERROR بوده، اما علاوه بر آن، هیچ داده‌ای در پاسخ وجود نداشته است (وضعیتی که پاسخ NOERROR/NODATA نامیده می‌شود).
این پرس‌وجوها در آمار num.answer.rcode.NOERROR نیز گنجانده شده‌اند.
معمولاً در جستجوهای AAAA زمانی رخ می‌دهد که رکورد A وجود دارد اما رکورد AAAA موجود نیست.
.UNINDENT
.INDENT 0.0
.TP
.B num.answer.secure
تعداد پاسخ‌هایی که امن بودند.
پاسخ با موفقیت اعتبارسنجی شده است.
بیت AD ممکن است در برخی از این پاسخ‌ها تنظیم شده باشد، در مواردی که کلاینت اعلام کرده آماده پذیرش بیت AD در پاسخ است (با بیت DO یا AD در پرس‌وجو).
.UNINDENT
.INDENT 0.0
.TP
.B num.answer.bogus
تعداد پاسخ‌هایی که نامعتبر و جعلی (bogus) بودند.
این پاسخ‌ها به دلیل شکست در اعتبارسنجی، منجر به بازگرداندن SERVFAIL به کلاینت شدند.
.UNINDENT
.INDENT 0.0
.TP
.B num.rrset.bogus
تعداد RRsetهایی که توسط اعتبارسنج به عنوان جعلی و نامعتبر علامت‌گذاری شده‌اند.
به ازای هر بررسی RRset که ناموفق باشد افزایش می‌یابد.
.UNINDENT
.INDENT 0.0
.TP
.B num.valops
تعداد عملیات اعتبارسنجی انجام‌شده توسط اعتبارسنج.
به ازای هر عملیات بررسی RRSIG فارغ از نتیجه اعتبارسنجی افزایش می‌یابد.
ترکیب RRSIG و کلید ابتدا باید از بررسی‌های اولیه‌ای عبور کند (مانند بررسی طول یا پروتکل) پیش از آنکه Unbound اقدام به اعتبارسنجی کند.
.UNINDENT
.INDENT 0.0
.TP
.B unwanted.queries
تعداد پرس‌وجوهایی که به دلیل عدم تطابق با تنظیمات کنترل دسترسی رد یا دور ریخته شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B unwanted.replies
پاسخ‌های ناخواسته یا درخواست‌نشده.
می‌تواند ترافیک تصادفی، پاسخ‌های تکراری با تأخیر، پاسخ‌های بسیار دیرهنگام یا تلاش برای جعل (spoofing) باشد.
سطح اندکی از پاسخ‌های دیرهنگام و بسته‌های تکراری با پروتکل UDP قابل انتظار است.
مقادیر بسیار بالا می‌تواند نشان‌دهنده یک تهدید امنیتی (حمله جعل) باشد.
.UNINDENT
.INDENT 0.0
.TP
.B msg.cache.count
تعداد موارد (پاسخ‌های DNS) موجود در حافظه نهان پیام.
.UNINDENT
.INDENT 0.0
.TP
.B rrset.cache.count
تعداد RRsetها در حافظه نهان rrset.
شامل rrsetهای مورد استفاده توسط پیام‌ها در حافظه نهان پیام و همچنین اطلاعات تفویض اختیار است.
.UNINDENT
.INDENT 0.0
.TP
.B infra.cache.count
تعداد موارد موجود در حافظه نهان زیرساخت.
شامل آدرس‌های IP به همراه زمان‌بندی و اطلاعات پشتیبانی از پروتکل آن‌ها است.
.UNINDENT
.INDENT 0.0
.TP
.B key.cache.count
تعداد موارد در حافظه نهان کلید.
شامل کلیدهای DNSSEC، یک مورد به ازای هر نقطه تفویض، و وضعیت اعتبارسنجی آن‌ها است.
.UNINDENT
.INDENT 0.0
.TP
.B msg.cache.max_collisions
حداکثر تعداد تداخل‌ها در جدول درهم‌سازی (hash table) حافظه نهان پیام.
تعداد هش‌هایی که هنگام درج یک عنصر جدید در جدول درهم‌سازی یکسان هستند.
اگر این مقدار بسیار بزرگ باشد (مثلاً صدها مورد)، عملکرد جدول درهم‌سازی با مشکل مواجه است و مقادیر هش نادرست یا مخرب هستند.
.UNINDENT
.INDENT 0.0
.TP
.B rrset.cache.max_collisions
حداکثر تعداد تداخل‌ها در جدول درهم‌سازی حافظه نهان rrset.
اگر این مقدار بسیار بزرگ باشد (مثلاً صدها مورد)، عملکرد جدول درهم‌سازی مشکل دارد و مقادیر هش نادرست یا مخرب هستند.
.UNINDENT
.INDENT 0.0
.TP
.B dnscrypt_shared_secret.cache.count
تعداد موارد در حافظه نهان رمز مشترک.
شامل رمزهای مشترک از پیش محاسبه‌شده برای یک جفت کلید عمومی کلاینت / کلید خصوصی سرور مشخص است.
رمزهای مشترک مصرف بالای CPU دارند و این حافظه نهان به Unbound اجازه می‌دهد تا در صورت ارسال چندین پرس‌وجوی dnscrypt از یک کلاینت، از محاسبه مجدد رمز مشترک اجتناب کند.
.UNINDENT
.INDENT 0.0
.TP
.B dnscrypt_nonce.cache.count
تعداد موارد در حافظه نهان nonce کلاینت.
این حافظه نهان برای جلوگیری از بازپخش (replay) پرس‌وجوهای dnscrypt استفاده می‌شود.
مقدار nonce کلاینت باید برای هر جفت کلید عمومی کلاینت / کلید خصوصی سرور منحصربه‌فرد باشد.
این حافظه نهان باید بتواند کلیدهای بازه QPS * \fIreplay window\fP را نگهداری کند تا از بازپخش پرس‌وجو در طول ثانیه‌های \fIreplay window\fP جلوگیری شود.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.authzone.up
تعداد پرس‌وجوهای بالادست که از داده‌های auth\-zone پاسخ داده شده‌اند.
این پرس‌وجوها در غیر این صورت (با فعال بودن fallback) به اینترنت ارسال می‌شدند، اما اکنون از ناحیه معتبر پاسخ داده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.authzone.down
تعداد پرس‌وجوهای کلاینت‌های پایین‌دست که از داده‌های auth\-zone پاسخ داده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.aggressive.NOERROR
تعداد پرس‌وجوهایی که با استفاده از رکوردهای کش‌شده NSEC با کد وضعیت NODATA پاسخ داده شده‌اند.
این پرس‌وجوها در غیر این صورت به اینترنت ارسال می‌شدند، اما اکنون با داده‌های ذخیره‌شده در حافظه نهان پاسخ داده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.aggressive.NXDOMAIN
تعداد پرس‌وجوهایی که با استفاده از رکوردهای کش‌شده NSEC با کد وضعیت NXDOMAIN پاسخ داده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.subnet
تعداد پرس‌وجوهایی که پاسخی حاوی داده‌های زیرشبکه کلاینت EDNS دریافت کردند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.subnet_cache
تعداد پرس‌وجوهایی که از حافظه نهان زیرشبکه کلاینت edns پاسخ داده شده‌اند.
این موارد توسط شمارنده‌های اصلی به عنوان cachemiss شمرده می‌شوند، اما پس از پردازش توسط ماژول edns client subnet، در حافظه نهان اختصاصی زیرشبکه کلاینت یافت می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B num.query.cachedb
تعداد پرس‌وجوهایی که از حافظه نهان خارجی cachedb پاسخ داده شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B num.rpz.action.<rpz_action>
تعداد پرس‌وجوهایی که با استفاده از سیاست RPZ پیکربندی‌شده پاسخ داده شده‌اند، به تفکیک نوع اقدام RPZ.
اقدامات ممکن عبارتند از: nxdomain، nodata، passthru، drop، tcp\-only،
local\-data، disabled و cname\-override.
.UNINDENT
.SH "فایل‌ها (FILES)"
.INDENT 0.0
.TP
.B /etc/unbound/unbound.conf
فایل پیکربندی Unbound.
.TP
.B /etc/unbound
پوشه حاوی کلیدهای خصوصی (\fBunbound_server.key\fP و
\fBunbound_control.key\fP) و گواهی‌های خودامضا
(\fBunbound_server.pem\fP و \fBunbound_control.pem\fP).
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fI\%unbound.conf(5)\fP،
\fI\%unbound(8)\fP\&.
.SH "نویسندگان (AUTHORS)"
توسعه‌دهندگان Unbound در فایل CREDITS توزیع نرم‌افزار ذکر شده‌اند.
.SH "حق نشر (COPYRIGHT)"
1999-2026, NLnet Labs
.\" Generated by docutils manpage writer.
.