.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH RESOLVECTL 1 "" "systemd 260.2" resolvectl .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH الاسم resolvectl, resolvconf \- حل أسماء النطاقات، وعناوين IPv4 وIPv6، وسجلات موارد DNS، والخدمات؛ فحص وإعادة تشكيل محلل DNS .SH موجز .HP \w'\fBresolvectl\fR\ 'u \fBresolvectl\fP [خيارات...] {أمر} [اسم...] .SH الوصف .PP يمكن استخدام \fBresolvectl\fP لحل أسماء النطاقات، وعناوين IPv4 وIPv6، وسجلات موارد DNS والخدمات مع خدمة المحلل \fBsystemd\-resolved.service\fP(8)\&. مبدئيًا، تُحل قائمة المعاملات المحددة كأسماء مضيفين، مع استرداد عناوين IPv4 وIPv6 الخاصة بها\&. إذا كانت المعاملات المحددة منسقة كعناوين IPv4 أو IPv6، تُجرى العملية العكسية، ويُسترد اسم مضيف للعناوين المحددة\&. .PP يحتوي مخرج البرنامج على معلومات حول البروتوكول المستخدم للبحث وواجهة الشبكة التي اكتُشفت فيها البيانات\&. يحتوي أيضًا على معلومات حول ما إذا كان يمكن استيثاق المعلومات\&. تُعتبر جميع البيانات التي ينجح فيها التحقق المحلي من DNSSEC موثقة\&. علاوة على ذلك، تُبلغ جميع البيانات القادمة من مصادر محلية موثوقة كموثقة أيضًا، بما في ذلك حل اسم المضيف المحلي، واسم المضيف "localhost" أو جميع البيانات من /etc/hosts\&. .SH الأوامر .PP \fBquery\fP \fIاسم_مضيف|عنوان\fP\&... .RS 4 حل أسماء النطاقات، بالإضافة إلى عناوين IPv4 وIPv6\&. عند استخدامه مع \fB\-\-type=\fP أو \fB\-\-class=\fP (انظر أدناه)، يُحل سجلات موارد DNS منخفضة المستوى\&. .sp إذا حُدد اسم نطاق أحادي التسمية، يُبحث عنه وفقًا لنطاقات البحث المهيأة \(em ما لم يُحدد \fB\-\-search=no\fP أو \fB\-\-type=\fP/\fB\-\-class=\fP، وكلاهما يعطل هذا المنطق\&. .sp إذا حُدد اسم نطاق دولي، يُترجم آليًا وفقًا لقواعد IDNA عند حله عبر DNS الكلاسيكي \(em ولكن ليس للبحث عبر MulticastDNS أو LLMNR\&. إذا استُخدم \fB\-\-type=\fP/\fB\-\-class=\fP، تُعطل ترجمة IDNA وتُعالج أسماء النطاقات كما هو محدد\&. .sp إذا دُمج مع \fB\-\-json=\fP (مدعوم فقط مع \fB\-\-type=\fP)، سيُخرج بيانات سجل المورد في كائن JSON\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBservice\fP [[\fIاسم\fP] \fIنوع\fP] \fIنطاق\fP .RS 4 حل خدمات \m[blue]\fBRFC 6763 DNS\-SD\fP\m[]\&\s-2\u[1]\d\s+2 و \m[blue]\fBRFC 2782 SRV\fP\m[]\&\s-2\u[2]\d\s+2، اعتمادًا على قائمة المعاملات المحددة\&. إذا مُررت ثلاثة معاملات، يُفترض أن الأول هو اسم خدمة DNS\-SD، والثاني نوع خدمة \fBSRV\fP، والثالث النطاق للبحث فيه\&. في هذه الحالة، يُنفذ بحث كامل بنمط DNS\-SD لـ \fBSRV\fP و \fBTXT\fP\&. إذا حُدد معاملان فقط، يُفترض أن الأول هو نوع خدمة \fBSRV\fP، والثاني النطاق للبحث فيه\&. في هذه الحالة، لا يُطلب سجل مورد \fBTXT\fP\&. أخيرًا، إذا حُدد معامل واحد فقط، يُفترض أنه اسم نطاق مسبوق بنوع \fBSRV\fP، ويُجرى بحث \fBSRV\fP (بدون \fBTXT\fP)\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBopenpgp\fP \fIبريد@نطاق\fP\&... .RS 4 الاستعلام عن مفاتيح PGP المخزنة كسجلات مورد \fBOPENPGPKEY\fP، انظر \m[blue]\fBRFC 7929\fP\m[]\&\s-2\u[3]\d\s+2\&. تُحول عناوين البريد الإلكتروني المحددة إلى اسم نطاق DNS المقابل، وتُطبع أي مفاتيح \fBOPENPGPKEY\fP\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBtlsa\fP [\fIعائلة\fP] \fIنطاق\fP[:\fIمنفذ\fP]\&... .RS 4 الاستعلام عن مفاتيح TLS العامة المخزنة كسجلات مورد \fBTLSA\fP، انظر \m[blue]\fBRFC 6698\fP\m[]\&\s-2\u[4]\d\s+2\&. يُجرى استعلام لكل من الأسماء المحددة المسبوقة بالمنفذ والعائلة ("_\fIمنفذ\fP\&._\fIعائلة\fP\&.\fIنطاق\fP")\&. يمكن تحديد رقم المنفذ بعد نقطتين (":")، وإلا سيُستخدم \fB443\fP مبدئيًا\&. يمكن تحديد العائلة كوسيطة أولى، وإلا سيُستخدم \fBtcp\fP\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBstatus\fP [\fIرابط\fP\&...] .RS 4 يعرض إعدادات DNS العامة وحسب الرابط السارية حاليًا\&. إذا لم يُحدد أمر، فهذا هو المبدئي الضمني\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBstatistics\fP .RS 4 يعرض إحصائيات المحلل العامة، بما في ذلك معلومات حول ما إذا كان DNSSEC مفعلًا ومتاحًا، بالإضافة إلى إحصائيات الحل والتحقق\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBreset\-statistics\fP .RS 4 يعيد تعيين عدادات الإحصائيات المعروضة في \fBstatistics\fP إلى الصفر\&. تتطلب هذه العملية صلاحيات الجذر\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBflush\-caches\fP .RS 4 يمسح جميع خبائن سجلات مورد DNS التي تحتفظ بها الخدمة محليًا\&. هذا مكافئ إلى حد كبير لإرسال \fBSIGUSR2\fP إلى خدمة \fBsystemd\-resolved\fP\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBreset\-server\-features\fP .RS 4 يمسح جميع معلومات مستوى الميزات التي تعلمها الحلال عن خوادم محددة، ويضمن بدء منطق استقصاء ميزات الخادم من البداية مع طلب البحث التالي\&. هذا يعادل إلى حد كبير إرسال \fBSIGRTMIN+1\fP إلى خدمة \fBsystemd\-resolved\fP\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBdns\fP [\fILINK\fP [\fISERVER\fP\&...]], \fBdomain\fP [\fILINK\fP [\fIDOMAIN\fP\&...]], \fBdefault\-route\fP [\fILINK\fP [\fIBOOL\fP\&...]], \fBllmnr\fP [\fILINK\fP [\fIMODE\fP]], \fBmdns\fP [\fILINK\fP [\fIMODE\fP]], \fBdnssec\fP [\fILINK\fP [\fIMODE\fP]], \fBdnsovertls\fP [\fILINK\fP [\fIMODE\fP]], \fBnta\fP [\fILINK\fP [\fIDOMAIN\fP\&...]] .RS 4 يحصل/يضبط إعدادات DNS لكل واجهة\&. قد تُستخدم هذه الأوامر لتهيئة إعدادات DNS متنوعة لواجهات الشبكة\&. قد تُستخدم هذه الأوامر لإعلام \fBsystemd\-resolved\fP أو \fBsystemd\-networkd\fP بإعدادات DNS لكل واجهة المحددة عبر وسائل خارجية\&. يتوقع أمر \fBdns\fP مواصفات عنوان IPv4 أو IPv6 لخوادم DNS المستخدمة\&. يمكن لكل عنوان أن يأخذ اختيارياً رقم منفذ مفصولاً بـ ":"، واسم واجهة شبكة أو فهرس مفصولاً بـ "%"، وإشارة اسم خادم (SNI) مفصولة بـ "#"\&. عند تحديد عنوان IPv6 برقم منفذ، يجب أن يكون العنوان بين قوسين مربعين\&. أي أن الصيغ الكاملة المقبولة هي "111\&.222\&.333\&.444:9953%ifname#example\&.com" لـ IPv4 و"[1111:2222::3333]:9953%ifname#example\&.com" لـ IPv6\&. يتوقع أمر \fBdomain\fP نطاقات DNS صالحة، ربما مسبوقة بـ "~"، ويضبط نطاق بحث أو نطاق توجيه فقط لكل واجهة\&. يتوقع أمر \fBdefault\-route\fP معلمة منطقية، ويضبط ما إذا كان يمكن استخدام الوصلة كمسار مبدئي لاستعلامات DNS، أي إذا كانت مناسبة لاستعلامات النطاقات التي لم تُضبط لها وصلة أخرى صراحة\&. قد تُستخدم أوامر \fBllmnr\fP و\fBmdns\fP و\fBdnssec\fP و\fBdnsovertls\fP لتهيئة إعدادات LLMNR وMulticastDNS وDNSSEC وDNSOverTLS لكل واجهة\&. أخيراً، قد يُستخدم أمر \fBnta\fP لتهيئة نطاقات NTA إضافية لـ DNSSEC لكل واجهة\&. .sp يمكن لأوامر \fBdns\fP و\fBdomain\fP و\fBnta\fP أن تأخذ وسيطة سلسلة فارغة واحدة لمسح قوائم القيم الخاصة بها\&. .sp للتفاصيل حول هذه الإعدادات، وقيمها الممكنة وتأثيرها، انظر الإعدادات المقابلة في \fBsystemd.network\fP(5)\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBrevert \fP\fILINK\fP .RS 4 يعيد إعدادات DNS لكل واجهة\&. إذا أُعيدت إعدادات DNS، تُعاد جميع إعدادات DNS لكل واجهة إلى مبدئياتها، مما يلغي جميع تأثيرات \fBdns\fP و\fBdomain\fP و\fBdefault\-route\fP و\fBllmnr\fP و\fBmdns\fP و\fBdnssec\fP و\fBdnsovertls\fP و\fBnta\fP\&. لاحظ أنه عندما تختفي واجهة شبكة، تُفقد جميع الإعدادات آلياً، ولا حاجة لإعادة صريحة في تلك الحالة\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fBmonitor\fP .RS 4 يعرض تياراً مستمراً من استعلامات الحل للعميل المحلي واستجاباتها\&. عند اكتمال استعلام محلي، يُظهر مفتاح بحث مورد DNS وسجلات المورد للاستعلام\&. لاحظ أن هذا يعرض الاستعلامات الصادرة محلياً فقط، ولا يرتبط فوراً بطلبات DNS المقدمة إلى خوادم DNS المهيأة أو نطاقات LLMNR أو MulticastDNS، حيث قد تُجاب الاستعلامات من الخبيئة المحلية، أو قد تؤدي إلى معاملات DNS متعددة (مثلاً للتحقق من معلومات DNSSEC)\&. إذا تبعتها سلاسل إعادة توجيه CNAME/CNAME، فسيُعرض استعلام منفصل لكل عنصر من السلسلة\&. استخدم \fB\-\-json=\fP لتمكين إخراج JSON\&. .sp أُضيف في الإصدار 252\&. .RE .PP \fBshow\-cache\fP .RS 4 يعرض محتوى الخبيئة الحالي، لكل نطاق\&. استخدم \fB\-\-json=\fP لتمكين إخراج JSON\&. .sp أُضيف في الإصدار 254\&. .RE .PP \fBshow\-server\-state\fP .RS 4 يعرض معلومات حالة خادم مفصلة، لكل خادم DNS\&. استخدم \fB\-\-json=\fP لتمكين إخراج JSON\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fBlog\-level\fP [\fIالمستوى\fP] .RS 4 إذا لم تُعطَ أي وسيطة، اطبع مستوى السجل الحالي للمدير\&. إذا وُفرت وسيطة اختيارية \fILEVEL\fP، فسيقوم الأمر بتغيير مستوى السجل الحالي للمدير إلى \fILEVEL\fP (يقبل نفس القيم الخاصة بـ \fB\-\-log\-level=\fP الموضحة في \fBsystemd\fP(1))\&. .sp أُضيف في الإصدارة 244\&. .RE .SH الخيارات .PP \fB\-4\fP، \fB\-6\fP .RS 4 مبدئياً، عند حل اسم مضيف، تُحصل عناوين IPv4 وIPv6 معاً\&. بتحديد \fB\-4\fP، تُطلب عناوين IPv4 فقط، وببتحديد \fB\-6\fP، تُطلب عناوين IPv6 فقط\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-i\fP \fIINTERFACE\fP, \fB\-\-interface=\fP\fIINTERFACE\fP .RS 4 يحدد واجهة الشبكة لتنفيذ الاستعلام عليها\&. قد يُحدد هذا إما كفهرس واجهة رقمي أو كسلسلة واجهة شبكة (مثل "en0")\&. لاحظ أن هذا الخيار ليس له تأثير إذا استُخدم إعداد DNS على مستوى النظام (كما هو مهيأ في /etc/resolv\&.conf أو /etc/systemd/resolved\&.conf) بدلاً من إعداد لكل وصلة\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-p\fP \fIPROTOCOL\fP, \fB\-\-protocol=\fP\fIPROTOCOL\fP .RS 4 يحدد بروتوكول الشبكة للاستعلام\&. قد يكون واحداً من "dns" (أي DNS أحادي الإرسال الكلاسيكي)، أو "llmnr" (\m[blue]\fBحل اسم البث المتعدد على الوصلة المحلية\fP\m[]\&\s-2\u[5]\d\s+2)، أو "llmnr\-ipv4"، أو "llmnr\-ipv6" (LLMNR عبر بروتوكولات IP الأساسية المشار إليها)، أو "mdns" (\m[blue]\fBDNS متعدد الإرسال\fP\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\fP \fITYPE\fP, \fB\-\-type=\fP\fITYPE\fP, \fB\-c\fP \fICLASS\fP, \fB\-\-class=\fP\fICLASS\fP .RS 4 عند استخدامه مع أمر \fBquery\fP، يحدد نوع سجل مورد DNS (مثل \fBA\fP و\fBAAAA\fP و\fBMX\fP، \&...) وفئته (مثل \fBIN\fP و\fBANY\fP، \&...) للبحث\&. إذا استُخدمت هذه الخيارات، يُطلب مجموعة سجلات مورد DNS مطابقة للفئة والنوع المحددين\&. الفئة المبدئية هي \fBIN\fP إذا حُدد نوع فقط\&. قد تُستخدم القيمة الخاصة "help" لسرد القيم المعروفة\&. .sp بدون هذه الخيارات، يوفر \fBresolvectl query\fP حلاً عالي المستوى من اسم نطاق إلى عنوان ومن عنوان إلى اسم نطاق\&. مع هذه الخيارات، يوفر حلاً منخفض المستوى لسجلات مورد DNS\&. يُوقف منطق نطاق البحث آلياً عند استخدام هذه الخيارات، أي أن أسماء النطاقات المحددة يجب أن تكون أسماء نطاقات مؤهلة بالكامل\&. علاوة على ذلك، تُوقف ترجمة اسم النطاق الداخلي IDNA أيضًا، أي يجب تحديد أسماء النطاقات الدولية بترميز "xn\-\-\&..."، ما لم يكن البحث في MulticastDNS/LLMNR مرغوباً، وفي هذه الحالة يجب استخدام أحرف UTF\-8\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-service\-address=\fP\fIBOOL\fP .RS 4 يستقبل معلمة منطقية\&. إذا كانت القيمة ”صحيح“ (القيمة الافتراضية)، فعند البحث عن خدمة باستخدام \fB\-\-service\fP، يتم تحويل أسماء المضيفين الموجودة في سجلات الموارد \fBSRV\fP أيضًا\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-service\-txt=\fP\fIBOOL\fP .RS 4 يستقبل معلمة منطقية\&. إذا كانت القيمة true (القيمة الافتراضية)، فعند إجراء بحث عن خدمة DNS\-SD باستخدام \fB\-\-service\fP، سيُحل سجل بيانات تعريف الخدمة \fBTXT\fP أيضًا\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-cname=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا\&. إذا كان صحيحًا (المبدئي)، تُتبع إعادة توجيهات DNS \fBCNAME\fP أو \fBDNAME\fP\&. وإلا، إذا تم العثور على سجل CNAME أو DNAME أثناء الحل، يُرجع خطأ\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-validate=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، يُطبق التحقق من DNSSEC كالمعتاد \(em بشرط أن يكون ممكّنًا للشبكة ولـ systemd\-resolved\&.service ككل\&. إذا كان خاطئًا، يُعطل التحقق من DNSSEC للاستعلام المحدد، بغض النظر عن تمكينه للشبكة أو في الخدمة\&. لاحظ أن تعيين هذا الخيار إلى صحيح لا يُجبر التحقق من DNSSEC على الأنظمة/الشبكات حيث DNSSEC مُعطل\&. هذا الخيار مناسب فقط لتعطيل هذا التحقق حيثما كان ممكّنًا، وليس لتمكين التحقق حيثما كان معطلًا\&. .sp أُضيف في الإصدار 248\&. .RE .PP \fB\-\-synthesize=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، تُحل نطاقات محددة على النظام المحلي، من بينها "localhost" و"_gateway" و"_outbound" و"_localdnsstub" و"_localdnsproxy" أو إدخالات من /etc/hosts\&. إذا كان خاطئًا، لا تُحل هذه النطاقات محليًا، وإما تفشل (في حالة "localhost" أو "_gateway" أو "_outbound" وما شابه) أو تذهب إلى الشبكة عبر عمليات بحث DNS/mDNS/LLMNR العادية (في حالة إدخالات /etc/hosts)\&. .sp أُضيف في الإصدار 248\&. .RE .PP \fB\-\-cache=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، تستخدم عمليات البحث خبيئة سجل موارد DNS المحلية\&. إذا كان خاطئًا، تُوجه عمليات البحث إلى الشبكة بدلاً من ذلك، بغض النظر عن توفرها بالفعل في الخبيئة المحلية\&. .sp أُضيف في الإصدار 248\&. .RE .PP \fB\-\-zone=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، تُجاب عمليات البحث من سجلات موارد LLMNR أو mDNS المسجلة محليًا، إذا كانت محددة\&. إذا كان خاطئًا، لا تُؤخذ سجلات LLMNR/mDNS المسجلة محليًا في الاعتبار لطلب البحث\&. .sp أُضيف في الإصدار 248\&. .RE .PP \fB\-\-trust\-anchor=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، تُجاب عمليات البحث عن DS وDNSKEY من مراسي الثقة DNSSEC المحلية إذا أمكن\&. إذا كان خاطئًا، لا يُؤخذ مخزن الثقة المحلي في الاعتبار لطلب البحث\&. .sp أُضيف في الإصدار 248\&. .RE .PP \fB\-\-network=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، تُجاب عمليات البحث عبر طلبات شبكة DNS أو LLMNR أو mDNS إذا لم يمكن تركيبها محليًا، أو الإجابة من الخبيئة المحلية أو النطاق أو مراسي الثقة (انظر أعلاه)\&. إذا كان خاطئًا، لا يُجاب الطلب من الشبكة وبالتالي سيفشل إذا لم يستطع أي من المصادر المشار إليها الإجابة عليه\&. .sp أُضيف في الإصدار 248\&. .RE .PP \fB\-\-search=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا\&. إذا كان صحيحًا (المبدئي)، يُبحث عن أي أسماء مضيف ذات تسمية واحدة محددة في النطاقات المكونة في قائمة نطاق البحث، إذا كانت غير فارغة\&. وإلا، يُعطل منطق نطاق البحث\&. لاحظ أن هذا الخيار ليس له تأثير إذا استُخدم \fB\-\-type=\fP (انظر أعلاه)، وفي هذه الحالة يُطفأ منطق نطاق البحث دون شرط\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-raw\fP[=payload|packet] .RS 4 يُفرغ سجلات الإجابة كبيانات ثنائية\&. إذا لم يكن هناك وسيط أو إذا كان الوسيط هو "payload"، يُصدر حمولة بيانات سجل المورد، أي ليس "RDATA" بالكامل، بل المحتويات الأساسية فقط\&. إذا كان الوسيط هو "packet"، يُفرغ سجل المورد بالكامل بتنسيق سلكي، مسبوقًا بطول محدد كعدد صحيح 64 بت صغير النهاية\&. يسمح هذا التنسيق بإفراغ سجلات متعددة وتحليلها دون غموض\&. .sp لاحظ أن "payload" مدعوم فقط لمجموعة فرعية صغيرة من أنواع سجلات الموارد: SSHFP وTLSA وOPENPGPKEY حيث يُفرغ هذا مادة المفتاح فقط؛ وA وAAAA حيث يُفرغ هذا بيانات العنوان\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-legend=\fP\fIقيمة_منطقية\fP .RS 4 يأخذ معاملًا منطقيًا\&. إذا كان صحيحًا (المبدئي)، تُعرض رؤوس الأعمدة والمعلومات الوصفية حول استجابة الاستعلام\&. وإلا، يُكبت هذا المخرج\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-\-stale\-data=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا (المبدئي)، تُجاب عمليات البحث ببيانات قديمة (سجلات موارد منتهية الصلاحية) إذا أمكن\&. إذا كان خاطئًا، لا تُؤخذ البيانات القديمة في الاعتبار لطلب البحث\&. .sp أُضيف في الإصدار 254\&. .RE .PP \fB\-\-relax\-single\-label=\fP\fIBOOL\fP .RS 4 يأخذ معاملًا منطقيًا؛ يُستخدم مع \fBquery\fP\&. إذا كان صحيحًا، تُخفف القواعد المتعلقة بتوجيه الأسماء ذات التسمية الواحدة\&. المبدئي خاطئ\&. مبدئيًا، تُفترض عمليات بحث الأسماء ذات التسمية الواحدة أنها تشير إلى مضيفين محليين ليتم حلها عبر حل محلي مثل LLMNR أو عبر تأهيل نطاق البحث ولا تُوجه إلى الخوادم العلوية كما هي\&. إذا كان هذا الخيار ممكّنًا، تُعطل هذه القواعد وتُوجه الاستعلامات إلى الأعلى على أي حال\&. انظر أيضًا خيار \fIResolveUnicastSingleLabel=\fP في \fBresolved.conf\fP(5) الذي يوفر خيارًا على مستوى النظام يتحكم في هذا السلوك\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-no\-ask\-password\fP .RS 4 لا تسأل المستخدم عن الاستيثاق للعمليات ذات الامتيازات\&. .RE .PP \fB\-\-json=\fP\fIوضع\fP .RS 4 يظهر المخرجات منسقة بصيغة JSON\&. يتوقع أحد الخيارات: "short" (لأقصر مخرج ممكن دون أي مسافات زائدة أو فواصل أسطر)، أو "pretty" (لنسخة جميلة من المخرج نفسه، مع إزاحة وفواصل أسطر) أو "off" (لإيقاف مخرجات JSON، وهو الخيار المبدئي)\&. .RE .PP \fB\-j\fP .RS 4 يكافئ \fB\-\-json=pretty\fP إذا كان يعمل على طرفية، و \fB\-\-json=short\fP في الحالات الأخرى\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 لا تمرر المخرجات إلى برنامج عرض (pager)\&. .RE .PP \fB\-h\fP، \fB\-\-help\fP .RS 4 اطبع نص مساعدة قصير واخرج\&. .RE .PP \fB\-\-version\fP .RS 4 اطبع سلسلة إصدار قصيرة واخرج\&. .RE .SH "التوافق مع RESOLVCONF(8)" .PP \fBresolvectl\fP هو ثنائي متعدد الاستدعاءات\&. عند استدعائه كـ "resolvconf" (يُحقق عمومًا عبر رابط رمزي بهذا الاسم إلى الثنائي \fBresolvectl\fP) يُشغل في وضع توافق محدود مع \fBresolvconf\fP(8)\&. يقبل نفس الوسائط في الغالب ويدفع جميع البيانات إلى \fBsystemd\-resolved.service\fP(8)، مشابهًا لكيفية عمل أوامر \fBdns\fP و\fBdomain\fP\&. لاحظ أن \fBsystemd\-resolved\&.service\fP هو النهاية الخلفية الوحيدة المدعومة، وهو مختلف عن التطبيقات الأخرى لهذا الأمر\&. .PP /etc/resolv\&.conf سيُحدث فقط بالخوادم المضافة بهذا الأمر عندما يكون /etc/resolv\&.conf رابطًا رمزيًا إلى /run/systemd/resolve/resolv\&.conf، وليس ملفًا ثابتًا\&. انظر مناقشة معالجة /etc/resolv\&.conf في \fBsystemd\-resolved.service\fP(8)\&. .PP ليست كل العمليات المدعومة من قبل التطبيقات الأخرى مدعومة أصليًا\&. تحديدًا: .PP \fB\-a\fP .RS 4 يسجل بيانات تهيئة DNS لكل واجهة مع \fBsystemd\-resolved\fP\&. يتوقع اسم واجهة شبكة كوسيط سطر أوامر وحيد\&. يقرأ بيانات تهيئة DNS المتوافقة مع \fBresolv.conf\fP(5) من مدخله القياسي\&. الحقول ذات الصلة هي "nameserver" و"domain"/"search"\&. هذا الأمر مطابق في الغالب لاستدعاء \fBresolvectl\fP بمزيج من أوامر \fBdns\fP و\fBdomain\fP\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-d\fP .RS 4 يلغي تسجيل بيانات تهيئة DNS لكل واجهة مع \fBsystemd\-resolved\fP\&. هذا الأمر مطابق في الغالب لاستدعاء \fBresolvectl revert\fP\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-f\fP .RS 4 عند التحديد، لن يشتكي \fB\-a\fP و\fB\-d\fP من واجهات الشبكة المفقودة وسينفذان بلا عملية في تلك الحالة بصمت\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-x\fP .RS 4 هذا المفتاح لعملية "حصرية" مدعوم جزئيًا فقط\&. يُعيّن إلى نطاق بحث مهيأ إضافي من "~\&." \(em أي يضمن توجيه حركة DNS بشكل مفضل إلى خوادم DNS على هذه الواجهة، ما لم تكن هناك نطاقات أخرى أكثر تحديدًا مهيأة على واجهات أخرى\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-p\fP .RS 4 عند التحديد، لن تُستخدم الواجهة كمسار مبدئي\&. انظر أيضًا \fBsystemd\-resolved.service\fP(8) حول المسار المبدئي\&. .sp أُضيف في الإصدار 257\&. .RE .PP \fB\-m\fP .RS 4 المفتاح غير مدعوم ويُتجاهل بصمت\&. .sp أُضيف في الإصدار 239\&. .RE .PP \fB\-u\fP, \fB\-I\fP, \fB\-i\fP, \fB\-l\fP, \fB\-R\fP, \fB\-r\fP, \fB\-v\fP, \fB\-V\fP, \fB\-\-enable\-updates\fP, \fB\-\-disable\-updates\fP, \fB\-\-are\-updates\-enabled\fP .RS 4 هذه المفاتيح غير مدعومة وسيفشل الأمر إذا استُخدمت\&. .sp أُضيف في الإصدار 239\&. .RE .PP انظر \fBresolvconf\fP(8) للتفاصيل حول خيارات سطر الأوامر تلك\&. .SH أمثلة .PP \fBمثال\ \&1.\ \&استرداد عناوين نطاق "www\&.0pointer\&.net" (سجلات موارد A وAAAA)\fP .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مثال\ \&2.\ \&استرداد نطاق عنوان IP "85\&.214\&.157\&.71" (سجل مورد PTR)\fP .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مثال\ \&3.\ \&استرداد سجل MX لنطاق "yahoo\&.com"\fP .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مثال\ \&4.\ \&حل خدمة SRV\fP .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مثال\ \&5.\ \&استرداد مفتاح PGP (سجل مورد OPENPGP)\fP .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مثال\ \&6.\ \&استرداد مفتاح TLS (سجل مورد TLSA)\fP .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 "انظر أيضًا" .PP \fBsystemd\fP(1), \fBsystemd\-resolved.service\fP(8), \fBsystemd.dnssd\fP(5), \fBsystemd\-networkd.service\fP(8), \fBresolvconf\fP(8) .SH ملاحظات .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 استبانة أسماء البث المتعدد للارتباط المحلي .RS 4 \%https://tools.ietf.org/html/rfc4795 .RE .IP " 6." 4 DNS للبث المتعدد .RS 4 \%https://www.ietf.org/rfc/rfc6762.txt .RE .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .