.\" 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 "KNSUPDATE" "1" "2026-06-12" "3.5.5" "Knot DNS"
.SH "نام (NAME)"
knsupdate \- ابزار به‌روزرسانی پویای DNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBknsupdate\fP [\fB\-v\fP] [\fIoptions\fP] [\fIfilename\fP]
.sp
\fBknsupdate\fP [\fB\-q\fP] [\fIquic_options\fP] [\fIoptions\fP] [\fIfilename\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار پیام‌های به‌روزرسانی پویای DNS را به یک کارساز DNS ارسال می‌کند. محتوای
به‌روزرسانی از یک فایل (در صورت مشخص شدن پارامتر \fIfilename\fP) یا از ورودی
استاندارد خوانده می‌شود.
.sp
قالب به‌روزرسانی‌ها متنی بوده و از دستورها تشکیل شده است. هر دستور در یک خط مجزا
از ورودی قرار می‌گیرد. خطوطی که با نقطه‌ویرگول (;) آغاز می‌شوند توضیح (کامنت) هستند
و پردازش نمی‌شوند.
.SS "پارامترها (Parameters)"
.INDENT 0.0
.TP
.B \fIfilename\fP
مسیر فایلی که شامل دستورهای knsupdate است.
.UNINDENT
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
\fB\-T\fP, \fB\-\-tcp\fP
استفاده از اتصال TCP. (از \fB\-v\fP می‌توان برای سازگاری با nsupdate استفاده کرد).
.TP
\fB\-S\fP, \fB\-\-tls\fP
استفاده از اتصال TLS.
.TP
\fB\-Q\fP, \fB\-\-quic\fP
استفاده از اتصال QUIC.
.TP
\fB\-p\fP, \fB\-\-port\fP \fInumber\fP
تنظیم درگاه برای اتصال به کارساز (اگر صراحتاً در به‌روزرسانی تعیین نشده باشد). مقدار
پیش‌فرض برای UDP/TCP برابر ۵۳ و برای QUIC برابر ۸۵۳ است.
.TP
\fB\-r\fP, \fB\-\-retry\fP \fIcount\fP
تعداد تلاش‌های مجدد برای درخواست‌های UDP. مقدار پیش‌فرض ۳ است.
.TP
\fB\-t\fP, \fB\-\-timeout\fP \fIseconds\fP
کل مهلت زمانی (برای تمام تلاش‌های به‌روزرسانی UDP) درخواست بر حسب ثانیه. مقدار
پیش‌فرض ۱۲ است. در صورت تنظیم روی صفر، مهلت زمانی نامحدود خواهد بود.
.TP
\fB\-y\fP, \fB\-\-tsig\fP [\fIalg\fP:]\fIname\fP:\fIkey\fP
استفاده از کلید TSIG با نام \fIname\fP برای احراز اصالت درخواست. بخش \fIalg\fP الگوریتم
را تعیین می‌کند (پیش‌فرض hmac\-sha256 است) و \fIkey\fP راز مشترک با کدگذاری Base64 را مشخص می‌کند.
.TP
\fB\-k\fP, \fB\-\-tsigfile\fP \fIpath\fP
استفاده از کلید TSIG ذخیره‌شده در فایل \fIkeyfile\fP برای احراز اصالت درخواست. این
فایل باید حاوی کلیدی با همان قالبی باشد که توسط گزینه \fB\-y\fP پذیرفته می‌شود.
.TP
\fB\-d\fP, \fB\-\-debug\fP
فعال‌سازی پیام‌های اشکال‌زدایی (دیباگ).
.TP
\fB\-h\fP, \fB\-\-help\fP
چاپ راهنمای برنامه.
.TP
\fB\-V\fP, \fB\-\-version\fP
چاپ نسخه برنامه. گزینه \fB\-VV\fP خلاصه پیکربندی زمان کامپایل برنامه را چاپ می‌کند.
.UNINDENT
.SS "گزینه‌های QUIC/TLS"
.INDENT 0.0
.TP
\fB\-H\fP, \fB\-\-hostname\fP \fIstring\fP
فعال‌سازی اعتبارسنجی نام میزبان کارساز دوردست.
.TP
\fB\-P\fP, \fB\-\-pin\fP \fIbase64\fP
استفاده از نمایه حریم خصوصی پین کلید خارج از باند (RFC 7858#section\-4.2). مقدار
PIN باید یک هش SHA\-256 کدگذاری‌شده در Base64 از X.509 SubjectPublicKeyInfo باشد.
می‌تواند چند بار مشخص شود.
.TP
\fB\-A\fP, \fB\-\-ca\fP [\fIpath\fP]
فعال‌سازی اعتبارسنجی گواهی. گواهی‌های مرجع صدور گواهی (CA) از فایل PEM مشخص‌شده
بارگذاری می‌شوند (در صورت عدم ارائه آرگومان، پیش‌فرض مخزن گواهی سیستم است).
می‌تواند چند بار مشخص شود.
.TP
\fB\-E\fP, \fB\-\-certfile\fP \fIpath\fP
مسیر فایل گواهی کلاینت.
.TP
\fB\-K\fP, \fB\-\-keyfile\fP \fIpath\fP
مسیر فایل کلید کلاینت.
.TP
\fB\-s\fP, \fB\-\-sni\fP \fIstring\fP
استفاده از نشانگر نام کارساز (SNI) مشخص‌شده.
.UNINDENT
.SS "دستورها (Commands)"
.INDENT 0.0
.TP
\fBserver\fP \fIname\fP [\fIport\fP]
کارساز دریافت‌کننده پیام به‌روزرسانی پویا را مشخص می‌کند. پارامتر \fIname\fP می‌تواند
یک نام میزبان یا یک نشانی IP باشد. اگر \fIport\fP مشخص نشود، درگاه پیش‌فرض استفاده
می‌شود. مقدار درگاه پیش‌فرض را می‌توان با استفاده از گزینه \fB\-p\fP برنامه کنترل کرد.
.TP
\fBlocal\fP \fIaddress\fP [\fIport\fP]
نشانی و درگاه خروجی (\fIaddress\fP و \fIport\fP) را مشخص می‌کند. در صورت عدم تعیین،
نشانی و درگاه به طور خودکار توسط سیستم تنظیم می‌شوند. شماره درگاه پیش‌فرض ۰ است.
.TP
\fBzone\fP \fIname\fP
مشخص می‌کند که تمام به‌روزرسانی‌ها در محدوده منطقه \fIname\fP انجام شوند. نام منطقه
مقدار پیش‌فرض ندارد و باید صراحتاً تنظیم شود.
.TP
\fBorigin\fP \fIname\fP
پسوند نام دامنه کاملاً معتبر (FQDN) را تعیین می‌کند که به مالکان غیر FQDN در
دستورهای به‌روزرسانی افزوده می‌شود. پیش‌فرض برچسب پایانی (\fB\&.\fP) است.
.TP
\fBclass\fP \fIname\fP
مقدار \fIname\fP را به عنوان کلاس پیش‌فرض برای همه به‌روزرسانی‌ها تنظیم می‌کند. در
صورت عدم استفاده، کلاس پیش‌فرض IN است.
.TP
\fBttl\fP \fIvalue\fP
مقدار \fIvalue\fP را به عنوان TTL پیش‌فرض (بر حسب ثانیه) تنظیم می‌کند. در صورت عدم
استفاده، مقدار پیش‌فرض ۳۶۰۰ است.
.TP
\fBkey\fP [\fIalg\fP:]\fIname\fP \fIkey\fP
کلید TSIG به نام \fIname\fP را برای احراز اصالت درخواست مشخص می‌کند. الگوریتم
اختیاری \fIalg\fP نیز قابل تعیین است. این دستور اثری مشابه گزینه \fB\-y\fP برنامه دارد.
.TP
[\fBprereq\fP] \fBnxdomain\fP \fIname\fP
یک پیش‌شرط برای عدم وجود رکورد متعلق به \fIname\fP اضافه می‌کند.
.TP
[\fBprereq\fP] \fByxdomain\fP \fIname\fP
یک پیش‌شرط برای وجود داشتن رکورد متعلق به \fIname\fP اضافه می‌کند.
.TP
[\fBprereq\fP] \fBnxrrset\fP \fIname\fP [\fIclass\fP] \fItype\fP
یک پیش‌شرط برای عدم وجود رکوردی از نوع \fItype\fP متعلق به \fIname\fP اضافه می‌کند.
کلاس اینترنت (\fIclass\fP برابر IN) مورد انتظار است.
.TP
[\fBprereq\fP] \fByxrrset\fP \fIname\fP [\fIclass\fP] \fItype\fP [\fIdata\fP]
یک پیش‌شرط برای وجود داشتن رکوردی از نوع \fItype\fP متعلق به \fIname\fP با داده‌های
اختیاری \fIdata\fP اضافه می‌کند. کلاس اینترنت مورد انتظار است.
.TP
[\fBupdate\fP] \fBadd\fP \fIname\fP [\fIttl\fP] [\fIclass\fP] \fItype\fP \fIdata\fP
درخواستی برای افزودن یک رکورد منبع جدید به منطقه اضافه می‌کند. لطفاً توجه داشته
باشید که اگر \fIname\fP یک نام دامنه کاملاً معتبر نباشد، نام مبدأ (origin) فعلی به
انتهای آن افزوده می‌شود.
.TP
[\fBupdate\fP] \fBdel\fP[\fBete\fP] \fIname\fP [\fIttl\fP] [\fIclass\fP] [\fItype\fP] [\fIdata\fP]
درخواستی برای حذف تمام رکوردهای منبع (یا رکوردهای منطبق با \fIclass\fP، \fItype\fP یا \fIdata\fP)
از منطقه اضافه می‌کند. الزامات مربوط به پارامتر \fIname\fP مانند دستور \fBupdate add\fP
است. مقدار \fIttl\fP نادیده گرفته می‌شود.
.TP
\fBshow\fP
محتوای فعلی پیام به‌روزرسانی را نمایش می‌دهد.
.TP
\fBsend\fP
پیام به‌روزرسانی فعلی را ارسال کرده و فهرست به‌روزرسانی‌ها را پاک می‌کند.
.TP
\fBanswer\fP
آخرین پاسخ دریافتی از کارساز را نمایش می‌دهد.
.TP
\fBdebug\fP
اشکال‌زدایی را فعال می‌کند. این دستور مفهومی مشابه گزینه \fB\-d\fP برنامه دارد.
.TP
\fBexit\fP
خروج از برنامه.
.UNINDENT
.SH "نکات (NOTES)"
.sp
گزینه‌های \fB\-k\fP و \fB\-y\fP نمی‌توانند به طور همزمان استفاده شوند.
.sp
هیچ‌یک از قالب‌های فایل کلید \fItsig\-keygen(8)\fP یا \fIdnssec\-keygen(1)\fP پشتیبانی
نمی‌شوند. از \fBkeymgr(8)\fP برای ایجاد رشته مناسب برای \fB\-y\fP یا فایل ارائه‌شده
به \fB\-k\fP استفاده کنید.
.sp
در صورتی که نام منطقه یا کارساز مشخص نشده باشد، حدس زدن خودکار نام منطقه/کارساز
پشتیبانی نمی‌شود.
.sp
خط خالی باعث ارسال به‌روزرسانی نمی‌شود.
.SS "حالت تعاملی (Interactive mode)"
.sp
این ابزار یک حالت تعاملی با قابلیت‌های اولیه ویرایش خط، تکمیل خودکار دستور و تاریخچه
دستورها فراهم می‌کند.
.sp
رفتار حالت تعاملی را می‌توان در \fI~/.editrc\fP سفارشی کرد. برای جزئیات به \fBeditrc(5)\fP
مراجعه کنید.
.sp
تاریخچه دستورها در \fI~/.knsupdate_history\fP ذخیره می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
کد خروج ۰ نشان‌دهنده موفقیت عملیات است. هر کد خروج دیگری بیانگر وقوع خطا است.
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.IP 1. 3
ارسال یک به‌روزرسانی از منطقه example.com به کارساز 192.168.1.1. این به‌روزرسانی
شامل دو رکورد جدید است:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ knsupdate
knsupdate> server 192.168.1.1
knsupdate> zone example.com.
knsupdate> origin example.com.
knsupdate> ttl 3600
knsupdate> add test1.example.com. 7200 A 192.168.2.2
knsupdate> add test2 TXT \(dqhello\(dq
knsupdate> show
knsupdate> send
knsupdate> answer
knsupdate> exit
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBkdig(1)\fP, \fBkhost(1)\fP, \fBkeymgr(8)\fP, \fBeditrc(5)\fP\&.
.SH "نویسندگان (AUTHORS)"
CZ.NIC, z.s.p.o. و مشارکت‌کنندگان <https://www.knot-dns.cz>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright (C) CZ.NIC, z.s.p.o. and contributors
.\" End of generated man page.