2 28c7f372 2002-09-02 alex ngIRCd - Next Generation IRC Server
4 28c7f372 2002-09-02 alex (c)2001,2002 by Alexander Barton,
5 28c7f372 2002-09-02 alex alex@barton.de, http://www.barton.de/
7 28c7f372 2002-09-02 alex ngIRCd ist freie Software und steht unter
8 28c7f372 2002-09-02 alex der GNU General Public License.
10 28c7f372 2002-09-02 alex -- Protocol.txt --
13 28c7f372 2002-09-02 alex I. Kompatibilitaet
14 28c7f372 2002-09-02 alex ~~~~~~~~~~~~~~~~~~
16 28c7f372 2002-09-02 alex Der ngIRCd haelt sich an das IRC-Protokoll Version 2.10, wie es in den RFCs
17 28c7f372 2002-09-02 alex 1459 und 2810-2813 beschrieben ist. Diese (und ggf. weitere fuer den ngIRCd
18 28c7f372 2002-09-02 alex relevante) RFCs sind in RFC.txt aufgefuehrt.
20 28c7f372 2002-09-02 alex Leider verhaelt sich aber schon der "Originalserver" nicht immer genau so,
21 28c7f372 2002-09-02 alex wie es in den RFCs beschrieben ist. Da der ngIRCd aber ein Ersatz fuer
22 28c7f372 2002-09-02 alex eben diesen Server sein soll, werden diese Abweichungen in der Regel vom
23 28c7f372 2002-09-02 alex ngIRCd emuliert um die Kompatibilitaet zu wahren.
25 28c7f372 2002-09-02 alex Sollte dieses Verhalten nicht erwuenscht sein, so kann mit der configure-
26 28c7f372 2002-09-02 alex Option "--enable-strict-rfc" der ngIRCd so compiliert werden, dass er sich
27 28c7f372 2002-09-02 alex strikt an die entsprechenden RFCs haelt.
29 28c7f372 2002-09-02 alex ACHTUNG: an einem so compilierten Server koennen sich andere Server und
30 28c7f372 2002-09-02 alex Clients, die sich nicht genau an das Protokoll halten, u.U. nicht mehr
31 28c7f372 2002-09-02 alex anmelden oder alle Funktionen nutzen! In der Regel ist diese Option daher
32 28c7f372 2002-09-02 alex nicht erwuenscht.
35 aa583906 2002-09-03 alex II. Das IRC+-Protokoll
36 aa583906 2002-09-03 alex ~~~~~~~~~~~~~~~~~~~~~~
38 aa583906 2002-09-03 alex Der ngIRCd unterstuetzt als Erweiterung zum IRC-Protokoll wie es in den RFCs
39 aa583906 2002-09-03 alex 2810-2813 beschrieben ist, das IRC+-Protokoll. Dieses Protokoll ist dabei
40 aa583906 2002-09-03 alex kompatibel zum IRC-Protokoll und wird nur verwendet, wenn der ngIRCd fest-
41 aa583906 2002-09-03 alex stellt, dass ein connectierter Server ebenfalls dieses erweiterte Protokoll
42 aa583906 2002-09-03 alex unterstuetzt.
44 28c7f372 2002-09-02 alex Die Protokoll- und Server-Erkennung wird mit dem "PASS"-Befehl durchgefuehrt
45 28c7f372 2002-09-02 alex (vgl. RFC 2813, Sektion 4.1.1):
48 28c7f372 2002-09-02 alex II.1 neuen Server-Link registrieren
50 28c7f372 2002-09-02 alex Befehl: PASS
51 28c7f372 2002-09-02 alex Parameter: <password> <version> <flags> [<options>]
52 28c7f372 2002-09-02 alex Fuer: mit dieser Syntax nur Server
54 241d033f 2002-09-03 alex <password> enthaelt das Passwort fur den neu aufzubauenden Server-Link,
55 241d033f 2002-09-03 alex so wie es in der Konfigurationsdatei definiert wurde.
57 28c7f372 2002-09-02 alex <version> setzt sich aus zwei Teilen zusammen und ist mindestens 4, maximal
58 241d033f 2002-09-03 alex 14 Zeichen lang: die ersten vier Bytes enthalten die Versionsnummer des
59 241d033f 2002-09-03 alex unterstuetzten IRC-Protokolls, wobei die ersten zwei Bytes die Major-, die
60 241d033f 2002-09-03 alex letzten beiden die Minor-Revision angeben. Der String "0210" steht also
61 241d033f 2002-09-03 alex fuer Protokollversion 2.10.
62 241d033f 2002-09-03 alex Die folgenden (optionalen!) 10 Bytes enthalten eine von der jeweiligen
63 aa583906 2002-09-03 alex Implementation abhaengige Versionsnummer. Server, die das IRC+-Protokoll
64 aa583906 2002-09-03 alex unterstuetzen, liefern hier "-IRC+".
66 241d033f 2002-09-03 alex <flags> setzt sich ebenfalls aus zwei Bestandteilen zusammen und ist
67 241d033f 2002-09-03 alex maximal 100 Bytes lang. Getrennt werden die beiden Teile mit dem Zeichen
68 241d033f 2002-09-03 alex "|". Der erste Teil enthaelt den Namen der Implementation, der ngIRCd
69 241d033f 2002-09-03 alex liefert hier z.B. "ngIRCd", der Originalserver "IRC". Anhand dieser "ID"
70 241d033f 2002-09-03 alex kann zwischen Serverimplementationen unterschieden werden. Der zweite Teil
71 aa583906 2002-09-03 alex (nach dem "|") ist implementationsabhaengig und wird nur ausgewertet,
72 aa583906 2002-09-03 alex wenn die Gegenseite das IRC+-Protokoll unterstuetzt. In diesem Fall wird
73 aa583906 2002-09-03 alex folgende Syntax erwartet: "<serverversion>[:<serverflags>]".
75 241d033f 2002-09-03 alex <serverversion> ist hier eine ASCII-Klartext-Darstellung der Versionsnummer,
76 241d033f 2002-09-03 alex <serverflags> zeigt die vom Server unterstuetzten Erweiterungen an (und
77 241d033f 2002-09-03 alex kann die leere Menge sein).
79 241d033f 2002-09-03 alex Mit dem optionalen Parameter <options> werden Server-Optionen uebermittelt,
80 28c7f372 2002-09-02 alex wie sie in RFC 2813, Sektion 4.1.1 definiert sind.
82 aa583906 2002-09-03 alex Folgende <serverflags> sind zur Zeit definiert:
84 241d033f 2002-09-03 alex - o: IRC-Operatoren duerfen auch dann Channel- und Channel-User-Modes
85 241d033f 2002-09-03 alex aendern, wenn sie kein Channel-Operator im betroffenen Channel sind.
87 aafd21c7 2002-09-04 alex - C: der Server unterstuetzt den CHANINFO-Befehl.
90 9611833e 2002-09-04 alex II.2 Channel-Modes, persistente Channel und Topic austauschen
92 9611833e 2002-09-04 alex Befehl: CHANINFO
93 9611833e 2002-09-04 alex Parameter: <channel> +<mode> [<topic>]
94 9611833e 2002-09-04 alex Fuer: Server
96 9611833e 2002-09-04 alex Mit CHANINFO Informiert ein Server den anderen ueber einen Channel: dessen
97 9611833e 2002-09-04 alex Modes und dessen Topic. <topic> ist optional.
99 9611833e 2002-09-04 alex Existiert auf dem Server, der das CHANINFO empfaengt, der Channel bereits,
100 9611833e 2002-09-04 alex so uebernimmt er die Werte jeweils nur dann, wenn er selber noch keine
101 9611833e 2002-09-04 alex Modes bzw. kein Topic definiert hat. Ansonsten wird der jeweilige Parameter
104 9611833e 2002-09-04 alex Existiert der Channel noch nicht, so wird er mit den entsprechenden Angaben
109 aafd21c7 2002-09-04 alex $Id: Protocol.txt,v 1.5 2002/09/04 00:06:19 alex Exp $
