Zum Inhalt springen
Dialova

IRC-Dokumentation · Fortgeschrittene

Numerische IRC-Antworten verstehen

Eine numerische Antwort ist eine Nachricht mit einem dreistelligen Code als Befehl. Code und Parameter bilden die Struktur. Der abschließende Erklärungstext ist für die Anzeige gedacht und kann je nach Server oder Sprache variieren.

Dialova-Team · Überprüft am

Die Struktur lesen, statt einen Satz zu analysieren #

NAMES-Antworten an den Client Alice
:irc.example 353 Alice = #atelier :@Alice Bob
:irc.example 366 Alice #atelier :End of /NAMES list

353 ist hier der numerische Befehl. Alice ist die Empfängerin der Antwort. #atelier und die Nicknameliste sind die für den Client wichtigen Parameter. Der Text am Listenende ist keine stabile Kennung, die wortwörtlich erkannt werden muss.

Häufige Antworten zur Orientierung #

CodeVerwendungWorauf du achten solltest
001Begrüßung nach abgeschlossener AnmeldungNicht mit dem bloßen Öffnen einer TCP-Verbindung gleichsetzen.
005ISUPPORTBeschreibt Servereigenschaften und ist kein CAP ACK.
311 / 318WHOIS-Informationen und deren EndeWeitere Antworten können dazwischen eintreffen.
332 / 333Thema und zugehörige Metadaten333 ist verbreitet, bildet aber nicht allein die vollständige TOPIC-Antwort.
353 / 366NAMES-Liste und ListenendeDie Liste kann auf mehrere Antworten verteilt sein.
401Ziel nicht gefundenErlaubt nicht, die Netzwerkrichtlinien zu umgehen.
482Unzureichende ChannelrechteDie tatsächliche Rolle prüfen, nicht nur das Clientmenü.
903 / 904SASL-Erfolg / SASL-FehlerNicht alle 9xx-Codes stehen also für einen Erfolg.

Historische Antworten und Erweiterungen #

Die RFCs beschreiben eine historische Grundlage, nicht jede heutige Antwort. IRCd-Software und Erweiterungen fügen Codes hinzu. Ein Client muss sie korrekt anzeigen oder ignorieren können, ohne eine Bedeutung zu erfinden. WHOIS kann beispielsweise je nach Netzwerk und Berechtigung zusätzliche Angaben liefern.

4xx und 5xx enthalten viele Fehlercodes. Diese Faustregel ersetzt aber nicht die Dokumentation des jeweiligen Mechanismus. Moderne Erweiterungen verwenden auch strukturierte Antworten wie FAIL, WARN oder NOTE.

Eine Antwort der richtigen Aktion zuordnen #

Ein Client kann Ereignisse und mehrere Antworten gleichzeitig empfangen. Nimm nicht an, dass die nächste eintreffende Nachricht die Antwort auf den letzten Befehl ist. Beachte Zielparameter und Endmarkierungen. labeled-response ermöglicht, wenn verfügbar, eine weitergehende Zuordnung von Anfragen und Antworten.

Quellen und Überprüfung

Die Beispiele verwenden erfundene Nicknames und Domains. Ausgenommen sind ausdrücklich dokumentierte Verbindungsadressen. Netzwerkspezifische Erweiterungen und Einstellungen werden im Text gekennzeichnet.