doc/Services.txt

   1
   2                      ngIRCd - Next Generation IRC Server
   3
   4                         (c)2001-2008 Alexander Barton,
   5                     alex@barton.de, http://www.barton.de/
   6
   7                ngIRCd is free software and published under the
   8                    terms of the GNU General Public License.
   9
  10                               -- Services.txt --
  11
  12
  13 At the moment, ngIRCd doesn't implement a "special IRC services interface".
  14 But services acting as a "regular server" are supported, either using the IRC
  15 protocol defined in RFC 1459 or RFC 2812.
  16
  17 Services have been tested using "IRC Services" version 5.x of Andrew Church,
  18 homepage: <http://www.ircservices.za.net/>. This document describes setting up
  19 ngIRCd and these services.
  20
  21
  22 Setting up ngIRCd
  23 ~~~~~~~~~~~~~~~~~
  24
  25 The "pseudo server" handling the IRC services is configured as a regular
  26 remote server in the ngircd.conf(5). In addition the variable "ServiceMask"
  27 should be set, enabling this ngIRCd to recognize the "pseudo users" as IRC
  28 services insted of regular IRC users.
  29
  30 Example:
  31
  32   [SERVER]
  33      Name = services.irc.net
  34      MyPassword = 123abc
  35      PeerPassword = 123abc
  36      ServiceMask = *Serv
  37
  38
  39 Setting up IRC Services 5.1.x
  40 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  41
  42 IRC Services 5.1.x can be used with ngIRCd using the "rfc1459" protocol
  43 module. At least the following settings have to be tweaked, in addition to all
  44 the settings marked as required by IRC Services:
  45
  46 In ircservices.conf:
  47
  48   Variable              Example value
  49
  50   RemoteServer          server.irc.net 6667 "123abc"
  51   ServerName            "services.irc.net"
  52   LoadModule            protocol/rfc1459
  53
  54 In modules.conf:
  55
  56   Module                protocol/rfc1459
  57
  58 The documentation of IRC Services can be found here:
  59 <http://www.ircservices.za.net/docs/>