نام (NAME)

sdig - اجرای یک پرس‌وجوی DNS و نمایش نتایج

خلاصه دستور (SYNOPSIS)

sdig IP-ADDRESS-OR-DOH-URL PORT QNAME QTYPE [OPTION]

توضیحات (DESCRIPTION)

دستور sdig یک پرس‌وجوی DNS را به IP-ADDRESS-OR-DOH-URL روی پورت PORT ارسال می‌کند و پاسخ را در قالبی مرتب نمایش می‌دهد. اگر نشانی با یک h آغاز شود، به عنوان یک نقطه پایانی DoH در نظر گرفته شده و PORT نادیده گرفته می‌شود. اگر qname و qtype هر دو برابر - باشند و از tcp استفاده شود، چندین خط از stdin خوانده می‌شود که هر خط شامل یک qname و یک نوع (type) است. اگر نشانی stdin باشد، یک بستهٔ DNS به جای شبکه از stdin خوانده می‌شود و PORT نادیده گرفته خواهد شد. تمام ورودی‌ها دقیق (حرف‌به‌حرف) و حساس به حروف بزرگ و کوچک هستند. چنانچه مشخص نباشد که مقصد پرس‌وجو سرور معتبر (authoritative) برای آن رکورد است، پرس‌وجوها برای دریافت پاسخ حاوی رکورد منبع به گزینهٔ recurse نیاز دارند.

گزینه‌ها (OPTIONS)

این گزینه‌ها را می‌توان به هر ترتیبی به خط فرمان اضافه کرد.

class CLASSNUM: ارسال پرس‌وجو در کلاس شماره‌گذاری‌شده (مانند ۳ برای CHAOS) به جای پیش‌فرض ۱ (برای IN).
dnssec: تنظیم بیت DO جهت درخواست اطلاعات DNSSEC.
ednssubnet SUBNET: ارسال SUBNET در گزینهٔ edns-client-subnet. اگر این گزینه تعیین نشود، هیچ گزینهٔ edns-client-subnet در پرس‌وجو قرار نمی‌گیرد.
hidesoadetails: شماره سریال SOA را در پاسخ نشان نده.
hidettl: جایگزینی مقادیر TTL با [ttl] در پاسخ.
proxy TCP? SRC DST: بسته‌بندی پرس‌وجو در پروتکل PROXYv2 با این پارامترها. پارامتر نخست مقدار 0 را برای UDP و 1 را برای TCP می‌پذیرد. پارامترهای دوم و سوم نشانی‌های IP و پورت را دریافت می‌کنند.
recurse: تنظیم بیت RD در پرسش (question).
showflags: نمایش پرچم‌های NSEC3 در پاسخ (به طور پیش‌فرض پنهان هستند).
dumpluaraw: نمایش محتوای رکوردها در قالبی مناسب برای SpoofRawAction در dnsdist.
tcp: استفاده از TCP به جای UDP برای ارسال پرس‌وجو.
dot: استفاده از DoT به جای UDP برای ارسال پرس‌وجو. متضمن tcp است.
insecure: هنگام استفاده از DoT، گواهی سرور را اعتبارسنجی نکن.
fastOpen: هنگام استفاده از TCP یا DoT، قابلیت TCP Fast Open را فعال کن.
subjectName name: هنگام استفاده از DoT، بررسی می‌کند که گواهی سرور برای name صادر شده باشد. ارائه‌دهندهٔ openssl یک نام خالی را می‌پذیرد و همچنان اطمینان حاصل می‌کند که گواهی توسط یک CA معتبر صادر شده باشد، اما gnutls تنها در صورتی اعتبارسنجی را انجام می‌دهد که نام مشخص شده باشد. پیش‌فرض، نام خالی است. همچنین توجه داشته باشید که کتابخانه‌های ارائه‌دهنده قدیمی‌تر ممکن است اصلاً اعتبارسنجی را انجام ندهند.
caStore file: هنگام استفاده از DoT، گواهی‌های CA معتبر را از file می‌خواند. حالت پیش‌فرض استفاده از مخزن CA ارائه‌شده توسط سیستم است.
tlsProvider name: هنگام استفاده از DoT، از ارائه‌دهندهٔ TLS به نام name استفاده می‌کند. موارد پشتیبانی‌شده در حال حاضر (در صورت کامپایل شدن): openssl و gnutls. پیش‌فرض در صورت موجود بودن، openssl است.
opcode OPNUM: استفاده از کد دستور (opcode) OPNUM به جای 0 (Query). برای نمونه، sdig 192.0.2.1 53 example.com SOA opcode 4 یک پیام NOTIFY ارسال می‌کند.
cookie COOKIE: اگر COOKIE مقدار - باشد، یک کوکی کلاینت تصادفی ارسال می‌کند. در غیر این صورت، کوکی داده‌شده را ارسال می‌کند که باید یک رشتهٔ هگزادسیمال باشد که پیش‌تر از یک سرور دریافت شده است.
traceid TraceID: گنجاندن یک مقدار TraceID و یک مقدار خالی SpanID در داده‌های EDNS. اگر TraceID برابر با - باشد، یک TraceID تصادفی تولید می‌شود؛ در غیر این صورت، یک رشتهٔ هگزادسیمال است.

مثال‌ها (EXAMPLES)

پرس‌وجوهای ساده به تحلیل‌کننده‌های محلی: sdig 127.0.0.1 53 example.com AAAA recurse
sdig ::1 53 example.com A recurse
پرس‌وجو به یک سرور DNS-over-HTTPS با درخواست dnssec و recursion: sdig https://dns.example.net/dns-query 443 example.com A dnssec recurse

نویسندگان (AUTHORS)

PowerDNS.COM BV

کپی‌رایت و تکثیر (COPYRIGHT)

PowerDNS.COM BV