Hopp til innhold
Dialova

IRC-dokumentasjon · Viderekommen

Forstå numeriske svar på IRC

Et numerisk svar er en melding der kommandoen er en tresifret kode. Koden og parameterne gir strukturen. Den siste forklarende teksten er ment for visning og kan variere med serveren eller språket.

Dialova-teamet · Kontrollert

Les strukturen i stedet for å analysere en setning #

NAMES-svar til klienten Alice
:irc.example 353 Alice = #atelier :@Alice Bob
:irc.example 366 Alice #atelier :End of /NAMES list

Her er 353 den numeriske kommandoen. Alice er mottakeren av svaret; #atelier og kallenavnlisten er parametere klienten bruker. Setningen som avslutter listen, er ikke en stabil identifikator som skal gjenkjennes ordrett.

Vanlige holdepunkter #

KodeBrukVær oppmerksom på
001Velkomst etter registreringIkke forveksle dette med at TCP-forbindelsen er åpnet.
005ISUPPORTBeskriver serveregenskaper; det er ikke CAP ACK.
311 / 318Start og slutt på WHOIS-informasjonenAndre svar kan komme imellom.
332 / 333Emne og tilhørende metadata333 er vanlig praksis, men utgjør ikke hele TOPIC-svaret alene.
353 / 366NAMES-listen og avslutningenListen kan være delt opp.
401Målet finnes ikkeGir ingen rett til å omgå nettverkets regler.
482Utilstrekkelige romrettigheterSjekk den faktiske rollen, ikke bare menyen i klienten.
903 / 904Vellykket / mislykket SASLDermed betyr ikke alle 9xx-koder suksess.

Historiske svar og utvidelser #

RFC-ene beskriver et historisk grunnlag, ikke alle svar som finnes i dag. IRCd-er og utvidelser legger til koder. En klient må kunne vise eller ignorere dem på en ryddig måte uten å gjette betydningen. WHOIS kan for eksempel gi ekstra opplysninger, avhengig av nettverk og rettigheter.

4xx- og 5xx-gruppene inneholder mange feil, men denne tommelfingerregelen erstatter ikke mekanismens dokumentasjon. Moderne utvidelser bruker også strukturerte svar som FAIL, WARN og NOTE.

Knytt svaret til riktig handling #

En klient kan motta hendelser og flere svar samtidig. Ikke anta at «neste mottatte melding» er svaret på siste kommando. Følg målparametere og sluttmarkører. labeled-response kan, når det er tilgjengelig, dekke mer avanserte behov for å knytte svar til forespørsler.

Kilder og kontroll

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