X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=doc%2FServices.txt;h=3daa7296cbda6bfdbe594572a3dd6df7349f3a18;hp=26d1d7e6d17987e6ebbf106f58d94c7ef639fb4b;hb=b8482fd3cfdb429aec75575958f4d5d4e9ae22df;hpb=f2455cbe33aed1bbbef9dc31363cbf46ee87a4a3 diff --git a/doc/Services.txt b/doc/Services.txt index 26d1d7e6..3daa7296 100644 --- a/doc/Services.txt +++ b/doc/Services.txt @@ -9,12 +9,12 @@ -- Services.txt -- -At the moment, ngIRCd doesn't implement a "special IRC services interface". -But services acting as a "regular server" are supported, either using the IRC -protocol defined in RFC 1459 or RFC 2812. +ngIRCd doesn't implement a "special IRC services interface", but services +acting as a "regular servers" ("pseudo servers") are supported, either +using the IRC protocol as defined in RFC 1459 or RFC 2812. Support for Services has been tested using - - Anope 1.9.4 or later () + - Anope 1.9.8 or later () - Atheme 7.0.2 or later () - "IRC Services" 5.1.x by Andrew Church () @@ -41,16 +41,22 @@ Example: ServiceMask = *Serv -Setting up Anope 1.9.x -~~~~~~~~~~~~~~~~~~~~~~ +Setting up Anope 1.9.x & 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Anope 1.9.4 (and above) can be used with ngIRCd using a preliminary "ngircd" -protocol module contained in our contrib/Anope/ directory. Please see the -file contrib/Anope/README for installation instructions! +Anope 1.9.8 or later () can be used with ngIRCd using +the "ngircd" protocol module. + +At least the following settings have to be tweaked, in addition to all the +settings marked as required by Anope: + +In conf/services.conf: -After patching and installing Anope, at least the following configuration -variables have to be adjusted in data/services.conf, in addition to all the -settings marked as required: + define + { + name = "services.host" + value = "services.irc.net" + } uplink { @@ -59,10 +65,32 @@ settings marked as required: password = "123abc" } - serverinfo + # Load ngIRCd protocol module + module + { + name = "ngircd" + } + + networkinfo + { + # Must be set to the "MaxNickLength" setting of ngIRCd! + nicklen = 9 + + # When not using "strict mode", which is the default: + userlen = 20 + + chanlen = 50 + } + +In conf/nickserv.conf: + + module { - name = "services.irc.net" - type = "ngircd" + name = "nickserv" + + # not required if you are running ngIRCd with a higher nickname limit + # ("MaxNickLength") than 11 characters, but REQUIRED by default! + guestnickprefix = "G-" } @@ -95,7 +123,7 @@ Please note that versions up to and including 5.1.3 contain a bug that sometimes causes IRC Services to hang on startup. There are two workarounds: a) send the services process a HUP signal ("killall -HUP ircservices") b) apply this patch to the IRC Services source tree: - + At least the following settings have to be tweaked, in addition to all the settings marked as required by IRC Services: