X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2FServices.txt;h=f945bbf195c883534b35fdccef98a9fd73f2a902;hb=0ae158a492221421f9e8b531d16651e3bcd9ccee;hp=67053b16a93155e5315ca03e19fef9c709fd4f7a;hpb=1519afa391d7cb33957892fded23e1b1e178f1f3;p=ngircd-alex.git
diff --git a/doc/Services.txt b/doc/Services.txt
index 67053b16..f945bbf1 100644
--- a/doc/Services.txt
+++ b/doc/Services.txt
@@ -1,22 +1,27 @@
ngIRCd - Next Generation IRC Server
+ http://ngircd.barton.de/
- (c)2001-2008 Alexander Barton,
- alex@barton.de, http://www.barton.de/
-
+ (c)2001-2011 Alexander Barton and Contributors.
ngIRCd is free software and published under the
terms of the GNU General Public License.
-- 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.8 or later ()
+ - Atheme 7.0.2 or later ()
+ - "IRC Services" 5.1.x by Andrew Church ()
-Services have been tested using "IRC Services" version 5.x by Andrew Church,
-homepage: . This document describes setting up
-ngIRCd and these services.
+This document describes setting up ngIRCd and these services.
+
+Please let us know if you are successfully using other IRC service packages or
+which problems you encounter -- thanks!
Setting up ngIRCd
@@ -29,6 +34,10 @@ services instead of regular IRC users.
Example:
+ [GLOBAL]
+ Name = server.irc.net
+ Ports = 6667
+
[SERVER]
Name = services.irc.net
MyPassword = 123abc
@@ -36,6 +45,82 @@ Example:
ServiceMask = *Serv
+Setting up Anope 1.9.x & 2.x
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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:
+
+ define
+ {
+ name = "services.host"
+ value = "services.irc.net"
+ }
+
+ uplink
+ {
+ host = "server.irc.net"
+ port = 6667
+ password = "123abc"
+ }
+
+ # 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 = "nickserv"
+
+ # not required if you are running ngIRCd with a higher nickname limit
+ # ("MaxNickLength") than 11 characters, but REQUIRED by default!
+ guestnickprefix = "G-"
+ }
+
+
+Setting up Atheme 7.0.2 or later
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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;
+ };
+
+The documentation of Atheme can be found in the doc/ directory of the
+Atheme source distribution.
+
+
Setting up IRC Services 5.1.x
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -46,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:
@@ -65,6 +150,3 @@ In modules.conf:
The documentation of IRC Services can be found here:
-
-Please let us know if you are successfully using other IRC service packages or
-which problems you encounter, thanks!