X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=doc%2FServices.txt;h=56c81425a56908cf1972ddb12a534ef2d5824d9a;hp=f51bd488aed61338d1ba9b3f3b1a377cbf3af008;hb=HEAD;hpb=c7db2f8429c161835f6a9ed4523f45c23918892b diff --git a/doc/Services.txt b/doc/Services.txt index f51bd488..f945bbf1 100644 --- a/doc/Services.txt +++ b/doc/Services.txt @@ -14,8 +14,8 @@ 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.8 or later (; unreleased!) - - Atheme 7.0.2 or later () + - Anope 1.9.8 or later () + - Atheme 7.0.2 or later () - "IRC Services" 5.1.x by Andrew Church () This document describes setting up ngIRCd and these services. @@ -34,6 +34,10 @@ services instead of regular IRC users. Example: + [GLOBAL] + Name = server.irc.net + Ports = 6667 + [SERVER] Name = services.irc.net MyPassword = 123abc @@ -41,13 +45,11 @@ Example: ServiceMask = *Serv -Setting up Anope 1.9.x -~~~~~~~~~~~~~~~~~~~~~~ +Setting up Anope 1.9.x & 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Anope 1.9.8 or later (; unreleased as of 2012-11-10) -may be used with ngIRCd using the "ngircd" protocol module. -Until Anope 1.9.8 is released, you have to use the sources from the Anope -development GIT tree, see ! +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: @@ -68,20 +70,28 @@ In conf/services.conf: } # Load ngIRCd protocol module - module { name = "ngircd" } + 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: - nickserv + module { + name = "nickserv" + # not required if you are running ngIRCd with a higher nickname limit # ("MaxNickLength") than 11 characters, but REQUIRED by default! guestnickprefix = "G-" @@ -91,13 +101,17 @@ In conf/nickserv.conf: Setting up Atheme 7.0.2 or later ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Atheme 7.0.2 or later () may be used with ngIRCd using +Atheme 7.0.2 or later () may be used with ngIRCd using the "ngircd" protocol module. The following settings need to be in atheme.conf: loadmodule "modules/protocol/ngircd"; + serverinfo { + name = "services.irc.net"; + } + uplink "server.irc.net" { password = "123abc"; port = 6667; @@ -117,7 +131,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: