Blame
Date:
Fri Jan 1 19:03:58 2021 UTC
Message:
Update Platforms.txt - Add aarch64/apple/darwin (Apple CLang 12.0.0) - Add x86_64/unknown/openbsd6.7 (gcc 4.2.1) Thanks to Götz Hoffart
001
2008-12-02
alex
002
2008-12-02
alex
ngIRCd - Next Generation IRC Server
003
2011-07-10
alex
http://ngircd.barton.de/
004
2008-12-02
alex
005
2011-07-10
alex
(c)2001-2011 Alexander Barton and Contributors.
006
2008-12-02
alex
ngIRCd is free software and published under the
007
2008-12-02
alex
terms of the GNU General Public License.
008
2008-12-02
alex
009
2008-12-02
alex
-- Services.txt --
010
2008-12-02
alex
011
2008-12-02
alex
012
2012-11-10
alex
ngIRCd doesn't implement a "special IRC services interface", but services
013
2012-11-10
alex
acting as a "regular servers" ("pseudo servers") are supported, either
014
2012-11-10
alex
using the IRC protocol as defined in RFC 1459 or RFC 2812.
015
2008-12-02
alex
016
2012-11-04
alex
Support for Services has been tested using
017
2013-03-13
alex
- Anope 1.9.8 or later (<http://www.anope.org/>)
018
2020-08-04
alex
- Atheme 7.0.2 or later (<https://atheme.org/>)
019
2012-11-04
alex
- "IRC Services" 5.1.x by Andrew Church (<http://achurch.org/services/>)
020
2008-12-02
alex
021
2011-07-10
alex
This document describes setting up ngIRCd and these services.
022
2008-12-02
alex
023
2012-11-04
alex
Please let us know if you are successfully using other IRC service packages or
024
2012-11-04
alex
which problems you encounter -- thanks!
025
2011-07-10
alex
026
2012-11-04
alex
027
2008-12-02
alex
Setting up ngIRCd
028
2008-12-02
alex
~~~~~~~~~~~~~~~~~
029
2008-12-02
alex
030
2008-12-02
alex
The "pseudo server" handling the IRC services is configured as a regular
031
2008-12-02
alex
remote server in the ngircd.conf(5). In addition the variable "ServiceMask"
032
2008-12-02
alex
should be set, enabling this ngIRCd to recognize the "pseudo users" as IRC
033
2008-12-04
alex
services instead of regular IRC users.
034
2008-12-02
alex
035
2008-12-02
alex
Example:
036
2008-12-02
alex
037
2017-02-20
alex
[GLOBAL]
038
2017-02-20
alex
Name = server.irc.net
039
2017-02-20
alex
Ports = 6667
040
2017-02-20
alex
041
2008-12-02
alex
[SERVER]
042
2008-12-02
alex
Name = services.irc.net
043
2008-12-02
alex
MyPassword = 123abc
044
2008-12-02
alex
PeerPassword = 123abc
045
2008-12-02
alex
ServiceMask = *Serv
046
2008-12-02
alex
047
2008-12-02
alex
048
2014-02-02
alex
Setting up Anope 1.9.x & 2.x
049
2014-02-02
alex
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
050
2011-07-10
alex
051
2013-03-13
alex
Anope 1.9.8 or later (<http://www.anope.org/>) can be used with ngIRCd using
052
2013-03-13
alex
the "ngircd" protocol module.
053
2011-07-10
alex
054
2012-11-10
alex
At least the following settings have to be tweaked, in addition to all the
055
2012-11-10
alex
settings marked as required by Anope:
056
2011-07-10
alex
057
2012-11-10
alex
In conf/services.conf:
058
2012-11-10
alex
059
2012-11-10
alex
define
060
2012-11-10
alex
{
061
2012-11-10
alex
name = "services.host"
062
2012-11-10
alex
value = "services.irc.net"
063
2012-11-10
alex
}
064
2012-11-10
alex
065
2011-07-10
alex
uplink
066
2011-07-10
alex
{
067
2011-07-10
alex
host = "server.irc.net"
068
2011-07-10
alex
port = 6667
069
2011-07-10
alex
password = "123abc"
070
2011-07-10
alex
}
071
2011-07-10
alex
072
2012-11-10
alex
# Load ngIRCd protocol module
073
2014-02-02
alex
module
074
2014-02-02
alex
{
075
2014-02-02
alex
name = "ngircd"
076
2014-02-02
alex
}
077
2012-11-10
alex
078
2012-11-10
alex
networkinfo
079
2011-07-10
alex
{
080
2012-11-10
alex
# Must be set to the "MaxNickLength" setting of ngIRCd!
081
2012-11-10
alex
nicklen = 9
082
2012-11-10
alex
083
2014-02-02
alex
# When not using "strict mode", which is the default:
084
2014-02-02
alex
userlen = 20
085
2014-02-02
alex
086
2012-11-10
alex
chanlen = 50
087
2011-07-10
alex
}
088
2011-07-10
alex
089
2012-11-10
alex
In conf/nickserv.conf:
090
2011-07-10
alex
091
2014-02-02
alex
module
092
2012-11-10
alex
{
093
2014-02-02
alex
name = "nickserv"
094
2014-02-02
alex
095
2012-11-10
alex
# not required if you are running ngIRCd with a higher nickname limit
096
2012-11-10
alex
# ("MaxNickLength") than 11 characters, but REQUIRED by default!
097
2012-11-10
alex
guestnickprefix = "G-"
098
2012-11-10
alex
}
099
2012-11-10
alex
100
2012-11-10
alex
101
2012-11-04
alex
Setting up Atheme 7.0.2 or later
102
2012-11-04
alex
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
103
2012-11-04
alex
104
2020-08-04
alex
Atheme 7.0.2 or later (<https://atheme.org/>) may be used with ngIRCd using
105
2012-11-04
alex
the "ngircd" protocol module.
106
2012-11-04
alex
107
2012-11-04
alex
The following settings need to be in atheme.conf:
108
2012-11-04
alex
109
2012-11-04
alex
loadmodule "modules/protocol/ngircd";
110
2012-11-04
alex
111
2017-02-20
alex
serverinfo {
112
2017-02-20
alex
name = "services.irc.net";
113
2017-02-20
alex
}
114
2017-02-20
alex
115
2012-11-04
alex
uplink "server.irc.net" {
116
2012-11-04
alex
password = "123abc";
117
2012-11-04
alex
port = 6667;
118
2012-11-04
alex
};
119
2012-11-04
alex
120
2012-11-04
alex
The documentation of Atheme can be found in the doc/ directory of the
121
2012-11-04
alex
Atheme source distribution.
122
2012-11-04
alex
123
2012-11-04
alex
124
2008-12-02
alex
Setting up IRC Services 5.1.x
125
2008-12-02
alex
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
126
2008-12-02
alex
127
2008-12-04
alex
IRC Services 5.1.3 and above can be used with ngIRCd using the "rfc1459"
128
2008-12-04
alex
protocol module.
129
2008-12-02
alex
130
2008-12-04
alex
Please note that versions up to and including 5.1.3 contain a bug that
131
2008-12-04
alex
sometimes causes IRC Services to hang on startup. There are two workarounds:
132
2008-12-04
alex
a) send the services process a HUP signal ("killall -HUP ircservices")
133
2008-12-04
alex
b) apply this patch to the IRC Services source tree:
134
2014-03-25
alex
<http://arthur.barton.de/pub/ngircd/contrib/IRCServices513-FlushBuffer.patch>
135
2008-12-04
alex
136
2008-12-04
alex
At least the following settings have to be tweaked, in addition to all the
137
2008-12-04
alex
settings marked as required by IRC Services:
138
2008-12-04
alex
139
2008-12-02
alex
In ircservices.conf:
140
2008-12-02
alex
141
2008-12-02
alex
Variable Example value
142
2008-12-02
alex
143
2008-12-02
alex
RemoteServer server.irc.net 6667 "123abc"
144
2008-12-02
alex
ServerName "services.irc.net"
145
2008-12-02
alex
LoadModule protocol/rfc1459
146
2008-12-02
alex
147
2008-12-02
alex
In modules.conf:
148
2008-12-02
alex
149
2008-12-02
alex
Module protocol/rfc1459
150
2008-12-02
alex
151
2008-12-02
alex
The documentation of IRC Services can be found here:
152
2008-12-02
alex
<http://www.ircservices.za.net/docs/>
IRCNow