]> arthur.barton.de Git - ngircd-alex.git/blobdiff - doc/Services.txt
ngIRCd Release 27
[ngircd-alex.git] / doc / Services.txt
index f51bd488aed61338d1ba9b3f3b1a377cbf3af008..f945bbf195c883534b35fdccef98a9fd73f2a902 100644 (file)
@@ -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 (<http://www.anope.org/>; unreleased!)
- - Atheme 7.0.2 or later (<http://www.atheme.net>)
+ - Anope 1.9.8 or later (<http://www.anope.org/>)
+ - Atheme 7.0.2 or later (<https://atheme.org/>)
  - "IRC Services" 5.1.x by Andrew Church (<http://achurch.org/services/>)
 
 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 (<http://www.anope.org/>; 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 <http://sourceforge.net/projects/anope/develop/>!
+Anope 1.9.8 or later (<http://www.anope.org/>) 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 (<http://www.atheme.net>) may be used with ngIRCd using
+Atheme 7.0.2 or later (<https://atheme.org/>) 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:
-    <ftp://ngircd.barton.de/ngircd/contrib/IRCServices513-FlushBuffer.patch>
+    <http://arthur.barton.de/pub/ngircd/contrib/IRCServices513-FlushBuffer.patch>
 
 At least the following settings have to be tweaked, in addition to all the
 settings marked as required by IRC Services: