| PDNS_CONTROL(1) | PowerDNS Authoritative Server | PDNS_CONTROL(1) |
نام (NAME)
pdns_control - کنترل کارساز نام PowerDNS
خلاصه دستور (SYNOPSIS)
pdns_control [OPTION]... COMMAND
توضیحات (DESCRIPTION)
ابزار pdns_control برای ارسال دستورها به یک کارساز نام PowerDNS در حال اجرا استفاده می‌شود.
گزینه‌ها (OPTIONS)
- --help
- نمایش خلاصه‌ای از گزینه‌ها.
- --chroot=<DIR>
- دایرکتوری‌ای که PowerDNS در آن chroot شده است.
- --config-dir=<DIR>
- محل دایرکتوری پیکربندی (pdns.conf).
- --config-name=<NAME>
- نام این پیکربندی مجازی - ایمیج باینری را تغییر نام خواهد داد.
- --remote-address=<ADDRESS>
- نشانی دوردست برای پرس‌وجو.
- --remote-port=<PORT>
- درگاه دوردست برای پرس‌وجو.
- --secret=<SECRET>
- رمز مورد نیاز برای اتصال به PowerDNS دوردست.
- --socket-dir=<DIR>
- محلی که controlsocket در آن قرار دارد.
دستورها (COMMANDS)
bind-add-zone ZONE FILENAME
هنگام استفاده از backend مربوط به BIND، یک ناحیه اضافه می‌کند. این ناحیه در حافظه افزوده شده و بلافاصله سرویس‌دهی می‌شود. توجه داشته باشید که این کار ناحیه را به فایل bind-config اضافه نمی‌کند. FILENAME باید یک مسیر مطلق باشد.
bind-domain-extended-status [ZONE...]
خروجی وضعیت گسترش‌یافته‌ای از تمام ناحیه‌ها را نمایش می‌دهد که حاوی اطلاعات بسیار بیشتری نسبت به وضعیت ساده ناحیه است؛ مانند تعداد رکوردهای بارگذاری‌شده فعلی، اینکه آیا pdns برای این ناحیه primary است یا secondary، فهرست primaryها، تایمرهای گوناگون و غیره. به صورت اختیاری، می‌توانید ZONEها را برای دریافت وضعیت ناحیه‌های خاص اضافه کنید.
bind-domain-status [ZONE...]
هنگام استفاده از backend مربوط به BIND، وضعیت تمام ناحیه‌ها را فهرست می‌کند. به صورت اختیاری، می‌توانید ZONEها را برای دریافت وضعیت ناحیه‌های خاص اضافه کنید.
bind-list-rejects
هنگام استفاده از backend مربوط به BIND، فهرستی از تمام ناحیه‌های ردشده را دریافت می‌کند.
bind-reload-now ZONE [ZONE...]
هنگام استفاده از backend مربوط به BIND، بلافاصله ZONE را از روی دیسک بازخوانی می‌کند.
ccounts
محتوای حافظه موقت (cache) را نمایش می‌دهد.
current-config [diff]
پیکربندی در حال اجرای کنونی را نمایش می‌دهد. قالب خروجی مشابه با pdns_server --config است. با گزینه diff، تنها گزینه‌های تغییریافته در خروجی گنجانده می‌شوند.
cycle
کارساز نام را مجدداً راه‌اندازی می‌کند تا پیکربندی خود را دوباره بارگذاری کند. این دستور تنها زمانی کار می‌کند که کارساز در حالت guardian در حال اجرا باشد.
flush
تخلیه تمام داده‌های backend روی حافظه ذخیره‌سازی پایدار. معمولاً در حین عملیات عادی چنین داده‌ای وجود ندارد، مگر اینکه backend مربوط به LMDB به همراه تنظیم lmdb-write-notification-update بر روی no استفاده شود.
list
تخلیه تمامی آمارها و مقادیر آن‌ها در یک فهرست جداشده با کاما، معادل با show *.
list-zones [primary,secondary,native]
نمایش فهرستی از ناحیه‌ها، با امکان پالایش اختیاری بر اساس نوع ناحیه برای نمایش.
notify ZONE
ناحیه ZONE را به فهرست اعلان اضافه می‌کند و باعث می‌شود PowerDNS اعلان‌هایی را به کارسازهای نام آن ناحیه ارسال کند. در صورتی که یک secondary اعلان‌های قبلی را دریافت نکرده باشد یا کلاً پاسخگو نباشد، می‌توان از این دستور استفاده کرد. برای اعلان به همه ناحیه‌ها از * استفاده کنید. (توجه داشته باشید که ممکن است لازم باشد علامت * را در پوسته خود گریزدهی کنید.)
notify-host ZONE ADDRESS
مشابه دستور بالا است، اما با آدرس آی‌پی مشخص‌شده توسط کاربر (ADDRESS) به عنوان مقصد؛ در مواقعی به کار می‌رود که اطلاعات دقیق‌تری نسبت به PowerDNS در دست دارید.
ping, rping
بررسی فعال بودن کارساز. در صورت فعال بودن، 'PONG' را برمی‌گرداند. ping هنگام اجرا درون guardian کار می‌کند، در حالی که rping هنگام اجرا بدون guardian عمل می‌کند.
purge [RECORD]
پاک‌سازی مدخل‌ها از حافظه موقت (cache). اگر RECORD به یک علامت دلار ($) ختم شود، تمام مدخل‌هایی که نام آن‌ها به آن ختم می‌شود حذف می‌گردند. اگر رکوردی مشخص نشود، کل cache پاک‌سازی خواهد شد.
qtypes
دریافت تعداد پرس‌وجوها به تفکیک qtype در خروجی استاندارد.
quit or stop
دستور خروج به pdns_server در حال اجرا.
rediscover
به backendها اطلاع می‌دهد که ممکن است ناحیه‌های جدیدی در پایگاه داده یا در صورت استفاده از BIND backend در named.conf پدیدار شده باشند.
reload
دستور به کارساز برای بازخوانی مجدد تمام ناحیه‌های خود؛ این فرمان ناحیه‌های جدید را اضافه نخواهد کرد.
remotes
دریافت بیشترین نشانی‌های دوردست متصل‌شده (کلاینت‌ها).
respsizes
دریافت یک بافت‌نگار (هیستوگرام) از اندازه‌های پاسخ.
retrieve ZONE [IP]
دریافت ناحیه secondary با نام ZONE از primary مربوط به آن. این کار تقریباً بلافاصله انجام می‌شود. اگر IP مشخص شده باشد، دریافت به صورت اجباری از IP تعیین‌شده انجام می‌گیرد. درگاه را می‌توان به شیوه مختص AFI مشخص کرد.
set VARIABLE VALUE
تنظیم پارامتر پیکربندی VARIABLE بر روی مقدار VALUE. در حال حاضر تنها query-logging قابل تنظیم است.
show STATISTIC
نمایش یک قلم آماری، به همان صورتی که در خروجی دستور list وجود دارد.
show STATISTIC-PREFIX*
نمایش تمام آمارهایی که نام آن‌ها با STATISTIC-PREFIX ارائه‌شده شروع می‌شود، به صورت یک فهرست جداشده با کاما. تنها یک نویسه عام (در انتها) مجاز است.
status
نمایش آمارهای مصرف. این دستور تنها در صورتی کار می‌کند که کارساز در حالت guardian در حال اجرا باشد.
token-login MODULE SLOT PIN
ورود به یک اسلات PKCS#11. حتی در صورت وجود چندین کلید در یک اسلات، تنها یک بار ورود به ازای هر اسلات کافی است. این دستور تنها در صورتی در دسترس است که PowerDNS با پشتیبانی از PKCS#11 کامپایل شده باشد.
uptime
نمایش مدت زمان فعالیت (uptime) کارساز در حال اجرا.
version
چاپ نسخه دیمن pdns در حال اجرا.
همچنین ببینید (SEE ALSO)
pdns_server (1), pdnsutil (1)
نویسندگان (AUTHORS)
PowerDNS.COM BV
کپی‌رایت و تکثیر (COPYRIGHT)
PowerDNS.COM BV
| August 5, 2026 |