.\" 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 "KDIG" "1" "2026-06-12" "3.5.5" "Knot DNS" .SH "نام (NAME)" kdig \- ابزار پیشرفته پرس‌وجوی DNS .SH "خلاصه دستور (SYNOPSIS)" .sp \fBkdig\fP [\fIتنظیمات\-عمومی\fP] [\fIپرس‌وجو\fP [\fIتنظیمات\fP]]... .sp \fBkdig\fP \fB\-h\fP .SH "توضیحات (DESCRIPTION)" .sp این ابزار یک یا چند پرس‌وجوی DNS را به یک سرویس‌دهنده نام ارسال می‌کند. هر پرس‌وجو می‌تواند دارای \fIتنظیمات\fP جداگانه باشد، یا به‌صورت سراسری از طریق \fIتنظیمات\-عمومی\fP مشخص شود که باید پیش از تعیین \fIپرس‌وجو\fP قرار گیرد. .SS پارامترها .INDENT 0.0 .TP .B \fIپرس‌وجو\fP \fIname\fP | \fB\-q\fP \fIname\fP | \fB\-x\fP \fIaddress\fP | \fB\-G\fP \fItapfile\fP .TP .B \fIتنظیمات\-عمومی\fP, \fIتنظیمات\fP [\fIquery_class\fP] [\fIquery_type\fP] [\fB@\fP\fIserver\fP]... [\fIگزینه‌ها\fP] .TP .B \fIname\fP نام دامنه‌ای است که باید جستجو شود. .TP .B \fIserver\fP نام دامنه یا یک نشانی IPv4 یا IPv6 از سرویس‌دهنده نام است که پرس‌وجو به آن ارسال می‌شود. یک پورت اضافی را می‌توان با استفاده از ساختار address:port (برای نشانی IPv6 به‌صورت [address]:port)، address@port یا address#port مشخص کرد. مقداری که با نویسه «/» آغاز شود، به‌عنوان یک مسیر مطلق سوکت یونیکس (UNIX socket) در نظر گرفته می‌شود. اگر هیچ سرویس‌دهنده‌ای مشخص نشود، از سرویس‌دهنده‌های موجود در \fB/etc/resolv.conf\fP استفاده می‌شود. .UNINDENT .sp اگر هیچ آرگومانی ارائه نشود، \fBkdig\fP یک پرس‌وجوی NS برای ناحیه ریشه (root zone) ارسال می‌کند. .SS کلاس‌های پرس‌وجو .sp یک \fIquery_class\fP می‌تواند نام کلاس DNS (مانند IN، CH) یا مشخصه کلاس عمومی \fBCLASS\fP\fIXXXXX\fP باشد که در آن \fIXXXXX\fP شماره کلاس ده‌دهی متناظر است. کلاس پیش‌فرض پرس‌وجو IN است. .SS انواع پرس‌وجو .sp یک \fIquery_type\fP می‌تواند نوع رکورد منبع DNS (مانند A، AAAA، NS، SOA، DNSKEY، ANY و غیره) یا یکی از موارد زیر باشد: .INDENT 0.0 .TP \fBTYPE\fP\fIXXXXX\fP مشخصه نوع پرس‌وجوی عمومی که در آن \fIXXXXX\fP شماره نوع ده‌دهی متناظر است. .TP \fBAXFR\fP درخواست انتقال کامل ناحیه (Full zone transfer). .TP \fBIXFR=\fP\fIserial\fP درخواست انتقال افزایشی ناحیه (Incremental zone transfer) برای شماره سریال SOA مشخص‌شده (یعنی تمام به‌روزرسانی‌های ناحیه از نسخه مشخص‌شده بازگردانده می‌شوند). .TP \fBNOTIFY=\fP\fIserial\fP پیام اعلان (Notify) با مشخص بودن راهنمای شماره سریال SOA. .TP \fBNOTIFY\fP پیام اعلان (Notify) بدون مشخص بودن راهنمای شماره سریال SOA. .UNINDENT .sp نوع پیش‌فرض پرس‌وجو A است. .SS گزینه‌ها .INDENT 0.0 .TP \fB\-4\fP فقط از پروتکل IPv4 استفاده می‌کند. .TP \fB\-6\fP فقط از پروتکل IPv6 استفاده می‌کند. .TP \fB\-b\fP \fIaddress\fP نشانی IP مبدأ پرس‌وجو را روی \fIaddress\fP تنظیم می‌کند. نشانی باید یک نشانی معتبر برای رابط محلی یا :: یا 0.0.0.0 باشد. یک پورت اختیاری را می‌توان در همان قالب مقدار \fIserver\fP مشخص کرد. .TP \fB\-c\fP \fIclass\fP مشخص کردن صریح \fIquery_class\fP. مقادیر ممکن را در بالا ببینید. .TP \fB\-d\fP فعال‌سازی پیام‌های اشکال‌زدایی (Debug). .TP \fB\-dd\fP فعال‌سازی پیام‌های اشکال‌زدایی با جزئیات بیشتر (چاپ Subject Alternative Name). .TP \fB\-h\fP, \fB\-\-help\fP چاپ راهنمای برنامه. .TP \fB\-k\fP \fIkeyfile\fP استفاده از کلید TSIG ذخیره‌شده در پرونده \fIkeyfile\fP برای احراز هویت درخواست. پرونده باید حاوی کلید با همان قالبی باشد که توسط گزینه \fB\-y\fP پذیرفته می‌شود. .TP \fB\-p\fP \fIport\fP تنظیم شماره پورت یا نام سرویس سرویس‌دهنده نام برای ارسال پرس‌وجو به آن. پورت پیش‌فرض 53 است. .TP \fB\-q\fP \fIname\fP تنظیم نام پرس‌وجو. یک حالت صریح برای تعیین \fIname\fP. اگر هیچ \fIname\fP ارائه نشود، بخش پرسش (question section) خالی تنظیم می‌شود. .TP \fB\-t\fP \fItype\fP مشخص کردن صریح \fIquery_type\fP. مقادیر ممکن را در بالا ببینید. .TP \fB\-V\fP, \fB\-\-version\fP چاپ نسخه برنامه. گزینه \fB\-VV\fP باعث می‌شود برنامه خلاصه پیکربندی زمان کامپایل را چاپ کند. .TP \fB\-x\fP \fIaddress\fP ارسال یک پرس‌وجوی معکوس (PTR) برای نشانی IPv4 یا IPv6 \fIaddress\fP. نام، کلاس و نوع صحیح به‌طور خودکار تنظیم می‌شوند. .TP \fB\-y\fP [\fIalg\fP:]\fIname\fP:\fIkey\fP استفاده از کلید TSIG با نام \fIname\fP برای احراز هویت درخواست. بخش \fIalg\fP الگوریتم را مشخص می‌کند (پیش‌فرض hmac\-sha256 است) و \fIkey\fP راز مشترک کدگذاری‌شده با Base64 را مشخص می‌کند. .TP \fB\-E\fP \fItapfile\fP برون‌بری ردگیری dnstap پیام‌های پرس‌وجو و پاسخ دریافت شده به پرونده \fItapfile\fP. .TP \fB\-G\fP \fItapfile\fP تولید خروجی پیام از پرونده dnstap ذخیره‌شده قبلی \fItapfile\fP. .TP \fB+\fP[\fBno\fP]\fBmultiline\fP شکستن رکوردهای طولانی به چندین خط و بهبود خوانایی برای انسان. .TP \fB+\fP[\fBno\fP]\fBshort\fP فقط نمایش داده‌های رکورد. .TP \fB+\fP[\fBno\fP]\fBgeneric\fP استفاده از قالب نمایش عمومی هنگام چاپ انواع و داده‌های رکوردهای منبع. .TP \fB+\fP[\fBno\fP]\fBcrypto\fP نمایش مقادیر کلیدها و امضاهای DNSSEC به‌صورت base64 به‌جای حذف آن‌ها. (*) .TP \fB+\fP[\fBno\fP]\fBaaflag\fP تنظیم فلگ AA. .TP \fB+\fP[\fBno\fP]\fBtcflag\fP تنظیم فلگ TC. .TP \fB+\fP[\fBno\fP]\fBrdflag\fP تنظیم فلگ RD. (*) .TP \fB+\fP[\fBno\fP]\fBrecurse\fP همانند \fB+\fP[\fBno\fP]\fBrdflag\fP .TP \fB+\fP[\fBno\fP]\fBraflag\fP تنظیم فلگ RA. .TP \fB+\fP[\fBno\fP]\fBzflag\fP تنظیم بیت فلگ صفر. .TP \fB+\fP[\fBno\fP]\fBadflag\fP تنظیم فلگ AD. (*) .TP \fB+\fP[\fBno\fP]\fBcdflag\fP تنظیم فلگ CD. .TP \fB+\fP[\fBno\fP]\fBdoflag\fP تنظیم فلگ DO. .TP \fB+\fP[\fBno\fP]\fBdnssec\fP همانند \fB+\fP[\fBno\fP]\fBdoflag\fP .TP \fB+\fP[\fBno\fP]\fBall\fP نمایش تمام بخش‌های بسته. .TP \fB+\fP[\fBno\fP]\fBqr\fP نمایش بسته پرس‌وجو. .TP \fB+\fP[\fBno\fP]\fBheader\fP نمایش سرآیند بسته. (*) .TP \fB+\fP[\fBno\fP]\fBcomments\fP نمایش نام بخش‌های توضیح‌دار. (*) .TP \fB+\fP[\fBno\fP]\fBopt\fP نمایش بخش شبه‌رکورد EDNS. (*) .TP \fB+\fP[\fBno\fP]\fBopttext\fP تلاش برای نمایش گزینه‌های ناشناخته EDNS به‌صورت متن. .TP \fB+\fP[\fBno\fP]\fBoptpresent\fP نمایش EDNS در قالب نمایشی بر اساس مشخصات نسخه draft\-peltan\-edns\-presentation\-format\-01 \%. .TP \fB+\fP[\fBno\fP]\fBquestion\fP نمایش بخش پرسش (Question). (*) .TP \fB+\fP[\fBno\fP]\fBanswer\fP نمایش بخش پاسخ (Answer). (*) .TP \fB+\fP[\fBno\fP]\fBauthority\fP نمایش بخش مرجعیت (Authority). (*) .TP \fB+\fP[\fBno\fP]\fBadditional\fP نمایش بخش اضافی (Additional). (*) .TP \fB+\fP[\fBno\fP]\fBtsig\fP نمایش بخش شبه‌رکورد TSIG. (*) .TP \fB+\fP[\fBno\fP]\fBstats\fP نمایش آمارهای پایانی بسته. (*) .TP \fB+\fP[\fBno\fP]\fBclass\fP نمایش کلاس DNS. (*) .TP \fB+\fP[\fBno\fP]\fBttl\fP نمایش مقدار TTL. (*) .TP \fB+\fP[\fBno\fP]\fBtcp\fP استفاده از پروتکل TCP (پیش‌فرض برای پرس‌وجوی استاندارد UDP و برای AXFR/IXFR پروتکل TCP است). .TP \fB+\fP[\fBno\fP]\fBfastopen\fP استفاده از TCP Fast Open. .TP \fB+\fP[\fBno\fP]\fBignore\fP عدم استفاده خودکار از TCP در صورت دریافت پاسخ بریده‌شده (Truncated). .TP \fB+\fP[\fBno\fP]\fBkeepopen\fP باز نگه داشتن اتصال TCP برای پرس‌وجوی بعدی در صورت یکسان بودن پیکربندی اتصال. این مورد برای عملیات‌های +tcp، +tls، +https و +quic اعمال می‌شود. اتصال فقط در چارچوب یک فراخوانی kdig در نظر گرفته می‌شود. .TP \fB+\fP[\fBno\fP]\fBtls\fP استفاده از TLS با نمایه حریم خصوصی فرصت‌طلبانه (\fBRFC 7858 Section 4.1\fP \%). .TP \fB+\fP[\fBno\fP]\fBtls\-ca\fP[=\fIFILE\fP] استفاده از TLS با اعتبارسنجی گواهی. گواهی‌های مرجع صدور گواهی (CA) از پرونده PEM مشخص‌شده بارگیری می‌شوند (در صورت عدم ارائه آرگومان، پیش‌فرض مخزن گواهی‌های سیستم است). می‌تواند چندین بار مشخص شود. اگر گزینه +tls\-hostname ارائه نشود، از نام سرویس‌دهنده مقصد (در صورت تعیین) برای احراز هویت سخت‌گیرانه استفاده می‌شود. .TP \fB+\fP[\fBno\fP]\fBtls\-pin\fP=\fIBASE64\fP استفاده از TLS با نمایه حریم خصوصی کلید پین‌شده برون‌باند (\fBRFC 7858 Section 4.2\fP \%). مقدار PIN باید یک هش SHA\-256 کدگذاری‌شده با Base64 از X.509 SubjectPublicKeyInfo باشد. می‌تواند چندین بار مشخص شود. .TP \fB+\fP[\fBno\fP]\fBtls\-hostname\fP=\fISTR\fP استفاده از TLS با بررسی نام هاست سرویس‌دهنده راه دور. .TP \fB+\fP[\fBno\fP]\fBtls\-sni\fP=\fISTR\fP استفاده از TLS با شناسه نام سرور (Server Name Indication). .TP \fB+\fP[\fBno\fP]\fBtls\-keyfile\fP=\fIFILE\fP استفاده از TLS با پرونده کلید کلاینت. .TP \fB+\fP[\fBno\fP]\fBtls\-certfile\fP=\fIFILE\fP استفاده از TLS با پرونده گواهی کلاینت. .TP \fB+\fP[\fBno\fP]\fBtls\-ocsp\-stapling\fP[=\fIH\fP] استفاده از TLS با پاسخ منگنه‌شده معتبر OCSP برای گواهی سرور (%u یا تعیین ساعت). پاسخ‌های OCSP قدیمی‌تر از مدت مشخص‌شده نامعتبر تلقی می‌شوند. .TP \fB+\fP[\fBno\fP]\fBhttps\fP[=\fIURL\fP] استفاده از HTTPS (DNS\-over\-HTTPS) در قالب سیمی (\fBRFC 1035 Section 4.2.1\fP \%). همچنین امکان تعیین URL=[authority][/path] که درخواست به آن ارسال خواهد شد وجود دارد. هرگونه طرح و نشانگر مرجعیت ابتدایی (مانند //) نادیده گرفته می‌شود. مرجعیت همچنین می‌تواند به‌عنوان \fIserver\fP (با استفاده از پارامتر \fI@\fP) مشخص شود. اگر \fIpath\fP مشخص شده و \fIauthority\fP وجود نداشته باشد، از \fIserver\fP به‌عنوان مرجعیت به همراه \fIpath\fP مشخص‌شده استفاده می‌شود. کتابخانه \fIlibnghttp2\fP مورد نیاز است. .TP \fB+\fP[\fBno\fP]\fBhttps\-get\fP استفاده از HTTPS با متد HTTP/GET به‌جای متد پیش‌فرض HTTP/POST. کتابخانه \fIlibnghttp2\fP مورد نیاز است. .TP \fB+\fP[\fBno\fP]\fBquic\fP استفاده از QUIC (DNS\-over\-QUIC). .TP \fB+\fP[\fBno\fP]\fBnsid\fP درخواست شناسه سرویس‌دهنده نام (NSID). .TP \fB+\fP[\fBno\fP]\fBzoneversion\fP درخواست نسخه ناحیه EDNS (EDNS zone version). .TP \fB+\fP[\fBno\fP]\fBbufsize\fP=\fIB\fP تنظیم اندازه بافر EDNS به بایت (پیش‌فرض 1232 بایت است). .TP \fB+\fP[\fBno\fP]\fBpadding\fP[=\fIB\fP] استفاده از گزینه لایه پرکننده EDNS(0) برای پر کردن پرس‌وجوها، به‌صورت اختیاری تا اندازه‌ای مشخص. پیش‌فرض این است که هنگام استفاده از +tls پرس‌وجوها به میزان معقولی پر شوند، و وقتی پرس‌وجوها بدون TLS ارسال می‌شوند اصلاً پر نشوند. بدون آرگومان (یعنی صرفاً +padding) هر پرس‌وجو بدون در نظر گرفتن استفاده از TLS به میزان معقولی پر می‌شود. با +nopadding، هرگز پر نمی‌شود. .TP \fB+\fP[\fBno\fP]\fBalignment\fP[=\fIB\fP] تراز کردن پرس‌وجو با پیام بلوک B\-بایتی با استفاده از گزینه لایه پرکننده EDNS(0) (پیش‌فرض no است یا در صورت عدم تعیین آرگومان 128). .TP \fB+\fP[\fBno\fP]\fBsubnet\fP=\fISUBN\fP تنظیم زیرشبکه کلاینت در EDNS(0) به‌صورت SUBN=addr/prefix. .TP \fB+\fP[\fBno\fP]\fBedns\fP[=\fIN\fP] استفاده از نسخه EDNS (پیش‌فرض 0 است). .TP \fB+\fP[\fBno\fP]\fBmsgdelay\fP=\fIT\fP صبر کردن به تعداد میلی‌ثانیه مشخص پیش از دریافت هر پیام AXFR/IXFR. .TP \fB+\fP[\fBno\fP]\fBtimeout\fP=\fIT\fP تنظیم بازه زمانی انتظار برای پاسخ به ثانیه (پیش‌فرض 5 ثانیه است). این مهلت زمانی برای هر تلاش پرس‌وجو اعمال می‌شود. مقدار صفر یا \fInotimeout\fP به‌صورت نامحدود تفسیر می‌شود. .TP \fB+\fP[\fBno\fP]\fBretry\fP=\fIN\fP تنظیم تعداد تکرار مجدد UDP (>=0) (پیش‌فرض 2 است). این مورد برای AXFR/IXFR اعمال نمی‌شود. .TP \fB+\fP[\fBno\fP]\fBexpire\fP تنظیم گزینه EXPIRE در EDNS. .TP \fB+\fP[\fBno\fP]\fBcookie\fP[=\fIHEX\fP] پیوست کردن کوکی EDNS(0) به پرس‌وجو. .TP \fB+\fP[\fBno\fP]\fBbadcookie\fP تکرار پرس‌وجو با کوکی صحیح. .TP \fB+\fP[\fBno\fP]\fBednsopt\fP[=\fICODE\fP[:\fIHEX\fP]] ارسال گزینه سفارشی EDNS. مقدار \fICODE\fP کد گزینه EDNS به‌صورت ده‌دهی است و \fIHEX\fP یک رشته هگزادسیمال اختیاری برای مقدار گزینه EDNS است. این آرگومان می‌تواند چندین بار استفاده شود. گزینه +noednsopt تمام گزینه‌های EDNS مشخص‌شده با +ednsopt را پاک می‌کند. .TP \fB+\fP[\fBno\fP]\fBproxy\fP=\fISRC_ADDR\fP[#\fISRC_PORT\fP]\-\fIDST_ADDR\fP[#\fIDST_PORT\fP] افزودن سرآیند PROXYv2 با نشانی‌های مبدأ و مقصد مشخص‌شده به پرس‌وجو. پورت مبدأ پیش‌فرض 0 و پورت مقصد 53 است. .TP \fB+\fP[\fBno\fP]\fBjson\fP استفاده از JSON برای کدگذاری خروجی (RFC 8427). .TP \fB+noidn\fP غیرفعال‌سازی تبدیل IDN به ASCII و برعکس. پشتیبانی از IDN به وجود libidn2 هنگام ساخت پروژه بستگی دارد! در صورت استفاده در \fIتنظیمات\-عمومی\fP، تمام تبدیل‌های IDN غیرفعال می‌شوند. در صورت استفاده در \fIتنظیمات\fP هر پرس‌وجو، تبدیل از ASCII در خروجی برای آن پرس‌وجوی خاص غیرفعال می‌شود. توجه داشته باشید که تبدیل IDN بزرگی و کوچکی حروف نام دامنه را حفظ نمی‌کند. .UNINDENT .SH "نکات (NOTES)" .sp به‌طور پیش‌فرض، فقط گزینه‌های مشخص‌شده با (*) فعال هستند. .sp گزینه‌های \fB\-k\fP و \fB\-y\fP نمی‌توانند به‌طور هم‌زمان استفاده شوند. .sp قالب پرونده کلید Dnssec\-keygen پشتیبانی نمی‌شود. به‌جای آن از \fBkeymgr(8)\fP استفاده کنید. .SH "کدهای خروج (EXIT VALUES)" .sp وضعیت خروج 0 به معنای اجرای موفقیت‌آمیز است. هر وضعیت خروج دیگر نشان‌دهنده بروز خطا است. .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .IP 1. 3 دریافت رکوردهای A برای example.com: .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig example.com A .EE .UNINDENT .UNINDENT .IP 2. 3 اجرای AXFR برای ناحیه example.com از سرویس‌دهنده 192.0.2.1: .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig example.com \-t AXFR @192.0.2.1 .EE .UNINDENT .UNINDENT .IP 3. 3 دریافت رکوردهای A برای example.com از 192.0.2.1 و جستجوی معکوس برای نشانی 2001:DB8::1 از 192.0.2.2. هر دو با استفاده از پروتکل TCP: .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig +tcp example.com \-t A @192.0.2.1 \-x 2001:DB8::1 @192.0.2.2 .EE .UNINDENT .UNINDENT .IP 4. 3 دریافت رکورد SOA برای example.com، استفاده از TLS، استفاده از گواهی‌های سیستم، بررسی نام هاست مشخص‌شده، بررسی پین گواهی و چاپ اطلاعات اشکال‌زدایی بیشتر: .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig \-d @185.49.141.38 +tls\-ca +tls\-host=getdnsapi.net \e +tls\-pin=foxZRnIh9gZpWnl+zEiKa0EJ2rdCGroMWm02gaxSc9S= soa example.com .EE .UNINDENT .UNINDENT .IP 5. 3 نمونه‌های DNS بر بستر HTTPS (پیاده‌سازی‌های مختلف DoH): .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig @1.1.1.1 +https example.com. $ kdig @193.17.47.1 +https=/doh example.com. $ kdig @8.8.4.4 +https +https\-get example.com. $ kdig @8.8.8.8 +https +tls\-hostname=dns.google +fastopen example.com. .EE .UNINDENT .UNINDENT .IP 6. 3 اشتراک چند پرس‌وجو در یک اتصال DoT: .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig @1.1.1.1 +tls +keepopen abc.example.com A mail.example.com AAAA .EE .UNINDENT .UNINDENT .IP 7. 3 پرس‌وجوی شناسه و نسخه سرویس‌دهنده نام مطابق با \fBRFC 4892\fP \%: .INDENT 3.0 .INDENT 3.5 .sp .EX $ kdig @a.iana\-servers.net. CH TXT id.server version.server .EE .UNINDENT .UNINDENT .UNINDENT .SH "فایل‌ها (FILES)" .sp \fB/etc/resolv.conf\fP .SH "همچنین ببینید (SEE ALSO)" .sp \fBkhost(1)\fP, \fBknsupdate(1)\fP, \fBkeymgr(8)\fP\&. .SH "نویسنده (AUTHOR)" CZ.NIC, z.s.p.o. و مشارکت‌کنندگان .SH "حق نشر (COPYRIGHT)" Copyright (C) CZ.NIC, z.s.p.o. and contributors .\" End of generated man page.