Hoppa till innehållet
Dialova

IRC-dokumentation · Avancerad

CAP: lista och förhandla tillägg

CAP förhandlar IRC-tillägg och låter klienten aktivera mekanismer den förstår. IRCv3-guiden om CAP förklarar tillståndsmaskinen. Här hittar du syntax att känna igen i en logg.

Dialovas team · Kontrollerat den

Syntax och parametrar #

Protokollsyntax utan klientens /
CAP <LS [302] | LIST | REQ :<capacités> | END>
ParameterBetydelse
LS 302Begär listan med modern annonsering, inklusive värden och eventuellt uppdelade svar.
REQBegär valda funktioner. ACK eller NAK besvarar begäran.
LIST / ENDLIST visar aktiva funktioner. END avslutar pausen i registreringen.

Kommenterat exempel #

IRC-utbyte: C = klient, S = server
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

Smeknamn, värdar och texter är påhittade. Klienten kan visa svaren mer lättläst än protokollraderna här.

Möjliga svar och fel #

SvarSå tolkar du svaret
CAP LSErbjuden lista. En mellanliggande *-markör visar att fortsättning följer.
CAP ACK / NAKAktivering godkänd eller begäran nekad.
CAP LISTLista över aktiva funktioner.
FelVanlig orsak
410Ogiltigt CAP-underkommando beroende på implementation.
421Äldre server som inte känner till CAP.

Rättigheter, kompatibilitet och försiktighet #

LS aktiverar inget. Klienten får använda en funktion först när den är aktiverad. CAP END skickar inget meddelande till en kanal utan är ett anslutningssteg.

CAP kan också användas efter registrering. Underkommandon, annonserad version och NEW/DEL-notiser måste tolkas enligt specifikationen. Funktionsvärdet, till exempel sasl=PLAIN, är inte namnet.

Vanliga frågor #

Varför visas CAP utan /? Här visas protokollet. Gränssnittet hanterar kommandot internt.

Är CAP och 005 ISUPPORT samma sak? Nej. ISUPPORT beskriver egenskaper och gränser. CAP aktiverar förhandlade tillägg.

Källor och kontroll

Exemplen använder påhittade smeknamn och domäner, utom uttryckligen dokumenterade anslutningspunkter. Nätverksspecifika tillägg och inställningar anges i texten.