.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "dog" "1" "" "v0.1.0" ""
.hy
.SH "نام (NAME)"
dog \- ابزار خط فرمان برای پرس‌وجوی سامانه‌ی نام دامنه (DNS)
.SH "خلاصه دستور (SYNOPSIS)"
\f[V]dog [options] [domains...]\f[R]
.PP
دستور \f[B]dog\f[R] یک ابزار خط فرمانی برای پرس‌وجوی سامانه نام دامنه (DNS) است.
این ابزار خروجی رنگی ارائه می‌دهد، از پروتکل‌های DNS-over-TLS و DNS-over-HTTPS پشتیبانی می‌کند و می‌تواند خروجی با ساختار JSON تولید نماید.
.SH "مثال‌ها (EXAMPLES)"
.TP
\f[V]dog example.net\f[R]
پرس‌وجوی رکورد \f[V]A\f[R] یک دامنه با استفاده از تنظیمات پیش‌فرض
.TP
\f[V]dog example.net MX\f[R]
جستجوی رکوردهای \f[V]MX\f[R] به جای آن
.TP
\f[V]dog example.net MX \[at]1.1.1.1\f[R]
استفاده از یک کارساز نام (nameserver) مشخص به جای حالت پیش‌فرض
.TP
\f[V]dog example.net MX \[at]1.1.1.1 -T\f[R]
استفاده از پروتکل TCP به جای UDP
.TP
\f[V]dog -q example.net -t MX -n 1.1.1.1 -T\f[R]
مشابه موارد بالا، اما با استفاده از آرگومان‌های صریح
.SH "گزینه‌های پرس‌وجو (QUERY OPTIONS)"
.TP
\f[V]-q\f[R], \f[V]--query=HOST\f[R]
نام میزبان یا نام دامنه مورد پرس‌وجو.
.TP
\f[V]-t\f[R], \f[V]--type=TYPE\f[R]
نوع رکورد DNS مورد پرس‌وجو (\f[V]A\f[R]، \f[V]MX\f[R]،
\f[V]NS\f[R] و غیره).
.TP
\f[V]-n\f[R], \f[V]--nameserver=ADDR\f[R]
نشانی کارساز نام برای ارسال بسته‌ها به آن.
.TP
\f[V]--class=CLASS\f[R]
کلاس شبکه رکورد DNS مورد پرس‌وجو (\f[V]IN\f[R]،
\f[V]CH\f[R]، \f[V]HS\f[R]).
.PP
به‌طور پیش‌فرض، dog رکوردهای A را با استفاده از تحلیل‌گر پیش‌فرض سیستم درخواست می‌کند.
حداقل یک نام دامنه باید ارسال شود \(em برنامه dog به‌طور خودکار کارسازهای نام ریشه را پرس‌وجو نمی‌کند.
.PP
گزینه‌های پرس‌وجو را می‌توان با یک گزینه خط فرمان مانند
`\f[V]--query lookup.dog\f[R]' یا `\f[V]--type MX\f[R]'، یا به صورت آرگومان‌های ساده مانند
`\f[V]lookup.dog\f[R]' یا `\f[V]MX\f[R]' ارسال کرد.
برنامه dog حدس هوشمندانه‌ای خواهد زد که منظور از آرگومان‌های ساده چیست
(\f[V]MX\f[R] کاملاً مشخص است که یک نوع رکورد است)، که نوشتن سریع پرس‌وجوهای موردی را آسان‌تر می‌کند.
اگر دقت و صراحت بیشتری مد نظر است، از گزینه‌های بلند استفاده کنید.
.PP
اگر بیش از یک دامنه، نوع، کارساز نام یا کلاس مشخص شود، dog
برای هر ترکیب یک پرس‌وجو انجام داده و نتایج ترکیبی را در یک جدول نمایش می‌دهد.
برای مثال، ارسال سه آرگومان نوع و دو آرگومان نام دامنه، شش درخواست ارسال خواهد کرد.
.PP
سامانه DNS به‌طور سنتی از درگاه ۵۳ برای هر دو پروتکل TCP و UDP استفاده می‌کند.
برای استفاده از یک تحلیل‌گر با درگاهی متفاوت، شماره درگاه را پس از دو نقطه (\f[V]:\f[R]) در نشانی کارساز نام درج کنید.
.SH "گزینه‌های ارسال (SENDING OPTIONS)"
.TP
\f[V]--edns=SETTING\f[R]
تعیین تمایل به استفاده از EDNS.
این گزینه می‌تواند `\f[V]disable\f[R]'، `\f[V]hide\f[R]' یا `\f[V]show\f[R]' باشد.
.TP
\f[V]--txid=NUMBER\f[R]
تنظیم شناسه تراکنش روی یک مقدار مشخص.
.TP
\f[V]-Z=TWEAKS\f[R]
تنظیم دستکاری‌های غیرمعمول در سطح پروتکل.
.SH "گزینه‌های انتقال (TRANSPORT OPTIONS)"
.TP
\f[V]-U\f[R], \f[V]--udp\f[R]
استفاده از پروتکل DNS روی UDP.
.TP
\f[V]-T\f[R], \f[V]--tcp\f[R]
استفاده از پروتکل DNS روی TCP.
.TP
\f[V]-S\f[R], \f[V]--tls\f[R]
استفاده از پروتکل DNS-over-TLS.
.TP
\f[V]-H\f[R], \f[V]--https\f[R]
استفاده از پروتکل DNS-over-HTTPS.
.PP
به‌طور پیش‌فرض، dog از پروتکل UDP استفاده می‌کند و در صورتی که پاسخ نشان دهد پیام برای UDP بیش از حد بزرگ است، به‌طور خودکار درخواست را با استفاده از TCP مجدداً ارسال می‌کند.
ارسال \f[V]--udp\f[R] تنها از UDP استفاده کرده و در این حالت با شکست مواجه می‌شود؛
ارسال \f[V]--tcp\f[R] به‌طور پیش‌فرض از TCP استفاده خواهد کرد.
.PP
پروتکل‌های DNS-over-TLS (DoT) و DNS-over-HTTPS (DoH) با گزینه‌های
\f[V]--tls\f[R] و \f[V]--https\f[R] در دسترس هستند.
به یاد داشته باشید که بعید است تحلیل‌گر پیش‌فرض سیستم به درخواست‌هایی با استفاده از این پروتکل‌ها پاسخ دهد.
.PP
توجه داشته باشید که اگر یک نام میزبان یا نام دامنه به جای نشانی IP به عنوان کارساز نام داده شود، وضوح‌یابی آن میزبان توسط سیستم‌عامل انجام می‌شود، \f[I]نه\f[R] توسط dog.
.PP
برخلاف سایر روش‌ها، نوع انتقال HTTPS نیازمند یک نشانی وب (URL) کامل، شامل پروتکل، نام دامنه و مسیر است.
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
.TP
\f[V]-1\f[R], \f[V]--short\f[R]
حالت کوتاه: تنها نتیجه اول را نمایش می‌دهد.
.TP
\f[V]-J\f[R], \f[V]--json\f[R]
نمایش خروجی در قالب JSON.
.TP
\f[V]--color\f[R], \f[V]--colour=WHEN\f[R]
زمان رنگی کردن خروجی.
می‌تواند یکی از مقادیر `\f[V]always\f[R]'، `\f[V]automatic\f[R]' یا
`\f[V]never\f[R]' باشد.
.TP
\f[V]--seconds\f[R]
مدت زمان‌ها را بر حسب ساعت و دقیقه قالب‌بندی نمی‌کند؛ در عوض آن‌ها را بر حسب ثانیه نمایش می‌دهد.
.TP
\f[V]--time\f[R]
مدت زمانی که طول کشید تا پاسخ دریافت شود را چاپ می‌کند.
.SH "گزینه‌های عمومی (META OPTIONS)"
.TP
\f[V]--help\f[R]
مروری بر گزینه‌های خط فرمان را نمایش می‌دهد.
.TP
\f[V]--version\f[R]
نسخه در حال اجرای dog را نمایش می‌دهد.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
برنامه dog به متغیرهای محیطی زیر پاسخ می‌دهد:
.SS \f[V]DOG_DEBUG\f[R]
این متغیر را روی هر مقدار غیرخالی تنظیم کنید تا dog اطلاعات اشکال‌زدایی را به خروجی خطای استاندارد ارسال کند.
برای دریافت خروجی عمیق‌تر و دقیق‌تر، آن را روی رشته دقیق
`\f[V]trace\f[R]' تنظیم کنید.
.SH "انواع رکوردها (RECORD TYPES)"
برنامه dog انواع رکوردهای زیر را می‌شناسد و می‌تواند تفسیر کند:
.TP
\f[V]A\f[R]
نشانی‌های IPv4
.TP
\f[V]AAAA\f[R]
نشانی‌های IPv6
.TP
\f[V]CAA\f[R]
مراجع صدور گواهی مجاز (CA)
.TP
\f[V]CNAME\f[R]
نام‌های مستعار رسمی دامنه
.TP
\f[V]HINFO\f[R]
اطلاعات سیستم و در برخی مواقع توضیحات درخواست‌های غیرمجاز
.TP
\f[V]LOC\f[R]
اطلاعات موقعیت مکانی
.TP
\f[V]MX\f[R]
نشانی‌های کارساز ایمیل
.TP
\f[V]NAPTR\f[R]
قوانین DDDS
.TP
\f[V]NS\f[R]
کارسازهای نام دامنه
.TP
\f[V]OPT\f[R]
افزونه‌های پروتکل DNS
.TP
\f[V]PTR\f[R]
اشاره‌گرها به نام‌های رسمی، معمولاً برای وضوح‌یابی معکوس
.TP
\f[V]SOA\f[R]
اطلاعات مدیریتی درباره منطقه‌ها (zones)
.TP
\f[V]SRV\f[R]
نشانی‌های IP همراه با شماره درگاه
.TP
\f[V]SSHFP\f[R]
اثر انگشت کلید SSH
.TP
\f[V]TLSA\f[R]
گواهی‌های TLS، کلیدهای عمومی و هش‌ها
.TP
\f[V]TXT\f[R]
اطلاعات متنی دلخواه
.PP
هنگامی که یک بسته پاسخ DNS حاوی رکوردی از یکی از این انواع شناخته‌شده باشد، dog آن را در جدولی شامل نام نوع و خلاصه‌ای خوانا برای انسان از محتوای آن نمایش می‌دهد.
.PP
رکوردهایی با شماره نوعی که به هیچ نوع رکورد شناخته‌شده‌ای نگاشت نمی‌شود همچنان نمایش داده خواهند شد.
از آنجا که این رکوردها قابل تفسیر نیستند، محتوای آن‌ها به صورت یک سری اعداد نمایش داده می‌شود.
.PP
برنامه dog همچنین شامل فهرستی از نام‌های انواع رکورد است که شماره نوع آن‌ها را می‌داند، اما قادر به تفسیر آن‌ها نیست، مانند \f[V]IXFR\f[R] یا \f[V]ANY\f[R] یا \f[V]AFSDB\f[R].
این موارد به عنوان آرگومان‌های خط فرمان قابل قبول هستند، به این معنی که می‌توانید با `\f[V]dog AFSDB\f[R]' یک درخواست AFSDB ارسال کنید.
با این حال، محتوای پاسخ آن‌ها همچنان به صورت عدد نمایش داده می‌شود.
ممکن است این موارد در نسخه‌های بعدی dog پشتیبانی شوند.
.SH "دستکاری‌های پروتکل (PROTOCOL TWEAKS)"
آرگومان خط فرمان \f[V]-Z\f[R] می‌تواند یک یا چند بار برای تنظیم برخی گزینه‌ها در سطح پروتکل در پرس‌وجوهای DNS ارسال‌شده استفاده شود.
این گزینه مقادیر زیر را می‌پذیرد:
.TP
\f[V]aa\f[R]
بیت \f[V]AA\f[R] (پاسخ‌های معتبر - Authoritative Answers) را در پرس‌وجو تنظیم می‌کند.
.TP
\f[V]ad\f[R]
بیت \f[V]AD\f[R] (داده‌های معتبر - Authentic Data) را در پرس‌وجو تنظیم می‌کند.
.TP
\f[V]bufsize=NUM\f[R]
اندازه بار مفید UDP را در فیلد OPT در پرس‌وجو تنظیم می‌کند.
اگر EDNS غیرفعال باشد، این گزینه تأثیری ندارد.
.TP
\f[V]cd\f[R]
بیت \f[V]CD\f[R] (بررسی غیرفعال - Checking Disabled) را در پرس‌وجو تنظیم می‌کند.
.SH "وضعیت‌های خروج (EXIT STATUSES)"
.TP
0
اگر همه چیز بدون خطا انجام شود.
.TP
1
در صورت بروز خطای شبکه، ورودی/خروجی یا TLS در حین عملیات.
.TP
2
اگر در صورت اجرا در حالت کوتاه، نتیجه‌ای از سرور دریافت نشود.
این می‌تواند هر خطای دریافتی از سرور باشد، نه فقط NXDOMAIN.
.TP
3
در صورت بروز مشکل در آرگومان‌های خط فرمان.
.SH "نویسنده (AUTHOR)"
برنامه dog توسط Benjamin `ogham' Sago توسعه یافته و نگهداری می‌شود.
.PP
\f[B]وب‌سایت:\f[R] \f[V]https://dns.lookup.dog\f[R]
.PD 0
.P
.PD
\f[B]کد منبع:\f[R] \f[V]https://github.com/ogham/dog\f[R]