.\" 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 "PDNS_CONTROL" "1" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
pdns_control \- کنترل کارساز نام PowerDNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpdns_control\fP [\fIOPTION\fP]... \fICOMMAND\fP
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBpdns_control\fP برای ارسال دستورها به یک کارساز نام PowerDNS در حال اجرا استفاده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B  \-\-help
نمایش خلاصه‌ای از گزینه‌ها.
.TP
.BI \-\-chroot\fB= <DIR>
دایرکتوری‌ای که PowerDNS در آن chroot شده است.
.TP
.BI \-\-config\-dir\fB= <DIR>
محل دایرکتوری پیکربندی (pdns.conf).
.TP
.BI \-\-config\-name\fB= <NAME>
نام این پیکربندی مجازی \- ایمیج باینری را تغییر نام خواهد داد.
.TP
.BI \-\-remote\-address\fB= <ADDRESS>
نشانی دوردست برای پرس‌وجو.
.TP
.BI \-\-remote\-port\fB= <PORT>
درگاه دوردست برای پرس‌وجو.
.TP
.BI \-\-secret\fB= <SECRET>
رمز مورد نیاز برای اتصال به PowerDNS دوردست.
.TP
.BI \-\-socket\-dir\fB= <DIR>
محلی که controlsocket در آن قرار دارد.
.UNINDENT
.SH "دستورها (COMMANDS)"
.SS bind\-add\-zone \fIZONE\fP \fIFILENAME\fP
.sp
هنگام استفاده از backend مربوط به BIND، یک ناحیه اضافه می‌کند. این ناحیه در حافظه افزوده شده و بلافاصله سرویس‌دهی می‌شود. توجه داشته باشید که این کار ناحیه را به فایل bind\-config اضافه نمی‌کند. \fIFILENAME\fP باید یک مسیر مطلق باشد.
.SS bind\-domain\-extended\-status [\fIZONE\fP\&...]
.sp
خروجی وضعیت گسترش‌یافته‌ای از تمام ناحیه‌ها را نمایش می‌دهد که حاوی اطلاعات بسیار بیشتری نسبت به وضعیت ساده ناحیه است؛ مانند تعداد رکوردهای بارگذاری‌شده فعلی، اینکه آیا pdns برای این ناحیه primary است یا secondary، فهرست primaryها، تایمرهای گوناگون و غیره. به صورت اختیاری، می‌توانید \fIZONE\fPها را برای دریافت وضعیت ناحیه‌های خاص اضافه کنید.
.SS bind\-domain\-status [\fIZONE\fP\&...]
.sp
هنگام استفاده از backend مربوط به BIND، وضعیت تمام ناحیه‌ها را فهرست می‌کند. به صورت اختیاری، می‌توانید \fIZONE\fPها را برای دریافت وضعیت ناحیه‌های خاص اضافه کنید.
.SS bind\-list\-rejects
.sp
هنگام استفاده از backend مربوط به BIND، فهرستی از تمام ناحیه‌های ردشده را دریافت می‌کند.
.SS bind\-reload\-now \fIZONE\fP [\fIZONE\fP\&...]
.sp
هنگام استفاده از backend مربوط به BIND، بلافاصله \fIZONE\fP را از روی دیسک بازخوانی می‌کند.
.SS ccounts
.sp
محتوای حافظه موقت (cache) را نمایش می‌دهد.
.SS current\-config [diff]
.sp
پیکربندی در حال اجرای کنونی را نمایش می‌دهد. قالب خروجی مشابه با \fBpdns_server \-\-config\fP است. با گزینه diff، تنها گزینه‌های تغییریافته در خروجی گنجانده می‌شوند.
.SS cycle
.sp
کارساز نام را مجدداً راه‌اندازی می‌کند تا پیکربندی خود را دوباره بارگذاری کند. این دستور تنها زمانی کار می‌کند که کارساز در حالت guardian در حال اجرا باشد.
.SS flush
.sp
تخلیه تمام داده‌های backend روی حافظه ذخیره‌سازی پایدار.
معمولاً در حین عملیات عادی چنین داده‌ای وجود ندارد، مگر اینکه backend مربوط به LMDB به همراه تنظیم \fI\%lmdb\-write\-notification\-update\fP بر روی \fBno\fP استفاده شود.
.SS list
.sp
تخلیه تمامی آمارها و مقادیر آن‌ها در یک فهرست جداشده با کاما، معادل با \fBshow *\fP\&.
.SS list\-zones [primary,secondary,native]
.sp
نمایش فهرستی از ناحیه‌ها، با امکان پالایش اختیاری بر اساس نوع ناحیه برای نمایش.
.SS notify \fIZONE\fP
.sp
ناحیه \fIZONE\fP را به فهرست اعلان اضافه می‌کند و باعث می‌شود PowerDNS اعلان‌هایی را به کارسازهای نام آن ناحیه ارسال کند. در صورتی که یک secondary اعلان‌های قبلی را دریافت نکرده باشد یا کلاً پاسخگو نباشد، می‌توان از این دستور استفاده کرد. برای اعلان به همه ناحیه‌ها از * استفاده کنید. (توجه داشته باشید که ممکن است لازم باشد علامت * را در پوسته خود گریزدهی کنید.)
.SS notify\-host \fIZONE\fP \fIADDRESS\fP
.sp
مشابه دستور بالا است، اما با آدرس آی‌پی مشخص‌شده توسط کاربر (\fIADDRESS\fP) به عنوان مقصد؛ در مواقعی به کار می‌رود که اطلاعات دقیق‌تری نسبت به PowerDNS در دست دارید.
.SS ping, rping
.sp
بررسی فعال بودن کارساز. در صورت فعال بودن، \(aqPONG\(aq را برمی‌گرداند.
\fBping\fP هنگام اجرا درون guardian کار می‌کند، در حالی که \fBrping\fP هنگام اجرا بدون guardian عمل می‌کند.
.SS purge [\fIRECORD\fP]
.sp
پاک‌سازی مدخل‌ها از حافظه موقت (cache). اگر \fIRECORD\fP به یک علامت دلار ($) ختم شود، تمام مدخل‌هایی که نام آن‌ها به آن ختم می‌شود حذف می‌گردند. اگر رکوردی مشخص نشود، کل cache پاک‌سازی خواهد شد.
.SS qtypes
.sp
دریافت تعداد پرس‌وجوها به تفکیک qtype در خروجی استاندارد.
.SS quit or stop
.sp
دستور خروج به pdns_server در حال اجرا.
.SS rediscover
.sp
به backendها اطلاع می‌دهد که ممکن است ناحیه‌های جدیدی در پایگاه داده یا در صورت استفاده از BIND backend در named.conf پدیدار شده باشند.
.SS reload
.sp
دستور به کارساز برای بازخوانی مجدد تمام ناحیه‌های خود؛ این فرمان ناحیه‌های جدید را اضافه نخواهد کرد.
.SS remotes
.sp
دریافت بیشترین نشانی‌های دوردست متصل‌شده (کلاینت‌ها).
.SS respsizes
.sp
دریافت یک بافت‌نگار (هیستوگرام) از اندازه‌های پاسخ.
.SS retrieve \fIZONE\fP [IP]
.sp
دریافت ناحیه secondary با نام \fIZONE\fP از primary مربوط به آن. این کار تقریباً بلافاصله انجام می‌شود. اگر IP مشخص شده باشد، دریافت به صورت اجباری از IP تعیین‌شده انجام می‌گیرد. درگاه را می‌توان به شیوه مختص AFI مشخص کرد.
.SS set \fIVARIABLE\fP \fIVALUE\fP
.sp
تنظیم پارامتر پیکربندی \fIVARIABLE\fP بر روی مقدار \fIVALUE\fP\&. در حال حاضر تنها query\-logging قابل تنظیم است.
.SS show \fISTATISTIC\fP
.sp
نمایش یک قلم آماری، به همان صورتی که در خروجی دستور list وجود دارد.
.SS show \fISTATISTIC\-PREFIX\fP*
.sp
نمایش تمام آمارهایی که نام آن‌ها با \fISTATISTIC\-PREFIX\fP ارائه‌شده شروع می‌شود، به صورت یک فهرست جداشده با کاما. تنها یک نویسه عام (در انتها) مجاز است.
.SS status
.sp
نمایش آمارهای مصرف. این دستور تنها در صورتی کار می‌کند که کارساز در حالت guardian در حال اجرا باشد.
.SS token\-login \fIMODULE\fP \fISLOT\fP \fIPIN\fP
.sp
ورود به یک اسلات PKCS#11. حتی در صورت وجود چندین کلید در یک اسلات، تنها یک بار ورود به ازای هر اسلات کافی است. این دستور تنها در صورتی در دسترس است که PowerDNS با پشتیبانی از PKCS#11 کامپایل شده باشد.
.SS uptime
.sp
نمایش مدت زمان فعالیت (uptime) کارساز در حال اجرا.
.SS version
.sp
چاپ نسخه دیمن pdns در حال اجرا.
.SH "همچنین ببینید (SEE ALSO)"
.sp
pdns_server (1), pdnsutil (1)
.SH "نویسندگان (AUTHORS)"
PowerDNS.COM BV
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.