'\" t
.TH "RESOLVECTL" "1" "" "systemd 261.2" "resolvectl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
resolvectl \- تفکیک نامهای دامنه، آدرسهای IPv4 و IPv6، رکوردهای DNS و کلیدها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBresolvectl\fR\ 'u
\fBresolvectl\fR [OPTIONS...] {COMMAND} [NAME...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBresolvectl\fR
می‌تواند برای تفکیک نام‌های دامنه، آدرس‌های IPv4 و IPv6، رکوردهای منبع DNS و سرویس‌ها از طریق سرویس تفکیک‌کننده
\fBsystemd-resolved.service\fR(8)
استفاده شود\&. به‌طور پیشفرض، فهرست پارامترهای مشخص‌شده به عنوان نام میزبان تفکیک شده و آدرس‌های IPv4 و IPv6 آن‌ها دریافت می‌شود\&. اگر پارامترهای مشخص‌شده در قالب آدرس‌های IPv4 یا IPv6 باشند، عملیات معکوس انجام می‌شود و نام میزبان برای آدرس‌های مشخص‌شده واکشی می‌گردد\&.
.PP
خروجی برنامه شامل اطلاعاتی درباره پروتکل استفاده‌شده برای جستجو و رابط شبکه‌ای است که داده‌ها روی آن کشف شده‌اند\&. همچنین شامل اطلاعاتی است مبنی بر اینکه آیا داده‌ها قابل اعتبارسنجی بوده‌اند یا خیر\&. تمامی داده‌هایی که اعتبارسنجی محلی DNSSEC برای آن‌ها موفقیت‌آمیز باشد، معتبر (authenticated) در نظر گرفته می‌شوند\&. علاوه بر این، تمامی داده‌های با منشأ منابع محلی و مورد اعتماد نیز معتبر گزارش می‌شوند، از جمله تفکیک نام میزبان محلی، نام میزبان
"localhost"
یا تمامی داده‌های برگرفته از
/etc/hosts\&.
.SH "دستورات (COMMANDS)"
.PP
\fBquery\fR \fIHOSTNAME|ADDRESS\fR\&...
.RS 4
تفکیک نام‌های دامنه و همچنین آدرس‌های IPv4 و IPv6\&. هنگامی که در ترکیب با
\fB\-\-type=\fR
یا
\fB\-\-class=\fR
(به زیر مراجعه کنید) استفاده شود، رکوردهای منبع سطح پایین DNS را تفکیک می‌کند\&.
.sp
اگر یک نام دامنه تک‌برچسبی مشخص شود، مطابق با دامنه‌های جستجوی پیکربندی‌شده جستجو می‌شود \(em مگر اینکه
\fB\-\-search=no\fR
یا
\fB\-\-type=\fR/\fB\-\-class=\fR
مشخص شده باشند، که هر دوی آن‌ها این منطق را غیرفعال می‌کنند\&.
.sp
اگر یک نام دامنه بین‌المللی مشخص شود، هنگام تفکیک از طریق DNS سنتی، به‌طور خودکار مطابق با قوانین IDNA ترجمه می‌شود \(em اما نه برای جستجوها از طریق MulticastDNS یا LLMNR\&. اگر از
\fB\-\-type=\fR/\fB\-\-class=\fR
استفاده شود، ترجمه IDNA خاموش شده و نام‌های دامنه همان‌گونه که مشخص شده‌اند پردازش می‌شوند\&.
.sp
اگر با
\fB\-\-json=\fR
ترکیب شود (تنها در ترکیب با
\fB\-\-type=\fR
پشتیبانی می‌شود)، داده‌های رکورد منبع را در یک شیء JSON خروجی می‌دهد\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBservice\fR [[\fINAME\fR] \fITYPE\fR] \fIDOMAIN\fR
.RS 4
تفکیک سرویس‌های
\m[blue]\fBRFC 6763 DNS\-SD\fR\m[]\&\s-2\u[1]\d\s+2
و
\m[blue]\fBRFC 2782 SRV\fR\m[]\&\s-2\u[2]\d\s+2،
بسته به فهرست پارامترهای مشخص‌شده\&. اگر سه پارامتر ارسال شوند، اولی به عنوان نام سرویس DNS\-SD، دومی نوع سرویس
\fBSRV\fR
و سومی دامنه مورد جستجو در نظر گرفته می‌شود\&. در این حالت، یک جستجوی کامل به سبک DNS\-SD برای رکوردهای
\fBSRV\fR
و
\fBTXT\fR
اجرا می‌شود\&. اگر تنها دو پارامتر مشخص شوند، اولی به عنوان نوع سرویس
\fBSRV\fR
و دومی به عنوان دامنه مورد جستجو در نظر گرفته می‌شود\&. در این حالت، هیچ رکورد منبع
\fBTXT\fR
درخواست نمی‌شود\&. در نهایت، اگر فقط یک پارامتر مشخص شود، به عنوان نام دامنه‌ای که پیشوند نوع
\fBSRV\fR
به آن اضافه شده در نظر گرفته می‌شود و یک جستجوی
\fBSRV\fR
انجام می‌گیرد (بدون
\fBTXT\fR)\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBopenpgp\fR \fIEMAIL@DOMAIN\fR\&...
.RS 4
پرس‌وجوی کلیدهای PGP ذخیره‌شده به عنوان رکوردهای منبع
\fBOPENPGPKEY\fR،
به
\m[blue]\fBRFC 7929\fR\m[]\&\s-2\u[3]\d\s+2
مراجعه کنید\&. آدرس‌های ایمیل مشخص‌شده به نام دامنه متناظر DNS تبدیل شده و هرگونه کلید
\fBOPENPGPKEY\fR
چاپ می‌شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBtlsa\fR [\fIFAMILY\fR] \fIDOMAIN\fR[:\fIPORT\fR]\&...
.RS 4
پرس‌وجوی کلیدهای عمومی TLS ذخیره‌شده به عنوان رکوردهای منبع
\fBTLSA\fR،
به
\m[blue]\fBRFC 6698\fR\m[]\&\s-2\u[4]\d\s+2
مراجعه کنید\&. یک پرس‌وجو برای هر یک از نام‌های مشخص‌شده با پیشوند درگاه و خانواده ("_\fIport\fR\&._\fIfamily\fR\&.\fIdomain\fR") انجام خواهد شد\&. شماره درگاه می‌تواند پس از دونقطه (":") مشخص شود، در غیر این صورت به‌طور پیشفرض از
\fB443\fR
استفاده خواهد شد\&. خانواده پروتکل را می‌توان به عنوان آرگومان نخست مشخص کرد، در غیر این صورت از
\fBtcp\fR
استفاده خواهد شد\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBstatus\fR [\fILINK\fR\&...]
.RS 4
تنظیمات سراسری و به ازای هر پیوند DNS را که در حال حاضر فعال هستند نمایش می‌دهد\&. اگر هیچ دستوری مشخص نشود، این حالت پیشفرض ضمنی است\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBstatistics\fR
.RS 4
آمار عمومی تفکیک‌کننده را نمایش می‌دهد، از جمله اطلاعاتی مبنی بر اینکه آیا DNSSEC فعال و در دسترس است یا خیر، و همچنین آمار تفکیک و اعتبارسنجی\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBreset\-statistics\fR
.RS 4
شمارنده‌های آماری نمایش‌داده‌شده در
\fBstatistics\fR
را صفر می‌کند\&. این عملیات نیازمند اختیارات ریشه (root) است\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBflush\-caches\fR
.RS 4
تمام حافظه‌های نهان رکوردهای منبع DNS را که سرویس به‌طور محلی نگهداری می‌کند پاکسازی می‌کند\&. این امر تا حد زیادی معادل ارسال سیگنال
\fBSIGUSR2\fR
به سرویس
\fBsystemd\-resolved\fR
است\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBreset\-server\-features\fR
.RS 4
تمام اطلاعات سطح ویژگی‌هایی را که تفکیک‌کننده درباره سرورهای خاص آموخته است پاک می‌کند و اطمینان حاصل می‌کند که منطق کاوش ویژگی‌های سرور با درخواست جستجوی بعدی از ابتدا آغاز شود\&. این کار تا حد زیادی معادل ارسال سیگنال
\fBSIGRTMIN+1\fR
به سرویس
\fBsystemd\-resolved\fR
است\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBdns\fR [\fILINK\fR [\fISERVER\fR\&...]], \fBdomain\fR [\fILINK\fR [\fIDOMAIN\fR\&...]], \fBdefault\-route\fR [\fILINK\fR [\fIBOOL\fR\&...]], \fBllmnr\fR [\fILINK\fR [\fIMODE\fR]], \fBmdns\fR [\fILINK\fR [\fIMODE\fR]], \fBdnssec\fR [\fILINK\fR [\fIMODE\fR]], \fBdnsovertls\fR [\fILINK\fR [\fIMODE\fR]], \fBnta\fR [\fILINK\fR [\fIDOMAIN\fR\&...]]
.RS 4
دریافت/تنظیم پیکربندی DNS به ازای هر رابط شبکه\&. این دستورات می‌توانند برای پیکربندی تنظیمات گوناگون DNS برای رابط‌های شبکه استفاده شوند\&. همچنین می‌توان از آن‌ها برای آگاه ساختن
\fBsystemd\-resolved\fR
یا
\fBsystemd\-networkd\fR
از پیکربندی DNS به ازای رابط که از طریق روش‌های خارجی تعیین شده‌اند استفاده کرد\&. دستور
\fBdns\fR
منتظر مشخصات آدرس‌های IPv4 یا IPv6 سرورهای DNS مورد استفاده است\&. هر آدرس می‌تواند به‌طور اختیاری یک شماره درگاه جداشده با
":"،
یک نام یا شاخص رابط شبکه جداشده با
"%"،
و یک SNI (شناسه نام سرور) جداشده با
"#"
داشته باشد\&. هنگامی که آدرس IPv6 به همراه شماره درگاه مشخص می‌شود، آدرس باید داخل براکت قرار گیرد\&. به این معنی که قالب‌های کامل و قابل قبول عبارتند از
"111\&.222\&.333\&.444:9953%ifname#example\&.com"
برای IPv4 و
"[1111:2222::3333]:9953%ifname#example\&.com"
برای IPv6\&. دستور
\fBdomain\fR
منتظر دامنه‌های معتبر DNS است، که احتمالاً با پیشوند
"~"
همراه هستند، و یک دامنه جستجو یا دامنه صرفاً-مسیریابی را به ازای هر رابط پیکربندی می‌کند\&. دستور
\fBdefault\-route\fR
یک پارامتر بولی می‌پذیرد و تعیین می‌کند که آیا می‌توان از پیوند به عنوان مسیر پیشفرض برای جستجوهای DNS استفاده کرد یا خیر، یعنی آیا برای جستجو در دامنه‌هایی که هیچ پیوند دیگری صریحاً برای آن‌ها پیکربندی نشده مناسب است یا نه\&. دستورات
\fBllmnr\fR،
\fBmdns\fR،
\fBdnssec\fR
و
\fBdnsovertls\fR
می‌توانند برای پیکربندی تنظیمات LLMNR، MulticastDNS، DNSSEC و DNSOverTLS به ازای هر رابط استفاده شوند\&. در نهایت، دستور
\fBnta\fR
می‌تواند برای پیکربندی دامنه‌های اضافی NTA مربوط به DNSSEC به ازای هر رابط استفاده شود\&.
.sp
دستورات
\fBdns\fR،
\fBdomain\fR
و
\fBnta\fR
می‌توانند یک آرگومان رشته خالی منفرد را برای پاک کردن فهرست مقادیر مربوطه خود بپذیرند\&.
.sp
برای جزئیات درباره این تنظیمات، مقادیر ممکن و تأثیرات آن‌ها، به تنظیمات متناظر در
\fBsystemd.network\fR(5)
مراجعه کنید\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBrevert \fR\fB\fILINK\fR\fR
.RS 4
بازگردانی پیکربندی DNS به ازای هر رابط\&. اگر پیکربندی DNS بازگردانی شود، تمامی تنظیمات DNS به ازای هر رابط به مقادیر پیشفرض خود بازنشانی می‌شوند و تمام اثرات دستورات
\fBdns\fR،
\fBdomain\fR،
\fBdefault\-route\fR،
\fBllmnr\fR،
\fBmdns\fR،
\fBdnssec\fR،
\fBdnsovertls\fR
و
\fBnta\fR
خنثی می‌گردد\&. توجه داشته باشید که وقتی یک رابط شبکه ناپدید می‌شود، تمام پیکربندی‌ها به‌طور خودکار از بین می‌روند و در این حالت نیازی به بازگردانی صریح نیست\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fBmonitor\fR
.RS 4
نمایش یک جریان پیوسته از پرس‌وجوهای تفکیک کلاینت‌های محلی و پاسخ‌های آن‌ها\&. هر زمان که یک پرس‌وجوی محلی تکمیل شود، کلید جستجوی منبع DNS و رکوردهای منبع مربوط به آن پرس‌وجو نشان داده می‌شوند\&. توجه داشته باشید که این دستور تنها پرس‌وجوهای صادرشده به‌صورت محلی را نمایش می‌دهد و مستقیماً به درخواست‌های DNS ارسال‌شده به سرورهای DNS پیکربندی‌شده یا نواحی LLMNR یا MulticastDNS مربوط نمی‌شود، چرا که ممکن است به جستجوها از حافظه نهان محلی پاسخ داده شود، یا اینکه منجر به چندین تبادل DNS گردد (به عنوان مثال برای اعتبارسنجی اطلاعات DNSSEC)\&. در صورتی که زنجیره‌های بازهدایت CNAME/CNAME دنبال شوند، یک پرس‌وجوی جداگانه برای هر عنصر از زنجیره نمایش داده خواهد شد\&. از
\fB\-\-json=\fR
برای فعال‌سازی خروجی JSON استفاده کنید\&.
.sp
اضافه‌شده در نسخه 252\&.
.RE
.PP
\fBshow\-cache\fR
.RS 4
نمایش محتوای فعلی حافظه نهان، به ازای هر حوزه (scope)\&. از
\fB\-\-json=\fR
برای فعال‌سازی خروجی JSON استفاده کنید\&.
.sp
اضافه‌شده در نسخه 254\&.
.RE
.PP
\fBshow\-server\-state\fR
.RS 4
نمایش اطلاعات تفصیلی وضعیت سرور، به ازای هر سرور DNS\&. از
\fB\-\-json=\fR
برای فعال‌سازی خروجی JSON استفاده کنید\&.
.sp
اضافه‌شده در نسخه 255\&.
.RE
.PP
\fBlog\-level\fR [\fILEVEL\fR]
.RS 4
اگر هیچ آرگومانی داده نشود، سطح ثبت گزارش فعلی مدیر را چاپ می‌کند\&. اگر یک آرگومان اختیاری
\fILEVEL\fR
ارائه شود، دستور سطح گزارش‌گیری فعلی مدیر را به
\fILEVEL\fR
تغییر می‌دهد (همان مقادیر شرح‌داده‌شده برای
\fB\-\-log\-level=\fR
در
\fBsystemd\fR(1)
را می‌پذیرد)\&.
.sp
اضافه‌شده در نسخه 244\&.
.RE
.SH "گزینهها (OPTIONS)"
.PP
\fB\-4\fR, \fB\-6\fR
.RS 4
به‌طور پیشفرض، هنگام تفکیک نام میزبان، هر دو آدرس IPv4 و IPv6 دریافت می‌شوند\&. با مشخص کردن
\fB\-4\fR
تنها آدرس‌های IPv4 و با مشخص کردن
\fB\-6\fR
تنها آدرس‌های IPv6 درخواست می‌شوند\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-i\fR \fIINTERFACE\fR, \fB\-\-interface=\fR\fB\fIINTERFACE\fR\fR
.RS 4
رابط شبکه‌ای را برای اجرای پرس‌وجو روی آن مشخص می‌کند\&. این مقدار را می‌توان به صورت شاخص عددی رابط یا رشته نام رابط شبکه (مانند
"en0")
مشخص کرد\&. توجه داشته باشید که اگر از پیکربندی سرتاسری سیستم برای DNS (همان‌گونه که در
/etc/resolv\&.conf
یا
/etc/systemd/resolved\&.conf
پیکربندی شده است) به جای پیکربندی به ازای پیوند استفاده شود، این گزینه هیچ اثری نخواهد داشت\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-p\fR \fIPROTOCOL\fR, \fB\-\-protocol=\fR\fB\fIPROTOCOL\fR\fR
.RS 4
پروتکل شبکه را برای پرس‌وجو تعیین می‌کند\&. می‌تواند یکی از مقادیر زیر باشد:
"dns"
(یعنی DNS تک‌پخشی سنتی)،
"llmnr"
(\m[blue]\fBLink\-Local Multicast Name Resolution\fR\m[]\&\s-2\u[5]\d\s+2)،
"llmnr\-ipv4"،
"llmnr\-ipv6"
(پروتکل LLMNR از طریق پروتکل‌های IP پایه‌ای مشخص‌شده)،
"mdns"
(\m[blue]\fBMulticast DNS\fR\m[]\&\s-2\u[6]\d\s+2)،
"mdns\-ipv4"،
"mdns\-ipv6"
(پروتکل MDNS از طریق پروتکل‌های IP پایه‌ای مشخص‌شده)\&. به‌طور پیشفرض، جستجو از طریق تمام پروتکل‌های مناسب برای جستجو انجام می‌شود\&. در صورت استفاده، مجموعه پروتکل‌هایی را که می‌توانند استفاده شوند محدود می‌کند\&. از این گزینه چند بار برای فعال‌سازی تفکیک هم‌زمان از طریق چند پروتکل استفاده کنید\&. تنظیم
"llmnr"
همانند مشخص کردن این سوییچ یک‌بار با
"llmnr\-ipv4"
و یک‌بار با
"llmnr\-ipv6"
است\&. توجه داشته باشید که این گزینه سرویس را وادار به تفکیک عملیات با پروتکل مشخص‌شده نمی‌کند، زیرا ممکن است نیازمند یک رابط شبکه و پیکربندی مناسب باشد\&. مقدار ویژه
"help"
می‌تواند برای فهرست کردن مقادیر شناخته‌شده استفاده شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-t\fR \fITYPE\fR, \fB\-\-type=\fR\fB\fITYPE\fR\fR, \fB\-c\fR \fICLASS\fR, \fB\-\-class=\fR\fB\fICLASS\fR\fR
.RS 4
هنگامی که همراه با دستور
\fBquery\fR
استفاده شود، نوع رکورد منبع DNS (مانند
\fBA\fR،
\fBAAAA\fR،
\fBMX\fR
و غیره) و کلاس (مانند
\fBIN\fR،
\fBANY\fR
و غیره) را برای جستجو تعیین می‌کند\&. در صورت استفاده از این گزینه‌ها، یک مجموعه از رکوردهای منبع DNS منطبق با کلاس و نوع مشخص‌شده درخواست می‌شود\&. اگر تنها نوع مشخص شود، کلاس به‌طور پیشفرض به
\fBIN\fR
تنظیم می‌گردد\&. مقدار ویژه
"help"
می‌تواند برای فهرست کردن مقادیر شناخته‌شده استفاده شود\&.
.sp
بدون این گزینه‌ها، دستور
\fBresolvectl query\fR
تفکیک سطح بالای نام دامنه به آدرس و آدرس به نام دامنه را فراهم می‌کند\&. با این گزینه‌ها، تفکیک سطح پایین رکوردهای منبع DNS را فراهم می‌آورد\&. هنگام استفاده از این گزینه‌ها، منطق دامنه جستجو به‌طور خودکار غیرفعال می‌شود، بدین معنی که نام‌های دامنه مشخص‌شده باید نام‌های دامنه کاملاً واجد شرایط (FQDN) باشند\&. علاوه بر این، ترجمه داخلی نام دامنه بر اساس IDNA نیز خاموش می‌شود، یعنی نام‌های دامنه بین‌المللی باید با نمادگذاری
"xn\-\-\&..."
مشخص شوند، مگر اینکه جستجو در MulticastDNS/LLMNR مد نظر باشد، که در این حالت باید از نویسه‌های UTF\-8 استفاده شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-service\-address=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی دریافت می‌کند\&. اگر درست باشد (پیشفرض)، هنگام انجام جستجوی سرویس با
\fB\-\-service\fR
نام‌های میزبان موجود در رکوردهای منبع
\fBSRV\fR
نیز تفکیک می‌شوند\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-service\-txt=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی دریافت می‌کند\&. اگر درست باشد (پیشفرض)، هنگام انجام جستجوی سرویس DNS\-SD با
\fB\-\-service\fR
رکورد متاداده سرویس
\fBTXT\fR
نیز تفکیک می‌شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-cname=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی دریافت می‌کند\&. اگر درست باشد (پیشفرض)، بازهدایت‌های DNS از نوع
\fBCNAME\fR
یا
\fBDNAME\fR
دنبال می‌شوند\&. در غیر این صورت، چنانچه هنگام تفکیک به یک رکورد CNAME یا DNAME برخورد شود، یک خطا بازگردانده می‌شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-validate=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ همراه با
\fBquery\fR
استفاده می‌شود\&. اگر درست باشد (پیشفرض)، اعتبارسنجی DNSSEC طبق روال معمول اعمال می‌شود \(em به شرط آنکه هم برای شبکه و هم برای کل
systemd\-resolved\&.service
فعال باشد\&. اگر نادرست باشد، اعتبارسنجی DNSSEC برای پرس‌وجوی خاص غیرفعال می‌شود، صرف نظر از اینکه برای شبکه یا در سرویس فعال باشد یا خیر\&. توجه داشته باشید که تنظیم این گزینه به درست، اعتبارسنجی DNSSEC را در سیستم‌ها/شبکه‌هایی که DNSSEC خاموش است اجباری نمی‌سازد\&. این گزینه صرفاً برای غیرفعال کردن چنین اعتبارسنجی در جایی که قبلاً فعال بوده مناسب است، نه فعال کردن اعتبارسنجی در جایی که پیش‌تر غیرفعال بوده است\&.
.sp
اضافه‌شده در نسخه 248\&.
.RE
.PP
\fB\-\-synthesize=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ همراه با
\fBquery\fR
استفاده می‌شود\&. اگر درست باشد (پیشفرض)، دامنه‌های منتخبی روی سیستم محلی تفکیک می‌شوند، از جمله
"localhost"،
"_gateway"،
"_outbound"،
"_localdnsstub"
و
"_localdnsproxy"
یا ورودی‌های برگرفته از
/etc/hosts\&.
اگر نادرست باشد، این دامنه‌ها به‌صورت محلی تفکیک نمی‌شوند و یا با شکست مواجه می‌شوند (در مورد
"localhost"،
"_gateway"
یا
"_outbound"
و نظایر آن‌ها) یا از طریق جستجوهای معمولی DNS/mDNS/LLMNR به شبکه هدایت می‌شوند (در مورد ورودی‌های
/etc/hosts)\&.
.sp
اضافه‌شده در نسخه 248\&.
.RE
.PP
\fB\-\-cache=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی دریافت می‌کند؛ در ترکیب با
\fBquery\fR
به کار می‌رود\&. اگر درست باشد (پیشفرض)، جستجوها از حافظه نهان رکوردهای منبع DNS محلی استفاده می‌کنند\&. اگر نادرست باشد، جستجوها به شبکه ارسال می‌شوند، بدون توجه به اینکه آیا قبلاً در حافظه نهان محلی در دسترس بوده‌اند یا خیر\&.
.sp
اضافه‌شده در نسخه 248\&.
.RE
.PP
\fB\-\-zone=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ در ترکیب با
\fBquery\fR
به کار می‌رود\&. اگر درست باشد (پیشفرض)، در صورت تعریف، به جستجوها از طریق رکوردهای منبع LLMNR یا mDNS که به‌طور محلی ثبت شده‌اند پاسخ داده می‌شود\&. اگر نادرست باشد، رکوردهای LLMNR/mDNS ثبت‌شده محلی برای درخواست جستجو در نظر گرفته نمی‌شوند\&.
.sp
اضافه‌شده در نسخه 248\&.
.RE
.PP
\fB\-\-trust\-anchor=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ همراه با
\fBquery\fR
به کار می‌رود\&. اگر درست باشد (پیشفرض)، جستجوها برای رکوردهای DS و DNSKEY در صورت امکان از پایه‌های اعتماد DNSSEC محلی پاسخ داده می‌شوند\&. اگر نادرست باشد، مخزن اعتماد محلی برای درخواست جستجو در نظر گرفته نمی‌شود\&.
.sp
اضافه‌شده در نسخه 248\&.
.RE
.PP
\fB\-\-network=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ همراه با
\fBquery\fR
استفاده می‌شود\&. اگر درست باشد (پیشفرض)، جستجوها در صورتی که نتوانند به‌طور محلی ساخته شوند، یا از حافظه نهان محلی، ناحیه (zone) یا پایه‌های اعتماد (به بالا مراجعه کنید) پاسخ داده شوند، از طریق درخواست‌های شبکه DNS، LLMNR یا mDNS پاسخ داده می‌شوند\&. اگر نادرست باشد، درخواست از طریق شبکه پاسخ داده نمی‌شود و بنابراین اگر هیچ‌یک از منابع ذکرشده نتوانند به آن پاسخ دهند، با شکست مواجه خواهد شد\&.
.sp
اضافه‌شده در نسخه 248\&.
.RE
.PP
\fB\-\-search=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌پذیرد\&. اگر درست باشد (پیشفرض)، هر نام میزبان تک‌برچسبی مشخص‌شده در دامنه‌های پیکربندی‌شده در فهرست دامنه‌های جستجو (در صورت خالی نبودن) جستجو خواهد شد\&. در غیر این صورت، منطق دامنه جستجو غیرفعال می‌شود\&. توجه داشته باشید که این گزینه در صورت استفاده از
\fB\-\-type=\fR
(به بالا مراجعه کنید) هیچ تأثیری ندارد، چرا که در این حالت منطق دامنه جستجو بدون قید و شرط خاموش می‌شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-raw\fR[=payload|packet]
.RS 4
تخلیه رکوردهای پاسخ به صورت داده‌های باینری\&. اگر هیچ آرگومانی وجود نداشته باشد یا اگر آرگومان
"payload"
باشد، بار داده (payload) مربوط به داده‌های رکورد منبع صادر می‌شود، یعنی نه کل "RDATA"، بلکه صرفاً محتوای اصلی\&. اگر آرگومان
"packet"
باشد، کل رکورد منبع در قالب سیم (wire format) تخلیه می‌شود که طول آن به عنوان یک عدد صحیح ۶۴ بیتی little-endian پیشوند شده است\&. این قالب امکان تخلیه و تجزیه بدون ابهام چندین رکورد را فراهم می‌کند\&.
.sp
توجه داشته باشید که
"payload"
تنها برای زیرمجموعه کوچکی از انواع رکوردهای منبع پشتیبانی می‌شود: SSHFP، TLSA و OPENPGPKEY که در آن‌ها فقط داده‌های کلید تخلیه می‌شوند؛ و رکوردهای A و AAAA که داده‌های آدرس را تخلیه می‌کنند\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-legend=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد\&. اگر درست باشد (پیشفرض)، سرایندهای ستون‌ها و اطلاعات فراداده درباره پاسخ پرس‌وجو نمایش داده می‌شوند\&. در غیر این صورت، این خروجی نادیده گرفته و پنهان می‌شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-stale\-data=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ همراه با
\fBquery\fR
استفاده می‌شود\&. اگر درست باشد (پیشفرض)، در صورت امکان به جستجوها با داده‌های بیات (رکوردهای منبع منقضی‌شده) پاسخ داده می‌شود\&. اگر نادرست باشد، داده‌های بیات برای درخواست جستجو در نظر گرفته نمی‌شوند\&.
.sp
اضافه‌شده در نسخه 254\&.
.RE
.PP
\fB\-\-relax\-single\-label=\fR\fB\fIBOOL\fR\fR
.RS 4
یک پارامتر بولی می‌گیرد؛ در ترکیب با
\fBquery\fR
استفاده می‌شود\&. اگر درست باشد، قوانین حاکم بر مسیریابی نام‌های تک‌برچسبی تسهیل می‌شوند\&. مقدار پیشفرض نادرست است\&. به‌طور پیشفرض، فرض بر این است که جستجوهای نام‌های تک‌برچسبی به میزبان‌های محلی اشاره دارند که باید از طریق تفکیک محلی مانند LLMNR یا صلاحیت‌سنجی از طریق دامنه جستجو تفکیک شوند و همان‌گونه که هستند به سرورهای بالادست هدایت نمی‌شوند\&. اگر این گزینه فعال شود، این قوانین غیرفعال شده و پرس‌وجوها در هر حال به بالادست ارسال می‌گردند\&. همچنین گزینه
\fIResolveUnicastSingleLabel=\fR
را در
\fBresolved.conf\fR(5)
ببینید که یک گزینه در سطح سیستم برای کنترل این رفتار فراهم می‌کند\&.
.sp
اضافه‌شده در نسخه 256\&.
.RE
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
برای انجام عملیات‌های دارای دسترسی ویژه، از کاربر برای احراز هویت سوال نمی‌پرسد\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
خروجی را در قالب JSON نمایش می‌دهد\&. یکی از مقادیر زیر را می‌پذیرد:
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ‌گونه فاصله خالی یا خط شکسته اضافی)،
"pretty"
(برای نسخه‌ای خوانا و زیبا از همان داده‌ها، همراه با دندانه‌گذاری و خطوط شکسته) یا
"off"
(برای خاموش کردن خروجی JSON، که حالت پیشفرض است)\&.
.RE
.PP
\fB\-j\fR
.RS 4
در صورت اجرا در ترمینال، معادل
\fB\-\-json=pretty\fR
و در غیر این صورت معادل
\fB\-\-json=short\fR
است\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن کوتاه راهنما را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه مربوط به نسخه برنامه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "سازگاری با RESOLVCONF(8) (COMPATIBILITY WITH RESOLVCONF(8))"
.PP
دستور
\fBresolvectl\fR
یک باینری چندکاره (multi-call binary) است\&. هنگامی که با نام
"resolvconf"
فراخوانی شود (که عموماً از طریق یک پیوند نمادین با این نام به فایل باینری
\fBresolvectl\fR
حاصل می‌گردد)، در یک حالت محدود سازگاری با
\fBresolvconf\fR(8)
اجرا می‌شود\&. این دستور بیشتر همان آرگومان‌ها را می‌پذیرد و تمام داده‌ها را به
\fBsystemd-resolved.service\fR(8)
ارسال می‌کند، درست مشابه شیوه عملکرد دستورات
\fBdns\fR
و
\fBdomain\fR\&.
توجه داشته باشید که
\fBsystemd\-resolved\&.service\fR
تنها بخش پشتیبان (backend) پشتیبانی‌شده است، که با دیگر پیاده‌سازی‌های این دستور تفاوت دارد\&.
.PP
فایل
/etc/resolv\&.conf
تنها زمانی با سرورهای اضافه‌شده توسط این دستور به‌روزرسانی می‌شود که
/etc/resolv\&.conf
یک پیوند نمادین به
/run/systemd/resolve/resolv\&.conf
باشد و نه یک فایل ایستا\&. به بحث پیرامون مدیریت
/etc/resolv\&.conf
در
\fBsystemd-resolved.service\fR(8)
مراجعه نمایید\&.
.PP
تمامی عملیات‌هایی که توسط سایر پیاده‌سازی‌ها پشتیبانی می‌شوند، به‌طور بومی در این دستور پشتیبانی نمی‌گردند\&. به‌طور خاص:
.PP
\fB\-a\fR
.RS 4
داده‌های پیکربندی DNS به ازای هر رابط را در
\fBsystemd\-resolved\fR
ثبت می‌کند\&. یک نام رابط شبکه را به عنوان تنها آرگومان خط فرمان دریافت می‌نماید\&. داده‌های پیکربندی DNS سازگار با
\fBresolv.conf\fR(5)
را از ورودی استاندارد خود می‌خواند\&. فیلدهای مرتبط عبارتند از
"nameserver"
و
"domain"/"search"\&.
این دستور تا حد زیادی معادل اجرای
\fBresolvectl\fR
همراه با ترکیبی از دستورات
\fBdns\fR
و
\fBdomain\fR
است\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-d\fR
.RS 4
داده‌های پیکربندی DNS به ازای هر رابط را از
\fBsystemd\-resolved\fR
حذف (لغو ثبت) می‌کند\&. این دستور تا حد زیادی معادل اجرای
\fBresolvectl revert\fR
است\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-f\fR
.RS 4
در صورت مشخص شدن، گزینه‌های
\fB\-a\fR
و
\fB\-d\fR
در مورد رابط‌های شبکه ناموجود اعتراضی نمی‌کنند و در چنین شرایطی بدون هیچ هشداری هیچ عملیاتی انجام نخواهند داد\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-x\fR
.RS 4
این سوییچ برای عملیات «انحصاری» (exclusive) تنها به‌طور جزئی پشتیبانی می‌شود\&. این سوییچ به یک دامنه جستجوی پیکربندی‌شده اضافه از
"~\&."
نگاشت می‌شود \(em یعنی اطمینان می‌دهد که ترافیک DNS ترجیحاً به سرورهای DNS روی این رابط هدایت شود، مگر آنکه دامنه‌های اختصاصی‌تر دیگری روی رابط‌های دیگر پیکربندی شده باشند\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-p\fR
.RS 4
هنگامی که تعیین شود، رابط مورد نظر به عنوان مسیر پیشفرض استفاده نخواهد شد\&. همچنین به
\fBsystemd-resolved.service\fR(8)
درباره مسیر پیشفرض مراجعه کنید\&.
.sp
اضافه‌شده در نسخه 257\&.
.RE
.PP
\fB\-m\fR
.RS 4
این سوییچ پشتیبانی نمی‌شود و بدون اخطار نادیده گرفته می‌شود\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
\fB\-u\fR, \fB\-I\fR, \fB\-i\fR, \fB\-l\fR, \fB\-R\fR, \fB\-r\fR, \fB\-v\fR, \fB\-V\fR, \fB\-\-enable\-updates\fR, \fB\-\-disable\-updates\fR, \fB\-\-are\-updates\-enabled\fR
.RS 4
این سوییچ‌ها پشتیبانی نمی‌شوند و در صورت استفاده، دستور با شکست مواجه خواهد شد\&.
.sp
اضافه‌شده در نسخه 239\&.
.RE
.PP
برای جزئیات بیشتر درباره این گزینه‌های خط فرمان، به
\fBresolvconf\fR(8)
مراجعه کنید\&.
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، مقدار 0 و در غیر این صورت یک کد خطای غیرصفر بازگردانده می‌شود\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&۱.\ \&واکشی آدرس‌های دامنه "www\&.0pointer\&.net" (رکوردهای منبع A و AAAA)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ resolvectl query www\&.0pointer\&.net
www\&.0pointer\&.net: 2a01:238:43ed:c300:10c3:bcf3:3266:da74
                  85\&.214\&.157\&.71

\-\- Information acquired via protocol DNS in 611\&.6ms\&.
\-\- Data is authenticated: no
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۲.\ \&واکشی دامنه برای آدرس آی‌پی "85\&.214\&.157\&.71" (رکورد منبع PTR)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ resolvectl query 85\&.214\&.157\&.71
85\&.214\&.157\&.71: gardel\&.0pointer\&.net

\-\- Information acquired via protocol DNS in 1\&.2997s\&.
\-\- Data is authenticated: no
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۳.\ \&واکشی رکورد MX مربوط به دامنه "yahoo\&.com"\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ resolvectl \-\-legend=no \-t MX query yahoo\&.com
yahoo\&.com\&. IN MX    1 mta7\&.am0\&.yahoodns\&.net
yahoo\&.com\&. IN MX    1 mta6\&.am0\&.yahoodns\&.net
yahoo\&.com\&. IN MX    1 mta5\&.am0\&.yahoodns\&.net
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۴.\ \&تفکیک یک سرویس SRV\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ resolvectl service _xmpp\-server\&._tcp gmail\&.com
_xmpp\-server\&._tcp/gmail\&.com: alt1\&.xmpp\-server\&.l\&.google\&.com:5269 [priority=20, weight=0]
                             173\&.194\&.210\&.125
                             alt4\&.xmpp\-server\&.l\&.google\&.com:5269 [priority=20, weight=0]
                             173\&.194\&.65\&.125
                             \&...
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۵.\ \&واکشی یک کلید PGP (رکورد منبع OPENPGP)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ resolvectl openpgp zbyszek@fedoraproject\&.org
d08ee310438ca124a6149ea5cc21b6313b390dce485576eff96f8722\&._openpgpkey\&.fedoraproject\&.org\&. IN OPENPGPKEY
        mQINBFBHPMsBEACeInGYJCb+7TurKfb6wGyTottCDtiSJB310i37/6ZYoeIay/5soJjlMyf
        MFQ9T2XNT/0LM6gTa0MpC1st9LnzYTMsT6tzRly1D1UbVI6xw0g0vE5y2Cjk3xUwAynCsSs
        \&...
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۶.\ \&واکشی یک کلید TLS (رکورد منبع TLSA)\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ resolvectl tlsa tcp fedoraproject\&.org:443
_443\&._tcp\&.fedoraproject\&.org IN TLSA 0 0 1 19400be5b7a31fb733917700789d2f0a2471c0c9d506c0e504c06c16d7cb17c0
        \-\- Cert\&. usage: CA constraint
        \-\- Selector: Full Certificate
        \-\- Matching type: SHA\-256
.fi
.if n \{\
.RE
.\}
.PP
گزینه‌های
"tcp"
و
":443"
اختیاری هستند و می‌توان از آن‌ها صرف‌نظر کرد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBsystemd.dnssd\fR(5), \fBsystemd-networkd.service\fR(8), \fBresolvconf\fR(8)
.SH "نکات (NOTES)"
.IP " 1." 4
RFC 6763 DNS-SD
.RS 4
\%https://tools.ietf.org/html/rfc6763
.RE
.IP " 2." 4
RFC 2782 SRV
.RS 4
\%https://tools.ietf.org/html/rfc2782
.RE
.IP " 3." 4
RFC 7929
.RS 4
\%https://tools.ietf.org/html/rfc7929
.RE
.IP " 4." 4
RFC 6698
.RS 4
\%https://tools.ietf.org/html/rfc6698
.RE
.IP " 5." 4
Link-Local Multicast Name Resolution
.RS 4
\%https://tools.ietf.org/html/rfc4795
.RE
.IP " 6." 4
Multicast DNS
.RS 4
\%https://www.ietf.org/rfc/rfc6762.txt
.RE