.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.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 "KNOTC" "8" "2026-06-12" "3.5.5" "Knot DNS"
.SH "نام (NAME)"
knotc \- ابزار کنترل Knot DNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBknotc\fP [\fIگزینه_پیکربندی\fP] [\fIگزینه‌ها\fP] [\fIاقدام\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
این برنامه فرآیند در حال اجرای \fIknotd\fP را با استفاده از یک سوکت کنترل می‌کند.
.sp
اگر یک \fIاقدام\fP مشخص شده باشد، انجام می‌شود و \fIknotc\fP خارج می‌گردد، در غیر این صورت برنامه
در حالت تعاملی اجرا می‌شود.
.SS "گزینه‌های پیکربندی (Config options)"
.INDENT 0.0
.TP
\fB\-c\fP, \fB\-\-config\fP \fIfile\fP
استفاده از یک فایل پیکربندی متنی (پیش‌فرض \fB/etc/knot/knot.conf\fP است).
.TP
\fB\-C\fP, \fB\-\-confdb\fP \fIdirectory\fP
استفاده از دایرکتوری پایگاه‌داده باینری پیکربندی (پیش‌فرض \fB/var/lib/knot/confdb\fP است).
پایگاه‌داده پیش‌فرض پیکربندی، در صورت وجود، نسبت به فایل پیکربندی
پیش‌فرض اولویت دارد.
.UNINDENT
.SS "گزینه‌ها (Options)"
.INDENT 0.0
.TP
\fB\-m\fP, \fB\-\-max\-conf\-size\fP \fIMiB\fP
تنظیم حداکثر اندازه پایگاه‌داده پیکربندی
(پیش‌فرض ۵۰۰ مبی‌بایت، حداکثر ۱۰۰۰۰ مبی‌بایت).
.TP
\fB\-s\fP, \fB\-\-socket\fP \fIpath\fP
استفاده از مسیر سوکت یونیکس کنترلی (پیش‌فرض \fB/run/knot/knot.sock\fP است).
.TP
\fB\-t\fP, \fB\-\-timeout\fP \fIseconds\fP
تنظیم مهلت زمانی کنترل بر حسب ثانیه. برای نامحدود مقدار 0 را قرار دهید (پیش‌فرض 60 است).
عملیات سوکت کنترلی همچنین تابع پارامتر مهلت زمانی \%<#\:control-timeout>
تنظیم‌شده در سمت سرور در بخش پیکربندی Control سرور هستند.
.TP
\fB\-b\fP, \fB\-\-blocking\fP
دستورات راه‌اندازی رویدادهای زون تا پایان رویداد منتظر می‌مانند. اگر مهلت زمانی
با مشخص کردن صریح تحمیل نشده باشد، مهلت زمانی کنترل روی بی‌نهایت تنظیم می‌شود.
.TP
\fB\-e\fP, \fB\-\-extended\fP
نمایش خروجی گسترش‌یافته (حتی موارد خالی در وضعیت زون).
.TP
\fB\-f\fP, \fB\-\-force\fP
عملیات اجباری. برخی بررسی‌ها را نادیده می‌گیرد.
.TP
\fB\-x\fP, \fB\-\-mono\fP
خروجی رنگی تولید نکن.
.TP
\fB\-X\fP, \fB\-\-color\fP
اجبار خروجی رنگی در خروجی گسترش‌یافته یا هنگام هدایت به لوله (pipe).
.TP
\fB\-v\fP, \fB\-\-verbose\fP
فعال‌سازی خروجی اشکال‌زدایی.
.TP
\fB\-h\fP, \fB\-\-help\fP
چاپ راهنمای برنامه.
.TP
\fB\-V\fP, \fB\-\-version\fP
چاپ نسخه برنامه. گزینه \fB\-VV\fP باعث می‌شود برنامه
خلاصه پیکربندی زمان کامپایل را چاپ کند.
.UNINDENT
.SS "اقدامات (Actions)"
.INDENT 0.0
.TP
\fBstatus\fP [\fIdetail\fP]
بررسی در حال اجرا بودن سرور. جزئیات شامل \fBversion\fP برای نسخه سرور
در حال اجرا، \fBworkers\fP برای تعداد رشته‌های کاری،
\fBconfigure\fP برای خلاصه پیکربندی، یا \fBcert\-key\fP برای
پین کلید عمومی گواهی در حال استفاده است.
.UNINDENT
.INDENT 0.0
.TP
\fBstop\fP
متوقف کردن سرور در صورت اجرا.
.UNINDENT
.INDENT 0.0
.TP
\fBreload\fP
بارگذاری مجدد پیکربندی سرور و فایل‌های زون تغییر‌یافته، و بازگشایی مجدد فایل‌های لاگ
در صورت پیکربندی آن‌ها. تمام تراکنش‌های باز زون لغو خواهند شد!
.UNINDENT
.INDENT 0.0
.TP
\fBstats\fP [\fImodule\fP[\fB\&.\fP\fIcounter\fP]]
نمایش شمارنده(های) آماری سراسری. برای چاپ شمارنده‌های دارای مقدار 0 نیز از
گزینه force استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-check\fP [\fIzone\fP\&...]
آزمایش اینکه آیا سرور می‌تواند زون را بارگذاری کند یا خیر. در صورت فعال بودن
در پیکربندی، بررسی‌های معنایی اجرا می‌شوند. اگر با گزینه force فراخوانی شود،
در صورت ظاهر شدن هشدار بررسی معنایی، یک خطا بازگردانده می‌شود. (*)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-status\fP [\fIzone\fP\&...] [\fIfilter\fP]
نمایش وضعیت زون. فیلترها عبارتند از \fB+role\fP، \fB+serial\fP، \fB+transaction\fP،
\fB+events\fP، \fB+freeze\fP و \fB+catalog\fP\&. پارامترهای خالی زون حذف می‌شوند،
مگر اینکه از گزینه \fB\-\-extended\fP استفاده شود. یک خط تیره منفرد در خروجی نشان‌دهنده
مقدار تنظیم‌نشده است. رنگ‌آمیزی خودکار را می‌توان با استفاده از گزینه‌های \fB\-\-mono\fP و
\fB\-\-color\fP تغییر داد.
.sp
کد رنگی به این صورت است:
\fIسبز\fP \- زون به عنوان اصلی (master) عمل می‌کند / \fIقرمز\fP \- زون به عنوان فرعی (slave) عمل می‌کند،
\fIقلم توپر (برجسته)\fP \- زون فعال است / \fIعادی\fP \- زون خالی است،
\fIزیرخط‌دار\fP \- زون یک عضو کاتالوگ تفسیر شده است.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-reload\fP [\fIzone\fP\&...]
راه‌اندازی بارگذاری مجدد زون از روی دیسک بدون بررسی زمان تغییر آن. برای
زون ثانویه، رویداد تازه‌سازی از سرور(های) اولیه زمان‌بندی می‌شود؛
برای زون اولیه، رویداد اطلاع‌رسانی به سرور(های) ثانویه زمان‌بندی می‌شود. هر تراکنش
باز زون لغو خواهد شد! در صورت فراخوانی با گزینه force، ماژول‌های زون نیز
مجدداً بارگذاری می‌شوند، اما ممکن است حالت انسدادی به درستی کار نکند. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-refresh\fP [\fIzone\fP\&...]
راه‌اندازی بررسی سریال زون در سرور اولیه زون. اگر
سرور اولیه زون جدیدتری داشته باشد، انتقال زمان‌بندی می‌شود. این دستور
برای زون‌های ثانویه معتبر است. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-retransfer\fP [\fIzone\fP\&...]
راه‌اندازی انتقال زون از سرور اولیه آن. سرور
شماره سریال زون سرور اولیه را بررسی نمی‌کند. این دستور برای
زون‌های ثانویه معتبر است. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-notify\fP [\fIzone\fP\&...]
ارسال پیام NOTIFY به تمام ریموت‌های پیکربندی‌شده. این کار می‌تواند در مواردی
که NOTIFY قبلی از دست رفته باشد یا سرورهای ثانویه
آفلاین بوده‌اند کمک کند. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-flush\fP [\fIzone\fP\&...] [\fB+outdir\fP \fIdirectory\fP]
تخلیه ژورنال زون به فایل زون پیکربندی‌شده. اگر همگام‌سازی فایل زون
غیرفعال باشد، باید از گزینه force استفاده شود.
اگر دایرکتوری خروجی مشخص شده باشد، زون فعلی بلافاصله
(در حالت انسدادی) در یک فایل زون در دایرکتوری مشخص‌شده ذخیره می‌شود. توضیحات
زیر را درباره مجوزهای دایرکتوری ببینید. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-backup\fP [\fIzone\fP\&...] \fB+backupdir\fP \fIdirectory\fP [\fIfilter\fP\&...]
راه‌اندازی پشتیبان‌گیری از داده‌ها و متاداده‌های زون در یک دایرکتوری مشخص.
فیلترهای موجود عبارتند از \fB+zonefile\fP، \fB+journal\fP، \fB+timers\fP، \fB+kaspdb\fP،
\fB+keysonly\fP، \fB+catalog\fP، \fB+quic\fP و همتایان منفی آن‌ها
\fB+nozonefile\fP، \fB+nojournal\fP، \fB+notimers\fP، \fB+nokaspdb\fP، \fB+nokeysonly\fP،
\fB+nocatalog\fP و \fB+noquic\fP\&. با تنظیم این فیلترها، به ترتیب محتوای زون،
ژورنال زون، زمان‌سنج‌های مربوط به زون، داده‌های مربوط به زون در پایگاه‌داده KASP
به همراه کلیدها (یا کلیدها بدون پایگاه‌داده KASP)، کاتالوگ زون،
و کلید و گواهی QUIC سرور پشتیبان‌گیری می‌شوند،
یا از پشتیبان‌گیری حذف می‌گردند. به طور پیش‌فرض، فیلترهای \fB+zonefile\fP، \fB+timers\fP،
\fB+kaspdb\fP، \fB+catalog\fP، \fB+quic\fP، \fB+nojournal\fP و \fB+nokeysonly\fP
برای پشتیبان‌گیری تنظیم شده‌اند. همین پیش‌فرض‌ها برای بازیابی نیز تنظیم شده‌اند، تنها
با این تفاوت که \fB+noquic\fP تنظیم است. تنظیم یک فیلتر برای یک مورد، تنظیمات
پیش‌فرض سایر موارد را تغییر نمی‌دهد. تنها استثنا \fB+keysonly\fP است که
تمام فیلترهای دیگر را به طور پیش‌فرض غیرفعال می‌کند، اما هنوز می‌توان آن‌ها را به صراحت
فعال کرد. اگر تخلیه زون غیرفعال باشد، فایل زون اصلی به جای نوشتن
محتوای زون در یک فایل پشتیبان‌گیری می‌شود. هنگام پشتیبان‌گیری از یک زون
کاتالوگ، توصیه می‌شود با استفاده از \fBzone\-freeze\fP از اعمال تغییرات مداوم روی آن
جلوگیری شود. گزینه force اجازه می‌دهد دایرکتوری backupdir از قبل موجود رونویسی
شود. توضیحات زیر را درباره مجوزهای دایرکتوری ببینید.
(#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-restore\fP [\fIzone\fP\&...] \fB+backupdir\fP \fIdirectory\fP [\fIfilter\fP\&...]
راه‌اندازی بازیابی داده‌ها و متاداده‌های زون از یک دایرکتوری پشتیبان مشخص‌شده.
فیلترهای اختیاری معادل همان فیلترهای \fBzone\-backup\fP هستند.
بازیابی از نسخه‌های پشتیبان ایجادشده توسط نگارش‌های Knot DNS قبل از 3.1
با گزینه force امکان‌پذیر است. توضیحات زیر را درباره مجوزهای
دایرکتوری ببینید. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-sign\fP [\fIzone\fP\&...]
راه‌اندازی امضای مجدد DNSSEC برای زون. امضاهای موجود حذف خواهند شد.
این دستور برای زون‌هایی که امضای DNSSEC در آن‌ها فعال است معتبر است. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-validate\fP [\fIzone\fP\&...]
راه‌اندازی اعتبارسنجی DNSSEC برای زون. اگر اعتبارسنجی ناموفق باشد و
زون از نوع ثانویه باشد، زون بلافاصله منقضی می‌شود! (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-keys\-load\fP [\fIzone\fP\&...]
راه‌اندازی بارگذاری کلیدهای DNSSEC و سایر مواد امضا از پایگاه‌داده KASP
(که ممکن است به صورت دستی تغییر یافته باشد). در صورت مناسب بودن، پس از آن
زون مجدداً امضا می‌شود (با حفظ امضاهای معتبر به صورت دست‌نخورده). (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-key\-rollover\fP \fIzone\fP \fIkey_type\fP
راه‌اندازی فوری تعویض کلید (rollover). انتشار کلید جدید و شروع تعویض کلید،
حتی اگر کلید هنوز مدت اعتبار داشته باشد. نوع کلید می‌تواند \fBksk\fP (همچنین برای CSK)
یا \fBzsk\fP باشد. این دستور برای زون‌های دارای امضای DNSSEC و مدیریت خودکار
کلید معتبر است. توجه داشته باشید که تعویض کامل کلید شامل چند مرحله است
و حالت انسدادی تنها مربوط به مرحله اولیه است! (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-ksk\-submitted\fP \fIzone\fP\&... [\fB+ttl\fP \fIseconds\fP]
زمانی استفاده می‌شود که تعویض KSK زون در مرحله ارسال (submission) است. با فراخوانی این دستور،
کاربر به صورت دستی تایید می‌کند که زون والد حاوی رکورد DS برای KSK جدید
در مرحله ارسال است و KSK قدیمی می‌تواند بازنشسته شود. پارامتر اختیاری \fB+ttl\fP
مقدار TTL رکورد DS والد و احتمالاً تأخیرهای دیگر را مشخص می‌کند، با این اثر که
حذف KSK قدیمی به اندازه این تعداد ثانیه به تعویق می‌افتد. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-freeze\fP [\fIzone\fP\&...]
راه‌اندازی انجماد زون. تمام رویدادهای در حال اجرا پایان می‌یابند و تمام رویدادهای جدید و معلق
(برنامه‌ریزی‌شده) تغییر‌دهنده زون (بارگذاری، تازه‌سازی، به‌روزرسانی، تخلیه و امضای DNSSEC)
تا زمان خروج از انجماد زون متوقف خواهند شد. تا 8 به‌روزرسانی DDNS
(این محدودیت در کد برنامه ثابت است) به ازای هر زون در صف قرار می‌گیرند، به‌روزرسانی‌های بعدی رد خواهند شد. وضعیت
انجماد زون پس از راه‌اندازی مجدد سرور باقی نمی‌ماند! (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-thaw\fP [\fIzone\fP\&...]
راه‌اندازی لغو انجماد زون. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-xfr\-freeze\fP [\fIzone\fP\&...]
غیرفعال‌سازی موقت AXFR/IXFR خروجی برای زون(ها). وضعیت انجماد انتقال زون
پس از راه‌اندازی مجدد سرور پایدار می‌ماند. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-xfr\-thaw\fP [\fIzone\fP\&...]
لغو انجماد انتقال‌های خروجی XFR. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-read\fP \fIzone\fP [\fIowner\fP [\fItype\fP]]
دریافت داده‌های زون که در حال حاضر ارائه می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-begin\fP \fIzone\fP\&... [\fB+benevolent\fP]
آغاز یک تراکنش زون. در صورت استفاده از \fB+benevolent\fP، تراکنش حتی در صورتی که
حاوی حذف رکوردهای ناموجود یا افزودن رکوردهای
موجود باشد اعمال خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-commit\fP \fIzone\fP\&...
اعمال تراکنش زون. تمام تغییرات روی زون اعمال می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-abort\fP \fIzone\fP\&...
لغو تراکنش زون. تمام تغییرات دور ریخته می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-diff\fP \fIzone\fP
دریافت تغییرات زون درون تراکنش.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-get\fP \fIzone\fP [\fIowner\fP [\fItype\fP]]
دریافت داده‌های زون درون تراکنش.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-set\fP \fIzone\fP \fIowner\fP [\fIttl\fP] \fItype\fP \fIrdata\fP
افزودن رکورد زون درون تراکنش. نخستین رکورد در یک rrset
نیازمند مشخص کردن مقدار ttl است.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-unset\fP \fIzone\fP \fIowner\fP [\fItype\fP [\fIrdata\fP]]
حذف داده‌های زون درون تراکنش.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-purge\fP \fIzone\fP\&... [\fB+orphan\fP] [\fIfilter\fP\&...]
پاکسازی داده‌های زون، فایل زون، ژورنال، زمان‌سنج‌ها و/یا داده‌های KASP در زون‌های مشخص‌شده.
فیلترهای موجود عبارتند از \fB+expire\fP، \fB+zonefile\fP، \fB+journal\fP، \fB+timers\fP،
\fB+kaspdb\fP و \fB+catalog\fP\&. اگر فیلتری مشخص نشود، تمام فیلترها فعال خواهند بود.
اگر زون دیگر پیکربندی نشده است، پارامتر \fB+orphan\fP را اضافه کنید (فایل زون
در این حالت نمی‌تواند پاکسازی شود). هنگام پاکسازی زون‌های یتیم (orphan)، همیشه گزارش وقایع سرور را
برای خطاهای احتمالی بررسی کنید. برای عملکرد مناسب، لازم است از تغییرات در حال انجام روی زون
و راه‌اندازی رویدادهای مربوط به زون حین پاکسازی جلوگیری شود؛ استفاده از
\fBzone\-freeze\fP توصیه می‌شود. این دستور همیشه نیازمند گزینه force است. (#)
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-stats\fP \fIzone\fP [\fImodule\fP[\fB\&.\fP\fIcounter\fP]]
نمایش شمارنده(های) آماری زون. برای چاپ شمارنده‌های با مقدار 0 نیز از
گزینه force استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
\fBzone\-serial\-set\fP \fIzone\fP [[\fB+\fP]\fIserial\fP]
تنظیم سریال SOA زون به مقدار مشخص‌شده. اگر آرگومان دارای پیشوند
\fB+\fP باشد، سریال به اندازه آن مقدار افزایش می‌یابد (ثابت ویژه \fBMAX\fP
می‌تواند برای افزایش به اندازه حداکثر مقدار مجاز 2147483647 استفاده شود).
اگر تراکنش زون باز باشد، هم خواندن و هم نوشتن سریال SOA
درون همان تراکنش رخ می‌دهد. در غیر این صورت، یک تراکنش کوتاه‌مدت
تنها برای تنظیم سریال جدید SOA ایجاد و اعمال می‌شود.
اگر هیچ آرگومانی مشخص نشود، سریال فعلی SOA زون بازگردانده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-init\fP
مقداردهی اولیه پایگاه‌داده پیکربندی. اگر پایگاه‌داده هنوز وجود ندارد،
این دستور را با کاربر مورد نظر اجرا کنید تا اطمینان حاصل شود سرور مجاز به
دسترسی به پایگاه‌داده است (مانند \fIsudo \-u knot knotc conf\-init\fP). (*)
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-check\fP
بررسی پیکربندی سرور. (*)
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-import\fP \fIfilename\fP [\fB+nopurge\fP]
وارد کردن یک فایل پیکربندی به پایگاه‌داده پیکربندی. اگر پایگاه‌داده
هنوز وجود ندارد، این دستور را با کاربر مورد نظر اجرا کنید تا مطمئن شوید سرور
مجاز به دسترسی به پایگاه‌داده است (مانند \fIsudo \-u knot knotc conf\-import ...\fP).
یک فیلتر اختیاری \fB+nopurge\fP از پاکسازی احتمالی پایگاه‌داده پیکربندی
موجود قبل از خود عملیات واردسازی جلوگیری می‌کند.
همچنین مطمئن شوید که سرور همزمان از پایگاه‌داده پیکربندی استفاده نمی‌کند! (*)
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-export\fP [\fIfilename\fP] [\fB+schema\fP]
صادر کردن پایگاه‌داده پیکربندی (یا طرح‌واره JSON) به یک فایل یا خروجی استاندارد. (*)
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-list\fP [\fIitem\fP]
فهرست کردن بخش‌های پایگاه‌داده پیکربندی یا موارد یک بخش.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-read\fP [\fIitem\fP]
خواندن مورد از پایگاه‌داده پیکربندی فعال.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-begin\fP
آغاز یک تراکنش نوشتن در پایگاه‌داده پیکربندی. در هر زمان تنها یک تراکنش
می‌تواند باز باشد.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-commit\fP
اعمال تراکنش پایگاه‌داده پیکربندی.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-abort\fP
بازگرداندن (انصراف از) تراکنش پایگاه‌داده پیکربندی.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-diff\fP [\fIitem\fP]
دریافت تفاوت‌های مورد در تراکنش.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-get\fP [\fIitem\fP]
دریافت داده‌های مورد از تراکنش.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-set\fP \fIitem\fP [\fIdata\fP\&...]
تنظیم داده‌های مورد در تراکنش.
.UNINDENT
.INDENT 0.0
.TP
\fBconf\-unset\fP [\fIitem\fP] [\fIdata\fP\&...]
لغو تنظیم داده‌های مورد در تراکنش.
.UNINDENT
.SS "یادداشت‌ها (Notes)"
.sp
پارامتر خالی یا \fB\-\-\fP \fIzone\fP به معنای همه زون‌ها یا همه زون‌های دارای یک تراکنش است.
.sp
از \fB@\fP \fIowner\fP برای نشان دادن نام زون استفاده کنید.
.sp
پارامتر \fIitem\fP را به فرمت \fIsection\fP[\fB[\fP\fIid\fP\fB]\fP][\fB\&.\fP\fIname\fP] تایپ کنید.
.sp
(*) نشان‌دهنده یک عملیات محلی است که نیازمند پیکربندی است.
.sp
(#) نشان‌دهنده یک عملیات اختیاری انسدادی (blocking) است.
.sp
گزینه‌های \fB\-b\fP و \fB\-f\fP می‌توانند دقیقاً پس از نام دستور قرار گیرند.
.sp
پاسخ‌های بازگردانده‌شده توسط دستورات \fIknotc\fP به حالت اجرا بستگی دارند:
.INDENT 0.0
.IP \(bu 2
در حالت انسدادی، \fIknotc\fP گزارش می‌دهد که آیا خطایی حین پردازش
دستور توسط سرور رخ داده است یا خیر. اگر خطایی گزارش شود، معمولاً اطلاعات دقیق‌تر
درباره شکست را می‌توان در لاگ سرور یافت.
.IP \(bu 2
در حالت غیرانسدادی (پیش‌فرض)، \fIknotc\fP خطاهای پردازش را گزارش نمی‌کند.
پاسخ \fIOK\fP به دستورات راه‌اندازی به این معنی است که دستور با موفقیت
به سرور ارسال شده است. برای بررسی موفقیت‌آمیز بودن عملیات، لازم است
گزارش‌های سرور بررسی شوند.
.UNINDENT
.sp
اقدامات \fBzone\-flush\fP، \fBzone\-backup\fP و \fBzone\-restore\fP توسط
فرآیند \fIknotd\fP انجام می‌شوند. دایرکتوری مشخص‌شده باید برای حساب کاربری
که \fIknotd\fP تحت آن اجرا می‌شود قابل دسترسی باشد و اگر دایرکتوری از قبل وجود دارد، مجوزهای آن باید
برای آن حساب کاربری مناسب باشد.
.SS "حالت تعاملی (Interactive mode)"
.sp
این ابزار یک حالت تعاملی با قابلیت‌های اساسی ویرایش خط،
تکمیل دستور و تاریخچه دستورات ارائه می‌دهد.
.sp
رفتار حالت تعاملی را می‌توان در \fI~/.editrc\fP سفارشی کرد. برای جزئیات
به \fBeditrc(5)\fP مراجعه کنید.
.sp
تاریخچه دستورات در \fI~/.knotc_history\fP ذخیره می‌شود.
.SH "کدهای خروج (EXIT VALUES)"
.sp
وضعیت خروج 0 به معنای عملیات موفقیت‌آمیز است. هر وضعیت خروج دیگری
نشان‌دهنده یک خطا است.
.SH "مثال‌ها (EXAMPLES)"
.SS "بارگذاری مجدد کل پیکربندی سرور (Reload the whole server configuration)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc reload
.EE
.UNINDENT
.UNINDENT
.SS "تخلیه ژورنال زون‌های example.com و example.org (Flush the example.com and example.org zones)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc zone\-flush example.com example.org
.EE
.UNINDENT
.UNINDENT
.SS "دریافت پیکربندی فعلی سرور (Get the current server configuration)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc conf\-read server
.EE
.UNINDENT
.UNINDENT
.SS "دریافت فهرست زون‌های فعلی (Get the list of the current zones)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc conf\-read zone.domain
.EE
.UNINDENT
.UNINDENT
.SS "دریافت سرورهای اولیه برای زون example.com (Get the primary servers for the example.com zone)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc conf\-read \(aqzone[example.com].master\(aq
.EE
.UNINDENT
.UNINDENT
.SS "افزودن زون example.org به همراه مکان فایل زون (Add example.org zone with a zonefile location)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc conf\-begin
$ knotc conf\-set \(aqzone[example.org]\(aq
$ knotc conf\-set \(aqzone[example.org].file\(aq \(aq/var/zones/example.org.zone\(aq
$ knotc conf\-commit
.EE
.UNINDENT
.UNINDENT
.SS "دریافت رکورد SOA برای هر زون پیکربندی‌شده (Get the SOA record for each configured zone)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ knotc zone\-read \-\- @ SOA
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBknotd(8)\fP, \fBknot.conf(5)\fP, \fBeditrc(5)\fP\&.
.SH "نویسنده (AUTHOR)"
CZ.NIC, z.s.p.o. and contributors <https://www.knot-dns.cz>
.SH "حق نشر (COPYRIGHT)"
Copyright (C) CZ.NIC, z.s.p.o. and contributors
.\" End of generated man page.