انتقل إلى المحتوى
Dialova

توثيق IRC · متقدم

أمر CAP: عرض الامتدادات والتفاوض بشأنها

CAP هو أمر التفاوض على امتدادات IRC. يتيح للعميل تفعيل الآليات التي يدعمها. يشرح دليل IRCv3 CAP مراحل التفاوض بالتفصيل، بينما تقدم هذه الصفحة الصيغة التي تتعرف إليها في السجل.

فريق Dialova · تم التحقق في

الصيغة والمعاملات #

صيغة البروتوكول دون الشرطة المائلة / المستخدمة في البرنامج
CAP <LS [302] | LIST | REQ :<إمكانات> | END>
المعاملالمعنى
LS 302طلب القائمة بآلية الإعلان الحديثة، بما فيها القيم والردود التي قد تمتد على عدة رسائل.
REQطلب تفعيل القدرات المختارة. ويجيب ACK أو NAK عن الطلب.
LIST / ENDيعرض LIST القدرات النشطة، وينهي END تعليق إكمال التسجيل.

مثال مع الشرح #

تبادل رسائل IRC: ‏C هو العميل وS هو الخادم
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS :message-tags server-time
C: CAP REQ :server-time
S: :irc.example CAP Alice ACK :server-time
C: CAP END

الأسماء المستعارة وعناوين المضيفين والنصوص في هذا المثال افتراضية. قد يعرض البرنامج الردود بصورة أسهل للقراءة من إطارات البروتوكول المعروضة هنا.

الردود والأخطاء المحتملة #

الرددلالته
CAP LSالقائمة المتاحة. تشير العلامة * الوسطية إلى أن القائمة ستتواصل في رسالة أخرى.
CAP ACK / NAKقبول التفعيل أو رفض الطلب.
CAP LISTقائمة القدرات النشطة.
الخطأالسبب المعتاد
410أمر CAP الفرعي غير صالح، بحسب التنفيذ.
421خادم قديم لا يتعرف إلى CAP.

الصلاحيات والتوافق والاحتياطات #

لا يفعّل إعلان LS أي شيء. يجب ألا يستخدم العميل قدرة إلا بعد تفعيلها. ولا يرسل CAP END رسالة إلى غرفة، بل هو خطوة من خطوات الاتصال.

يمكن استخدام CAP بعد التسجيل أيضًا. لكن يجب تفسير الأوامر الفرعية والإصدار المعلن وإشعارات NEW وDEL وفق المواصفة. قيمة القدرة، مثل sasl=PLAIN، ليست اسم القدرة نفسه.

أسئلة شائعة #

لماذا يظهر CAP دون /؟ نتحدث هنا عن البروتوكول، وتتولى الواجهة إدارة الأمر داخليًا.

هل يؤدي CAP و005 ISUPPORT الوظيفة نفسها؟ لا، يصف ISUPPORT خصائص وحدودًا، بينما يفعّل CAP امتدادات يتم التفاوض عليها.

المصادر والتحقق

تستخدم الأمثلة أسماء مستعارة ونطاقات خيالية، باستثناء نقاط الاتصال الموثقة صراحةً. ويوضح النص الإضافات والإعدادات الخاصة بكل شبكة.