Hopp til innhold
Dialova

IRC-dokumentasjon · Avansert

CAP: finn og forhandle IRC-utvidelser

CAP er kommandoen for å forhandle IRC-utvidelser. Den lar klienten aktivere mekanismene den forstår. Veiledningen om IRCv3 CAP beskriver tilstandsmaskinen; denne siden hjelper deg å kjenne igjen syntaksen i en logg.

Dialova-teamet · Kontrollert

Syntaks og parametere #

Protokollsyntaks, uten klientens /
CAP <LS [302] | LIST | REQ :<capacités> | END>
ParameterBetydning
LS 302Ber om listen med den moderne annonseringsmekanismen, inkludert verdier og svar som eventuelt er fordelt på flere meldinger.
REQBer om å aktivere valgte capabilities. ACK eller NAK svarer på forespørselen.
LIST / ENDLIST viser aktive capabilities; END avslutter pausen i registreringen.

Eksempel med forklaring #

IRC-utveksling: 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

Kallenavnene, vertsnavnene og meldingstekstene i eksemplet er oppdiktet. Klienten kan vise svarene på en mer lesbar måte enn de rå protokollmeldingene som vises her.

Mulige svar og feil #

SvarForklaring
CAP LSTilbudt liste. En mellomliggende *-markør betyr at listen fortsetter.
CAP ACK / NAKAktiveringen er godtatt, eller forespørselen er avvist.
CAP LISTListe over aktive capabilities.
FeilVanlig årsak
410Ugyldig CAP-underkommando, avhengig av implementasjonen.
421En eldre server som ikke kjenner CAP.

Rettigheter, kompatibilitet og forholdsregler #

En LS-annonsering aktiverer ingenting. Klienten må vente til en capability er aktivert før den bruker den. CAP END sender ikke en melding til et rom; det er et trinn i tilkoblingen.

CAP kan også brukes etter registrering. Underkommandoene, den annonserte versjonen og NEW/DEL-varsler må tolkes etter spesifikasjonen. Verdien til en capability, for eksempel sasl=PLAIN, er ikke navnet dens.

Vanlige spørsmål #

Hvorfor vises CAP uten /? Eksemplet viser protokollen. Grensesnittet håndterer kommandoen internt.

Gjør CAP og 005 ISUPPORT det samme? Nei. ISUPPORT beskriver egenskaper og grenser; CAP aktiverer utvidelser som forhandles.

Kilder og kontroll

Eksemplene bruker fiktive kallenavn og domener, bortsett fra tilkoblingspunkter som er uttrykkelig dokumentert. Utvidelser og nettverksspesifikke innstillinger er merket i teksten.