.\" Man page generated from reStructuredText.
.
.
.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 "SDIG" "1" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
sdig \- اجرای یک پرس‌وجوی DNS و نمایش نتایج
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBsdig\fP \fIIP\-ADDRESS\-OR\-DOH\-URL\fP \fIPORT\fP \fIQNAME\fP \fIQTYPE\fP [\fIOPTION\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBsdig\fP یک پرس‌وجوی DNS را به \fIIP\-ADDRESS\-OR\-DOH\-URL\fP روی پورت \fIPORT\fP ارسال می‌کند و پاسخ را در قالبی مرتب نمایش می‌دهد.
اگر نشانی با یک \fBh\fP آغاز شود، به عنوان یک نقطه پایانی DoH در نظر گرفته شده و \fIPORT\fP نادیده گرفته می‌شود.
اگر qname و qtype هر دو برابر \fI\-\fP باشند و از tcp استفاده شود، چندین خط از stdin خوانده می‌شود که هر خط شامل یک qname و یک نوع (type) است.
اگر نشانی \fBstdin\fP باشد، یک بستهٔ DNS به جای شبکه از stdin خوانده می‌شود و \fIPORT\fP نادیده گرفته خواهد شد.
تمام ورودی‌ها دقیق (حرف‌به‌حرف) و حساس به حروف بزرگ و کوچک هستند.
چنانچه مشخص نباشد که مقصد پرس‌وجو سرور معتبر (authoritative) برای آن رکورد است، پرس‌وجوها برای دریافت پاسخ حاوی رکورد منبع به گزینهٔ \fIrecurse\fP نیاز دارند.
.SH "گزینه‌ها (OPTIONS)"
.sp
این گزینه‌ها را می‌توان به هر ترتیبی به خط فرمان اضافه کرد.
.INDENT 0.0
.TP
.B class \fICLASSNUM\fP
ارسال پرس‌وجو در کلاس شماره‌گذاری‌شده (مانند ۳ برای CHAOS) به جای پیش‌فرض ۱ (برای IN).
.TP
.B dnssec
تنظیم بیت DO جهت درخواست اطلاعات DNSSEC.
.TP
.B ednssubnet \fISUBNET\fP
ارسال \fISUBNET\fP در گزینهٔ edns\-client\-subnet. اگر این گزینه تعیین نشود، هیچ گزینهٔ edns\-client\-subnet در پرس‌وجو قرار نمی‌گیرد.
.TP
.B hidesoadetails
شماره سریال SOA را در پاسخ نشان نده.
.TP
.B hidettl
جایگزینی مقادیر TTL با \fI[ttl]\fP در پاسخ.
.TP
.B proxy \fITCP?\fP \fISRC\fP \fIDST\fP
بسته‌بندی پرس‌وجو در پروتکل PROXYv2 با این پارامترها. پارامتر نخست مقدار 0 را برای UDP و 1 را برای TCP می‌پذیرد. پارامترهای دوم و سوم نشانی‌های IP و پورت را دریافت می‌کنند.
.TP
.B recurse
تنظیم بیت RD در پرسش (question).
.TP
.B showflags
نمایش پرچم‌های NSEC3 در پاسخ (به طور پیش‌فرض پنهان هستند).
.TP
.B dumpluaraw
نمایش محتوای رکوردها در قالبی مناسب برای \fISpoofRawAction\fP در dnsdist\&.
.TP
.B tcp
استفاده از TCP به جای UDP برای ارسال پرس‌وجو.
.TP
.B dot
استفاده از DoT به جای UDP برای ارسال پرس‌وجو. متضمن tcp است.
.TP
.B insecure
هنگام استفاده از DoT، گواهی سرور را اعتبارسنجی نکن.
.TP
.B fastOpen
هنگام استفاده از TCP یا DoT، قابلیت TCP Fast Open را فعال کن.
.TP
.B subjectName \fIname\fP
هنگام استفاده از DoT، بررسی می‌کند که گواهی سرور برای \fIname\fP صادر شده باشد\&. ارائه‌دهندهٔ \fIopenssl\fP یک نام خالی را می‌پذیرد و همچنان اطمینان حاصل می‌کند که گواهی توسط یک CA معتبر صادر شده باشد، اما \fIgnutls\fP تنها در صورتی اعتبارسنجی را انجام می‌دهد که نام مشخص شده باشد. پیش‌فرض، نام خالی است. همچنین توجه داشته باشید که کتابخانه‌های ارائه‌دهنده قدیمی‌تر ممکن است اصلاً اعتبارسنجی را انجام ندهند.
.TP
.B caStore \fIfile\fP
هنگام استفاده از DoT، گواهی‌های CA معتبر را از \fIfile\fP می‌خواند\&. حالت پیش‌فرض استفاده از مخزن CA ارائه‌شده توسط سیستم است.
.TP
.B tlsProvider \fIname\fP
هنگام استفاده از DoT، از ارائه‌دهندهٔ TLS به نام \fIname\fP استفاده می‌کند\&. موارد پشتیبانی‌شده در حال حاضر (در صورت کامپایل شدن): \fIopenssl\fP و \fIgnutls\fP\&. پیش‌فرض در صورت موجود بودن، \fIopenssl\fP است.
.TP
.B opcode \fIOPNUM\fP
استفاده از کد دستور (opcode) \fIOPNUM\fP به جای 0 (Query). برای نمونه، \fBsdig 192.0.2.1 53 example.com SOA opcode 4\fP یک پیام \fBNOTIFY\fP ارسال می‌کند\&.
.TP
.B cookie \fICOOKIE\fP
اگر \fICOOKIE\fP مقدار \fB\-\fP باشد، یک کوکی کلاینت تصادفی ارسال می‌کند. در غیر این صورت، کوکی داده‌شده را ارسال می‌کند که باید یک رشتهٔ هگزادسیمال باشد که پیش‌تر از یک سرور دریافت شده است.
.TP
.B traceid \fITraceID\fP
گنجاندن یک مقدار TraceID و یک مقدار خالی SpanID در داده‌های EDNS. اگر TraceID برابر با \fB\-\fP باشد، یک TraceID تصادفی تولید می‌شود؛ در غیر این صورت، یک رشتهٔ هگزادسیمال است.
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.TP
.B پرس‌وجوهای ساده به تحلیل‌کننده‌های محلی
\fBsdig 127.0.0.1 53 example.com AAAA recurse\fP
.sp
\fBsdig ::1 53 example.com A recurse\fP
.TP
.B پرس‌وجو به یک سرور DNS\-over\-HTTPS با درخواست dnssec و recursion
\fBsdig https://dns.example.net/dns\-query 443 example.com A dnssec recurse\fP
.UNINDENT
.SH "نویسندگان (AUTHORS)"
PowerDNS.COM BV
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.