.\" 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 "MDIG" "1" "2026-08-19" "9.20.27" "BIND 9" .SH "نام (NAME)" mdig \- ابزار پیشرفته پرس‌وجوی همزمان و چندگانه DNS .SH "خلاصه دستور (SYNOPSIS)" .sp \fBmdig\fP \%<{@\:server>} [\fB\-f\fP filename] [\fB\-h\fP] [\fB\-v\fP] [ [\fB\-4\fP] | [\fB\-6\fP] ] [\fB\-m\fP] [\fB\-b\fP address] [\fB\-p\fP port#] [\fB\-c\fP class] [\fB\-t\fP type] [\fB\-i\fP] [\fB\-x\fP addr] [plusopt...] .sp \fBmdig\fP {\fB\-h\fP} .sp \fBmdig\fP [@server] {global\-opt...} { {local\-opt...} {query} ...} .SH "توضیحات (DESCRIPTION)" .sp دستور \fBmdig\fP نسخه‌ای از \fBdig\fP \%<#\:std-iscman-dig> برای ارسال چندگانه/خط‌لوله‌ای (pipelined) پرسمان‌ها است: به جای این‌که پس از ارسال هر پرس‌وجو منتظر پاسخ بماند، در ابتدا تمام پرس‌وجوها را ارسال می‌کند. پاسخ‌ها به ترتیبی که دریافت می‌شوند نمایش داده می‌شوند، نه بر اساس ترتیبی که پرسمان‌های مربوطه ارسال شده‌اند. .sp گزینه‌های \fBmdig\fP زیرمجموعه‌ای از گزینه‌های \fBdig\fP \%<#\:std-iscman-dig> هستند و به «گزینه‌های در هر مکان» (که می‌توانند در هر جای خط فرمان ظاهر شوند)، «گزینه‌های سراسری» (که باید قبل از نام پرسمان قرار گیرند وگرنه با نمایش یک هشدار نادیده گرفته می‌شوند) و «گزینه‌های محلی» (که برای پرس‌وجوی بعدی در خط فرمان اعمال می‌شوند) تقسیم می‌گردند. .sp گزینه \fB@server\fP یک گزینه سراسری الزامی است. این گزینه نام یا آدرس IP کارساز نامی است که باید از آن پرس‌وجو شود. (برخلاف \fBdig\fP \%<#\:std-iscman-dig>، این مقدار از \fB/etc/resolv.conf\fP\& خوانده نمی‌شود.) این مقدار می‌تواند یک آدرس IPv4 با تفکیک نقطه (dotted\-decimal)، یک آدرس IPv6 با تفکیک دو‌نقطه (colon\-delimited) یا یک نام میزبان باشد. هنگامی که آرگومان \fBserver\fP داده‌شده یک نام میزبان است، \fBmdig\fP قبل از ارسال پرسمان به کارساز نام، ابتدا آن نام را تفکیک می‌کند. .sp دستور \fBmdig\fP تعدادی گزینه پرسمان ارائه می‌دهد که بر نحوه انجام جستجوها و نمایش نتایج تأثیر می‌گذارند. برخی از این گزینه‌ها بیت‌های پرچم را در سرآیند پرسمان تنظیم یا بازنشانی می‌کنند، برخی دیگر مشخص می‌کنند کدام بخش‌های پاسخ چاپ شوند، و موارد دیگر راهبردهای مهلت زمانی (timeout) و تلاش مجدد (retry) را تعیین می‌نمایند. .sp هر گزینه پرسمان با یک کلمه کلیدی که با یک علامت مثبت (\fB+\fP) شروع می‌شود، مشخص می‌گردد. برخی کلمات کلیدی یک گزینه را فعال یا غیرفعال می‌کنند. این گزینه‌ها می‌توانند با رشته \fBno\fP پیشوندگذاری شوند تا معنای آن کلمه کلیدی نفی شود. کلمات کلیدی دیگر مقادیری را به گزینه‌ها اختصاص می‌دهند (مانند فاصله زمانی مهلت انتظار). این گزینه‌ها دارای قالب \fB+keyword=value\fP\& هستند. .SH "گزینه‌های در هر مکان (ANYWHERE OPTIONS)" .INDENT 0.0 .TP .B \-f این گزینه باعث می‌شود \fBmdig\fP با خواندن فهرستی از درخواست‌های جستجو برای پردازش از فایل \fBfilename\fP\& در حالت دسته‌ای (batch mode) کار کند. این فایل حاوی تعدادی پرسمان است، هر پرسمان در یک خط. هر مدخل در فایل باید به همان روشی سازمان‌دهی شود که پرسمان‌ها در رابط خط فرمان به \fBmdig\fP ارائه می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-h این گزینه باعث می‌شود \fBmdig\fP اطلاعات راهنمای دقیق را به همراه فهرست کامل گزینه‌ها نمایش داده و خارج شود. .UNINDENT .INDENT 0.0 .TP .B \-v این گزینه باعث می‌شود \fBmdig\fP شماره نسخه را چاپ کرده و خارج شود. .UNINDENT .SH "گزینه‌های سراسری (GLOBAL OPTIONS)" .INDENT 0.0 .TP .B \-4 این گزینه \fBmdig\fP را وادار می‌کند که فقط از پروتکل انتقال پرسمان IPv4 استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-6 این گزینه \fBmdig\fP را وادار می‌کند که فقط از پروتکل انتقال پرسمان IPv6 استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-b address این گزینه آدرس IP مبدأ پرسمان را روی \fBaddress\fP\& تنظیم می‌کند. این مقدار باید یک آدرس معتبر روی یکی از رابط‌های شبکه میزبان یا \(dq0.0.0.0\(dq یا \(dq::\(dq باشد. یک درگاه (پورت) اختیاری را می‌توان با افزودن \(dq#\(dq مشخص کرد. .UNINDENT .INDENT 0.0 .TP .B \-m این گزینه اشکال‌زدایی مصرف حافظه را فعال می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-p port# این گزینه زمانی استفاده می‌شود که قرار است یک شماره پورت غیر استاندارد مورد پرس‌وجو قرار گیرد. شناسه \fBport#\fP شماره پورتی است که \fBmdig\fP پرسمان‌های خود را به جای پورت استاندارد DNS (شماره ۵۳) به آن ارسال می‌کند. این گزینه برای آزمایش کارساز نامی که برای گوش دادن به پرسمان‌ها روی یک شماره پورت غیر استاندارد پیکربندی شده است، استفاده می‌شود. .UNINDENT .sp گزینه‌های سراسری پرسمان عبارتند از: .INDENT 0.0 .TP .B +additional, +noadditional این گزینه بخش اضافی (additional) پاسخ را نمایش می‌دهد [یا نمایش نمی‌دهد]. حالت پیش‌فرض نمایش آن است. .UNINDENT .INDENT 0.0 .TP .B +all, +noall این گزینه تمام پرچم‌های نمایش را تنظیم یا پاک می‌کند. .UNINDENT .INDENT 0.0 .TP .B +answer, +noanswer این گزینه بخش پاسخ (answer) را نمایش می‌دهد [یا نمایش نمی‌دهد]. حالت پیش‌فرض نمایش آن است. .UNINDENT .INDENT 0.0 .TP .B +authority, +noauthority این گزینه بخش مرجعیت (authority) پاسخ را نمایش می‌دهد [یا نمایش نمی‌دهد]. حالت پیش‌فرض نمایش آن است. .UNINDENT .INDENT 0.0 .TP .B +besteffort, +nobesteffort این گزینه تلاش می‌کند محتوای پیام‌های ناقص و معیوب (malformed) را نمایش دهد [یا نمایش ندهد]. حالت پیش‌فرض نمایش ندادن پاسخ‌های معیوب است. .UNINDENT .INDENT 0.0 .TP .B +burst این گزینه ارسال پرسمان‌ها را تا شروع ثانیه بعدی به تعویق می‌اندازد. .UNINDENT .INDENT 0.0 .TP .B +cl, +nocl این گزینه کلاس (CLASS) را هنگام چاپ رکورد نمایش می‌دهد [یا نمایش نمی‌دهد]. .UNINDENT .INDENT 0.0 .TP .B +comments, +nocomments این گزینه نمایش خطوط توضیحات (کامنت) را در خروجی تغییر می‌دهد. حالت پیش‌فرض چاپ توضیحات است. .UNINDENT .INDENT 0.0 .TP .B +continue, +nocontinue این گزینه ادامه عملیات در هنگام مواجهه با خطاها (مانند مهلت‌های زمانی) را فعال یا غیرفعال می‌کند. .UNINDENT .INDENT 0.0 .TP .B +crypto, +nocrypto این گزینه نمایش فیلدهای رمزنگاری در رکوردهای DNSSEC را فعال یا غیرفعال می‌کند. محتوای این فیلدها برای اشکال‌زدایی بیشتر خرابی‌های اعتبارسنجی DNSSEC غیرضروری است و حذف آن‌ها مشاهده خطاهای رایج را آسان‌تر می‌سازد. حالت پیش‌فرض نمایش این فیلدها است. در صورت حذف، با رشته \(dq[omitted]\(dq جایگزین می‌شوند؛ در مورد DNSKEY، شناسه کلید به عنوان جایگزین نمایش داده می‌شود، مانند \fB[ key id = value ]\fP\&. .UNINDENT .INDENT 0.0 .TP .B +multiline, +nomultiline این گزینه چاپ رکوردها، مانند رکوردهای SOA، را در قالبی چندخطی و مفصل همراه با توضیحات خوانا برای انسان تغییر می‌دهد. حالت پیش‌فرض چاپ هر رکورد در یک خط واحد است تا تجزیه ماشینی خروجی \fBmdig\fP تسهیل شود. .UNINDENT .INDENT 0.0 .TP .B +question, +noquestion این گزینه بخش پرسش (question) یک پرسمان را هنگام بازگشت پاسخ چاپ می‌کند [یا چاپ نمی‌کند]. حالت پیش‌فرض چاپ بخش پرسش به صورت یک کامنت است. .UNINDENT .INDENT 0.0 .TP .B +rrcomments, +norrcomments این گزینه نمایش توضیحات به ازای هر رکورد را در خروجی تغییر می‌دهد (برای مثال، اطلاعات کلید خوانا برای انسان درباره رکوردهای DNSKEY). حالت پیش‌فرض عدم چاپ توضیحات رکورد است مگر این‌که حالت چندخطی فعال باشد. .UNINDENT .INDENT 0.0 .TP .B +short, +noshort این گزینه یک پاسخ کوتاه و فشرده ارائه می‌دهد [یا ارائه نمی‌دهد]. حالت پیش‌فرض چاپ پاسخ در قالبی مفصل است. .UNINDENT .INDENT 0.0 .TP .B +split=W این گزینه فیلدهای طولانی با قالب هگزادسیمال یا base64 را در رکوردهای منبع به بخش‌های \fBW\fP کاراکتری تقسیم می‌کند (که در آن \fBW\fP به نزدیک‌ترین مضرب ۴ به بالا گرد می‌شود). گزینه \fB+nosplit\fP یا \fB+split=0\fP از تقسیم فیلدها جلوگیری می‌کند. مقدار پیش‌فرض ۵۶ کاراکتر است، یا ۴۴ کاراکتر هنگامی که حالت چندخطی فعال باشد. .UNINDENT .INDENT 0.0 .TP .B +tcp, +notcp این گزینه هنگام پرس‌وجو از کارسازهای نام از پروتکل TCP استفاده می‌کند [یا استفاده نمی‌کند]. رفتار پیش‌فرض استفاده از UDP است. .UNINDENT .INDENT 0.0 .TP .B +ttlid, +nottlid این گزینه زمان حیات (TTL) را هنگام چاپ رکورد نمایش می‌دهد [یا نمایش نمی‌دهد]. .UNINDENT .INDENT 0.0 .TP .B +ttlunits, +nottlunits این گزینه TTL را در واحدهای زمانی خوانا و کاربرپسند \(dqs\(dq (ثانیه)، \(dqm\(dq (دقیقه)، \(dqh\(dq (ساعت)، \(dqd\(dq (روز) و \(dqw\(dq (هفته) نمایش می‌دهد [یا نمایش نمی‌دهد]. این گزینه مستلزم فعال بودن +ttlid است. .UNINDENT .INDENT 0.0 .TP .B +vc, +novc این گزینه هنگام پرس‌وجو از کارسازهای نام از TCP استفاده می‌کند [یا استفاده نمی‌کند]. این نحو جایگزین برای \fB+tcp\fP جهت سازگاری با گذشته ارائه شده است. عبارت \fBvc\fP مخفف \(dqvirtual circuit\(dq (مدار مجازی) است. .UNINDENT .SH "گزینه‌های محلی (LOCAL OPTIONS)" .INDENT 0.0 .TP .B \-c class این گزینه کلاس پرسمان را روی \fBclass\fP\& تنظیم می‌کند. این می‌تواند هر کلاس پرسمان معتبری باشد که در BIND 9 پشتیبانی می‌شود. کلاس پرسمان پیش‌فرض \(dqIN\(dq است. .UNINDENT .INDENT 0.0 .TP .B \-t type این گزینه نوع پرسمان را روی \fBtype\fP\& تنظیم می‌کند. این می‌تواند هر نوع پرسمان معتبری باشد که در BIND 9 پشتیبانی می‌شود. نوع پرسمان پیش‌فرض \(dqA\(dq است، مگر اینکه گزینه \fB\-x\fP برای مشخص کردن یک جستجوی معکوس با نوع پرسمان \(dqPTR\(dq ارائه شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-x addr جستجوهای معکوس \- نگاشت آدرس‌ها به نام‌ها \- با این گزینه ساده‌سازی می‌شوند. شناسه \fBaddr\fP یک آدرس IPv4 در نمادگذاری ده‌دهی با نقطه یا یک آدرس IPv6 با تفکیک دونقطه است. دستور \fBmdig\fP به طور خودکار جستجویی برای نام پرسمانی مانند \fB11.12.13.10.in\-addr.arpa\fP انجام داده و نوع و کلاس پرسمان را به ترتیب روی PTR و IN تنظیم می‌کند. به طور پیش‌فرض، آدرس‌های IPv6 با استفاده از قالب نیم‌بایت (nibble format) تحت دامنه IP6.ARPA جستجو می‌شوند. .UNINDENT .sp گزینه‌های محلی پرسمان عبارتند از: .INDENT 0.0 .TP .B +aaflag, +noaaflag این گزینه مترادفی برای \fB+aaonly\fP و \fB+noaaonly\fP\& است. .UNINDENT .INDENT 0.0 .TP .B +aaonly, +noaaonly این گزینه پرچم \fBaa\fP را در پرسمان تنظیم می‌کند. .UNINDENT .INDENT 0.0 .TP .B +adflag, +noadflag این گزینه بیت AD (داده‌های موثق / authentic data) را در پرسمان تنظیم می‌کند [یا تنظیم نمی‌کند]. این گزینه از کارساز درخواست می‌کند تا گزارش دهد که آیا تمام بخش‌های پاسخ و مرجعیت بر اساس خط‌مشی امنیتی کارساز به عنوان امن اعتبارسنجی شده‌اند یا خیر. مقدار AD=1 نشان می‌دهد که تمام رکوردها به عنوان امن اعتبارسنجی شده‌اند و پاسخ از یک محدوده OPT\-OUT نیست. مقدار AD=0 نشان می‌دهد که بخشی از پاسخ ناامن بوده یا اعتبارسنجی نشده است. این بیت به طور پیش‌فرض تنظیم شده است. .UNINDENT .INDENT 0.0 .TP .B +bufsize=B این گزینه اندازه بافر پیام UDP اعلام‌شده با استفاده از EDNS0 را روی \fBB\fP بایت تنظیم می‌کند. حداکثر و حداقل اندازه این بافر به ترتیب ۶۵۵۳۵ و ۰ است. مقادیر خارج از این محدوده به طور مناسب به بالا یا پایین گرد می‌شوند. مقادیر غیر از صفر باعث ارسال یک پرسمان EDNS می‌شوند. .UNINDENT .INDENT 0.0 .TP .B +cdflag, +nocdflag این گزینه بیت CD (بررسی غیرفعال / checking disabled) را در پرسمان تنظیم می‌کند [یا تنظیم نمی‌کند]. این گزینه از کارساز درخواست می‌کند که اعتبارسنجی DNSSEC پاسخ‌ها را انجام ندهد. .UNINDENT .INDENT 0.0 .TP .B +cookie=####, +nocookie این گزینه یک گزینه COOKIE EDNS را با مقداری اختیاری ارسال می‌کند [یا ارسال نمی‌کند]. ارسال مجدد یک COOKIE از پاسخ قبلی به کارساز اجازه می‌دهد کلاینت قبلی را شناسایی کند. مقدار پیش‌فرض \fB+nocookie\fP\& است. .UNINDENT .INDENT 0.0 .TP .B +dnssec, +nodnssec این گزینه با تنظیم بیت DNSSEC OK (DO) در رکورد OPT در بخش اضافی (additional) پرسمان، درخواست می‌کند که رکوردهای DNSSEC ارسال شوند. .UNINDENT .INDENT 0.0 .TP .B +edns[=#], +noedns این گزینه نسخه EDNS را برای ارسال پرسمان مشخص می‌کند [یا مشخص نمی‌کند]. مقادیر معتبر بین ۰ تا ۲۵۵ هستند. تعیین نسخه EDNS باعث ارسال پرسمان EDNS می‌شود. گزینه \fB+noedns\fP نسخه ذخیره‌شده EDNS را پاک می‌کند. EDNS به طور پیش‌فرض روی ۰ تنظیم شده است. .UNINDENT .INDENT 0.0 .TP .B +ednsflags[=#], +noednsflags این گزینه بیت‌های پرچم EDNS را که باید صفر باشند (بیت‌های Z) روی مقدار مشخص‌شده تنظیم می‌کند. فرمت‌های ده‌دهی، هگزادسیمال و هشت‌هشتی (octal) پذیرفته می‌شوند. تنظیم یک پرچم نام‌گذاری‌شده (مانند DO) نادیده گرفته می‌شود. به طور پیش‌فرض هیچ بیت Z تنظیم نشده است. .UNINDENT .INDENT 0.0 .TP .B +ednsopt[=code[:value]], +noednsopt این گزینه یک گزینه EDNS با نقطه کد \fBcode\fP و محتوای اختیاری \fBvalue\fP به صورت یک رشته هگزادسیمال را مشخص می‌کند [یا مشخص نمی‌کند]. گزینه \fB+noednsopt\fP گزینه‌های EDNS برای ارسال را پاک می‌کند. .UNINDENT .INDENT 0.0 .TP .B +expire, +noexpire این گزینه ارسال گزینه EDNS Expire را فعال یا غیرفعال می‌کند. .UNINDENT .INDENT 0.0 .TP .B +nsid, +nonsid این گزینه درج درخواست شناسه کارساز نام EDNS (NSID) را هنگام ارسال پرسمان فعال یا غیرفعال می‌کند. .UNINDENT .INDENT 0.0 .TP .B +recurse, +norecurse این گزینه تنظیم بیت RD (درخواست بازگشتی / recursion desired) را در پرسمان تغییر می‌دهد. این بیت به طور پیش‌فرض تنظیم شده است، به این معنی که \fBmdig\fP معمولاً پرسمان‌های بازگشتی ارسال می‌کند. .UNINDENT .INDENT 0.0 .TP .B +retry=T این گزینه تعداد دفعات تلاش مجدد برای ارسال پرسمان‌های UDP به کارساز را به جای مقدار پیش‌فرض ۲، روی \fBT\fP تنظیم می‌کند. برخلاف \fB+tries\fP، این مقدار شامل پرسمان اولیه نمی‌شود. .UNINDENT .INDENT 0.0 .TP .B +subnet=addr[/prefix\-length], +nosubnet این گزینه یک گزینه EDNS Client Subnet را با آدرس IP یا پیشوند شبکه مشخص‌شده ارسال می‌کند [یا ارسال نمی‌کند]. .UNINDENT .INDENT 0.0 .TP .B \fBmdig +subnet=0.0.0.0/0\fP, or simply \fBmdig +subnet=0\fP این دستور یک گزینه EDNS client\-subnet با یک آدرس خالی و طول پیشوند مبدأ صفر ارسال می‌کند، که به تحلیل‌گر (resolver) نشان می‌دهد که اطلاعات آدرس کلاینت \fIنباید\fP هنگام تفکیک این پرسمان استفاده شود. .UNINDENT .INDENT 0.0 .TP .B +timeout=T این گزینه مهلت زمانی را برای یک پرسمان روی \fBT\fP ثانیه تنظیم می‌کند. مهلت زمانی پیش‌فرض برای انتقال UDP برابر ۵ ثانیه و برای TCP برابر ۱۰ ثانیه است. تلاش برای تنظیم \fBT\fP به کمتر از ۱ منجر به اعمال مهلت زمانی ۱ ثانیه می‌شود. .UNINDENT .INDENT 0.0 .TP .B +tries=T این گزینه تعداد دفعات تلاش برای ارسال پرسمان‌های UDP به کارساز را به جای مقدار پیش‌فرض ۳، روی \fBT\fP تنظیم می‌کند. اگر \fBT\fP کمتر یا مساوی صفر باشد، تعداد دفعات تلاش به ۱ گرد می‌شود. .UNINDENT .INDENT 0.0 .TP .B +udptimeout=T این گزینه مهلت زمانی بین تلاش‌های مجدد پرسمان UDP را روی \fBT\fP\& تنظیم می‌کند. .UNINDENT .INDENT 0.0 .TP .B +unknownformat, +nounknownformat این گزینه تمام RDATAها را در قالب نمایشی انواع RR ناشناخته چاپ می‌کند [یا چاپ نمی‌کند] (به \fBRFC 3597\fP \% مراجعه کنید). حالت پیش‌فرض چاپ RDATA برای انواع شناخته‌شده در قالب نمایشی آن نوع است. .UNINDENT .INDENT 0.0 .TP .B +yaml, +noyaml این گزینه چاپ پاسخ‌ها را در یک قالب تفصیلی YAML فعال یا غیرفعال می‌کند. .UNINDENT .INDENT 0.0 .TP .B +zflag, +nozflag این گزینه آخرین پرچم سرآیند DNS تخصیص‌نیافته را در یک پرسمان DNS تنظیم می‌کند [یا تنظیم نمی‌کند]. این پرچم به طور پیش‌فرض خاموش است. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fBdig(1)\fP \%<#\:std-iscman-dig>, \fBRFC 1035\fP \%\&. .SH "نویسندگان (AUTHORS)" Internet Systems Consortium .SH "کپی‌رایت (COPYRIGHT)" 2026, Internet Systems Consortium .\" End of generated man page.