Naar de inhoud
Dialova

IRC-documentatie · Expert

CAP: IRC-uitbreidingen opvragen en onderhandelen

CAP onderhandelt IRC-uitbreidingen. Een client schakelt hiermee mechanismen in die die begrijpt. De IRCv3-CAP-gids beschrijft de toestandsmachine. Deze pagina geeft syntax om in een logboek te herkennen.

Dialova-team · Gecontroleerd op

Syntax en parameters #

Protocolsyntax, zonder de / van de client
CAP <LS [302] | LIST | REQ :<capacités> | END>
ParameterBetekenis
LS 302Vraagt de lijst op met moderne aankondiging, inclusief waarden en eventueel gesplitste antwoorden.
REQVraagt inschakeling van gekozen capabilities. ACK of NAK beantwoordt de aanvraag.
LIST / ENDLIST beschrijft actieve capabilities; END beëindigt het uitstel van registratie.

Uitgelegd voorbeeld #

IRC-uitwisseling: C = client, 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

Namen, hosts en teksten in deze uitwisseling zijn fictief. De client kan antwoorden leesbaarder tonen dan de weergegeven protocolregels.

Mogelijke antwoorden en fouten #

AntwoordBetekenis
CAP LSAangeboden lijst. Een tussentijdse * geeft aan dat er meer volgt.
CAP ACK / NAKInschakeling geaccepteerd of aanvraag geweigerd.
CAP LISTLijst met actieve capabilities.
FoutGebruikelijke oorzaak
410Ongeldige CAP-subopdracht, afhankelijk van de implementatie.
421Oude server die CAP niet herkent.

Rechten, compatibiliteit en voorzorg #

LS schakelt niets in. De client mag een capability pas gebruiken na inschakeling. CAP END is geen chatroombericht, maar een verbindingsstap.

CAP kan ook na registratie werken. Subopdrachten, versie en NEW/DEL-meldingen moeten volgens de specificatie worden verwerkt. De waarde van een capability, zoals sasl=PLAIN, is niet de naam ervan.

Veelgestelde vragen #

Waarom staat CAP zonder /? Hier wordt het protocol getoond. De interface verwerkt deze opdracht intern.

Doen CAP en 005 ISUPPORT hetzelfde? Nee. ISUPPORT beschrijft eigenschappen en limieten. CAP activeert onderhandelde uitbreidingen.

Bronnen en controle

De voorbeelden gebruiken fictieve gebruikersnamen en domeinen, behalve waar verbindingspunten uitdrukkelijk zijn gedocumenteerd. Uitbreidingen en netwerkspecifieke instellingen worden in de tekst aangegeven.