דילוג לתוכן
Dialova

תיעוד IRC · מתקדמים

הפקודה CAP: הצגת הרחבות ומשא ומתן עליהן

CAP היא הפקודה למשא ומתן על הרחבות IRC. בעזרתה לקוח מפעיל מנגנונים שהוא מבין. מדריך IRCv3 CAP מפרט את מכונת המצבים; העמוד הזה מציג את התחביר שכדאי לזהות ביומן.

צוות Dialova · נבדק בתאריך

תחביר ופרמטרים #

תחביר הפרוטוקול, ללא סימן / של הלקוח
CAP <LS [302] | LIST | REQ :<capacités> | END>
פרמטרמשמעות
LS 302בקשת הרשימה במנגנון הפרסום המודרני, כולל ערכים ותשובות שעשויות להתפצל.
REQבקשת הפעלה של היכולות שנבחרו; ACK או NAK הם התשובה לבקשה.
LIST / ENDLIST מציגה את היכולות הפעילות; 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 מפעילה הרחבות במסגרת משא ומתן.

מקורות ובדיקת המידע

הדוגמאות משתמשות בכינויים ובדומיינים בדויים, למעט כתובות חיבור שמתועדות במפורש. הרחבות והגדרות ייחודיות לרשת מצוינות בטקסט.