.\"
.\" Copyright (C) the Massachusetts Institute of Technology.
.\" Copyright (C) Daniel Stenberg
.\" SPDX-License-Identifier: MIT
.\"
.TH ADIG "1" "Sept 2024" "c-ares utilities"
.SH "نام (NAME)"
adig \- چاپ اطلاعات جمع‌آوری‌شده از کارسازهای سامانه نام دامنه (DNS)
.SH "خلاصه دستور (SYNOPSIS)"
\fBadig\fP [\fI@server\fR] [\fI-c class\fR] [\fI-p port#\fR] [\fI-q name\fR]
[\fI-t type\fR] [\fI-x addr\fR] [\fIname\fR] [\fItype\fR] [\fIclass\fR]
[\fIqueryopt\fR...]

.SH "توضیحات (DESCRIPTION)"
.PP
ارسال پرسمان‌ها به کارسازهای DNS درباره \fIname\fR و چاپ اطلاعات دریافتی، که در آن \fIname\fR یک نام معتبر DNS است (مانند www.example.com یا 1.2.3.10.in-addr.arpa).
.PP
این ابزار به همراه کتابخانه تحلیل‌گر ناهمگام \fBc\-ares\fR عرضه می‌شود.
.PP
تعیین آرگومان‌های پیش‌فرض برای \fBadig\fR از طریق مسیر \fB${XDG_CONFIG_HOME}/adigrc\fR امکان‌پذیر است.
.SH "آرگومان‌ها (ARGS)"
.TP
\fB@server\fR
نشانی IP کارساز. می‌توان چندین نشانی را با کاما جدا کرد. همچنین امکان مشخص کردن در قالب URI وجود دارد.
.TP
\fBname\fR
نام رکورد منبعی که باید جستجو شود.
.TP
\fBtype\fR
نوع پرسمان مورد نیاز؛ مانند A، AAAA، MX، TXT و غیره. در صورت عدم تعیین، از A استفاده می‌شود.
.TP
\fBclass\fR
تعیین کلاس پرسمان که پیش‌فرض آن IN است. می‌تواند HS یا CH نیز باشد.

.SH "فلگ‌ها (FLAGS)"
.TP
\fB\-c\fR class
تعیین کلاس پرسمان؛ پیش‌فرض IN است. می‌تواند HS یا CH نیز باشد.
.TP
\fB\-h\fR
چاپ راهنما.
.TP
\fB\-p\fR port
ارسال پرسمان به پورتی غیر از ۵۳. معمولاً توصیه می‌شود به جای این گزینه پورت را در \fI@server\fR مشخص کنید.
.TP
\fB\-q\fR name
مشخص کردن نام دامنه برای پرسمان. برای تمایز نام دامنه از سایر آرگومان‌ها مفید است.
.TP
\fB\-r\fR
صرف‌نظر از پردازش فایل adigrc.
.TP
\fB\-s\fR
کارساز (نام مستعار برای نحو @server)، جهت سازگاری با خط فرمان قدیمی.
.TP
\fB\-t\fR type
مشخص کردن نوع رکورد منبع برای پرسمان. برای تمایز نوع رکورد از سایر آرگومان‌ها مفید است.
.TP
\fB\-x\fR addr
جستجوی معکوس ساده‌شده. نوع پرسمان را به PTR تغییر داده و یک رشته پرسمان معتبر in-arpa می‌سازد.

.SH "گزینه‌های پرسمان (QUERY OPTIONS)"
.TP
\fB+[no]aaonly\fR
تنظیم فلگ aa در پرسمان. پیش‌فرض خاموش (off) است.
.TP
\fB+[no]aaflag\fR
نام مستعار برای +[no]aaonly.
.TP
\fB+[no]additional\fR
تغییر وضعیت چاپ بخش اطلاعات تکمیلی (additional). به طور پیش‌فرض روشن است.
.TP
\fB+[no]adflag\fR
تنظیم بیت ad (داده معتبر یا authentic data) در پرسمان. پیش‌فرض خاموش است.
.TP
\fB+[no]aliases\fR
استفاده یا عدم استفاده از فایل HOSTALIASES. به طور پیش‌فرض روشن است.
.TP
\fB+[no]all\fR
تغییر وضعیت تمام گزینه‌های +[no]cmd، +[no]stats، +[no]question، +[no]answer، +[no]authority، +[no]additional و +[no]comments.
.TP
\fB+[no]answer\fR
تغییر وضعیت چاپ پاسخ. به طور پیش‌فرض روشن است.
.TP
\fB+[no]authority\fR
تغییر وضعیت چاپ بخش مرجعیت (authority). به طور پیش‌فرض روشن است.
.TP
\fB+bufsize=\fR#
اندازه مجاز بسته UDP EDNS 0. پیش‌فرض ۱۲۳۲ است.
.TP
\fB+[no]cdflag\fR
تنظیم بیت CD (غیرفعال‌سازی بررسی یا checking disabled) در پرسمان. پیش‌فرض خاموش است.
.TP
\fB+[no]class\fR
نمایش کلاس هنگام چاپ رکورد. به طور پیش‌فرض روشن است.
.TP
\fB+[no]cmd\fR
تغییر وضعیت چاپ دستور درخواست‌شده. به طور پیش‌فرض روشن است.
.TP
\fB+[no]comments\fR
تغییر وضعیت چاپ توضیحات. به طور پیش‌فرض روشن است.
.TP
\fB+[no]defname\fR
نام مستعار برای +[no]search.
.TP
\fB+domain=somename\fR
تنظیم فهرست جستجو به یک دامنه منفرد.
.TP
\fB+[no]dns0x20\fR
استفاده یا عدم استفاده از تصادفی‌سازی بزرگی/کوچکی حروف به شیوه DNS 0x20 هنگام ارسال پرسمان‌ها. پیش‌فرض خاموش است.
.TP
\fB+[no]edns\fR[=#]
فعال یا غیرفعال کردن EDNS. در صورت مشخص شدن تنها مقدار ۰ مجاز است. پیش‌فرض فعال بودن EDNS است.
.TP
\fB+[no]ignore\fR
نادیده گرفتن بریده شدن پاسخ (truncation) در UDP؛ به طور پیش‌فرض در پروتکل TCP مجدداً تلاش می‌شود.
.TP
\fB+[no]keepopen\fR
تعیین اینکه آیا اتصال به کارساز باید پایدار بماند یا خیر. پیش‌فرض خاموش است.
.TP
\fB+ndots\fR=#
تعیین تعداد نقطه‌هایی که باید قبل از مطلق در نظر گرفته شدن نام ظاهر شوند. پیش‌فرض ۱ است.
.TP
\fB+[no]primary\fR
تعیین اینکه در صورت در دسترس بودن چند کارساز، آیا فقط از یک کارساز منفرد استفاده شود یا خیر. پیش‌فرض استفاده از تمام کارسازها است.
.TP
\fB+[no]qr\fR
تغییر وضعیت چاپ پرسمان درخواستی. پیش‌فرض خاموش است.
.TP
\fB+[no]question\fR
تغییر وضعیت چاپ بخش پرسش (question). به طور پیش‌فرض روشن است.
.TP
\fB+[no]recurse\fR
تغییر وضعیت بیت RD (درخواست بازگشتی یا Recursion Desired). به طور پیش‌فرض روشن است.
.TP
\fB+retry\fR=#
مشابه +tries است با این تفاوت که تلاش اولیه را شامل نمی‌شود.
.TP
\fB+[no]search\fR
استفاده یا عدم استفاده از فهرست جستجو. به طور پیش‌فرض فهرست جستجو استفاده نمی‌شود.
.TP
\fB+[no]stats\fR
تغییر وضعیت چاپ آمارها. به طور پیش‌فرض روشن است.
.TP
\fB+[no]tcp\fR
استفاده از پروتکل TCP هنگام پرسمان از کارسازهای نام. پیش‌فرض UDP است.
.TP
\fB+tries\fR=#
تعداد دفعات تلاش برای پرسمان. پیش‌فرض ۳ است.
.TP
\fB+[no]ttlid\fR
نمایش TTL هنگام چاپ رکورد. به طور پیش‌فرض روشن است.
.TP
\fB+[no]vc\fR
نام مستعار برای +[no]tcp.

.SH "فایل‌ها (FILES)"

${XDG_CONFIG_HOME}/adigrc

.SH "گزارش اشکال (REPORTING BUGS)"
اشکالات را در سامانه پیگیری مسائل گیت‌هاب c-ares گزارش دهید:
.br
\fBhttps://github.com/c-ares/c-ares/issues\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
ahost(1).