forked from anope/anope
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathFAQ
423 lines (278 loc) · 15 KB
/
FAQ
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
Frequently Asked Questions (FAQ) concerning Anope
=================================================
Index:
1. What is Anope?
2. Where can I find Anope?
3. Does Anope run under Windows?
4. Can I send you questions without reading the FAQ, INSTALL or
README files?
5. When I run "make", I get an error message like "missing separator",
"Unassociated shell command", "Unexpected end of line seen", etc.
6. I get an error like "Makefile.inc not found".
7. I typed "./services" at the command line, but nothing happened!
8. I need support for the XYZ protocol.
9. Whenever I start Anope, I get a message on my IRC server saying
"connection refused" or something similar, and Anope gives an error
message from the server saying "Closing Link: ...".
10. My IRC server is giving me messages like "Connection to
services.whatever.net[127.0.0.1] activated" and then "Access denied --
no N line". Why?
11. When I say "/connect services.*", it doesn't work!
12. Anope complains in the logfile about being unable to load the
default language.
13. Anope always dies after about five minutes, saying "FATAL ERROR!
Can't back up nick.db".
14. Anope starts up okay, but if I try to register a nickname, it comes
back with "Sorry, registration failed."
15. Anope crashed with a segmentation fault.
16. Anope's channel mode setting doesn't work. I can't set modes with
OperServ, and every time ChanServ tries to set a mode, my server
reverses the change.
17. Using the OperServ JUPE command results in server messages like
"Server juped.server introduced by non-hub server services.my.net".
18. I can't use the ADMIN command to add Services admins--it tells me
"Permission denied."
19. When I add an AKILL, the users matching it don't get killed.
20. Anope reports (via /stats u or /msg OperServ STATS) a different
number of users online than I get from doing /lusers.
21. Anope ignored the SET SUCCESSOR setting and deleted a channel when
the founder expired.
22. Trying to use OperServ gives me "Access denied", but my nick is in the
ServicesRoot directive and is registered, and I've identified for my
nick.
23. Anope spricht kein Deutsch!, etc. (Anope doesn't speak my
language!)
24. I selected a language other than English, but sometimes Anope sends
responses in English instead.
25. I've found a bug that's not mentioned here or in the
BUGS files. What should I do?
26. Your Services program doesn't do XYZ like DALnet Services. What's
wrong?
27. I've got a great new idea for Anope. Do you want it?
28. Examples of features I have been asked about and why we won't add (or
haven't yet added) them--so don't ask us about them.
29. How do I add bots to BotServ?
30. When I used the OperServ RAW command, Anope and/or my network
crashed, or did weird things! Please fix this bug!
31. I would like to have the list of the differents RAW on operserv
32. I can't get /OS UMODES and /OS SVSNICK do not work!
33. What is a Super-Admin? How does it work? Why might it not work?
---------------------------------------------------------------------------
1. What is Anope?
Anope is a set of services for IRC networks. See the README
file for more information. And in case you were wondering,
Anope is Epona spelt backwards :)
2. Where can I find Anope?
The latest version can always be found at the official Anope
distribution site:
http://www.anope.org/
New version announcements can also be found at http://anope.zero.org/
in the Announcement section.
3. Does Anope run under Windows?
Well... not officialy. Bu there is a cygwin based patch that makes
Anope work on Windows. Note, however, that some features might not
work, and you should take that into consideration when answering
the questions of ./configure (i.e. MySQL, Modules).
You can obtain a pre-build copy of Anope for Windoes from
http://www.wircds.net/ although we have "blessed" that port,
we do not provide support for it. If you can't get it work,
go to wIRCds.net forum.
If you feel capable of taking ownership of an official windows
port, and to keep it current, please let the current Development
team know.
4. Can I send you questions without reading the FAQ, INSTALL or README
files?
No. If you don't read those files, your messages will most probably
be ignored. We don't mean to be rude, but if we took the time
to write down some documentation, we'd expect you to take some
time to read it.
5. When I run "make", I get an error message like "missing separator",
"Unassociated shell command", "Unexpected end of line seen", etc.
Your make program isn't compatible with the Makefile for Anope.
The Makefile was designed to work with GNU make, and as such may
not work on other systems' "make" programs. If you get an error
from "make", obtain GNU make from ftp://prep.ai.mit.edu/pub/gnu/
(or wherever you prefer) and use it instead of your system's
default "make". Note that GNU make may already be installed on
your system; try using the command "gmake" instead of "make".
The make programs bundled with SunOS/Solaris and FreeBSD have been
reported not to work; you will need to use GNU make on these
systems.
6. I get an error like "Makefile.inc not found".
You forgot to run the configure script first. See the INSTALL file
for compilation instructions.
7. I typed "./services" at the command line, but nothing happened!
Anope puts itself in the background when it starts, so you get
your shell prompt right back. Meanwhile, Anope will continue
setting up, then connect to the IRC server specified in
services.conf (or on the command line). If it doesn't connect, you
probably specified the wrong server type when running the configure
script. (Also make sure that you are actually running one of the
supported servers. There are a gazillion different variations on
the basic IRC protocol out there, and I have neither the time nor
the desire to add support for them.)
The recommended server, under which Epona (the original code base
used by Anope) was developed, is Bahamut. DreamForge 4.6.7 will also
work fine, but it's a bit obsolete nowadays. Derivatives of Bahamut
and DreamForge may also work, if they don't change the server<->server
protocol too much; contact their authors for more information.
Most people, though, are running Anope with UnrealIRCd, UltimateIRCd
or Bahamut.
As always, you can check the log file (services.log by default) for
error messages.
8. I need support for the XYZ protocol.
Hang in there! We are working on making Anope protocol independent.
It should show up sometime soon... more details to follow.
9. Whenever I start Anope, I get a message on my IRC server saying
"connection refused" or something similar, and Anope gives an error
message from the server saying "Closing Link: ...".
See seection 3 of the INSTALL file.
10. My IRC server is giving me messages like "Connection to
services.whatever.net[127.0.0.1] activated" and then "Access denied --
no N line". Why?
This is typically caused by including a port number in the C:line
for services, which tells your server to try to autoconnect to it
(depending on the class (Y:line) settings). This is not what you
want, because Anope will connect to the server itself, but does
not listen for servers to connect to it. The solution is to remove
the port number from the C:line.
11. When I say "/connect services.*", it doesn't work!
Of course not. RTFM (Read The Fine Manual), and see the previous
answer.
12. Anope complains in the logfile about being unable to load the
default language.
You forgot to run "make install".
13. Anope always dies after about five minutes, saying "FATAL ERROR!
Can't back up nick.db".
Make sure that the user Anope runs as has write access to the
data directory, and that the data directory actually exists (the
latter shouldn't be a problem if you ran the configure script).
This means Anope needs write and execute permission on the data
directory itself and execute permission on every parent directory
of the data directory.
14. Anope starts up okay, but if I try to register a nickname, it comes
back with "Sorry, registration failed."
Make sure you've selected the correct IRC server type in the
configure script; see question 9 for details.
15. Anope crashed with a segmentation fault.
See if you can reproduce this by doing a certain sequence of
things. If so, please report it to us (see part 6 of README file). If
not, you're probably out of luck; if you like, you can report it to
us anyway, but chances are it won't get fixed if we don't have
instructions on reproducing it. If you do have such a problem, you
may find the crontab utility useful for dealing with it.
Also, see the DumpCore directive in the configuration file. It allows
Anope to dump its core whenever it's segfaulting, usually calling it
core and placing it into Anope's main directory.
Open up gdb by issuing the following command at your shell:
gdb services core
(of course replacing 'core' with the name of the core if different)
and type 'bt' at the gdb prompt. After that, send us the output you
got and keep the core file in a safe place, in case we need it to
dig deeper into the problem.
16. Anope's channel mode setting doesn't work. I can't set modes with
OperServ, and every time ChanServ tries to set a mode, my server
reverses the change.
Make sure EVERY servers on your network has a U: line for Services in
ircd.conf, for example:
U:services.whatever.net:*:*
17. Using the OperServ JUPE command results in server messages like
"Server juped.server introduced by non-hub server services.my.net".
Services' uplink must have an H: line for Services in the
ircd.conf file, which looks something like:
H:*::services.whatever.net
18. I can't use the ADMIN command to add Services admins--it tells me
"Permission denied."
Did you define yourself as the Services root? You need to insert
your nickname in the ServicesRoot directive in services.conf.
19. When I add an AKILL, the users matching it don't get killed.
Use the AkillOnAdd configuration directive.
20. Anope reports (via /stats u or /msg OperServ STATS) a different
number of users online than I get from doing /lusers.
Anope doesn't count its own pseudo-clients (NickServ, ChanServ,
etc.) in its user count.
21. Anope ignored the SET SUCCESSOR setting and deleted a channel when
the founder expired.
Normally, this is because the successor had too many channels
registered; in this case, you will see an entry in the log file
like the following:
[date] Successor (SuccessorNick) of channel #somechannel owns too
many channels, deleting channel #somechannel
If you don't get a message like this or you can verify that the
successor wasn't running into the channel limit, please report it
using the bug-reporting procedure below (see section 6 of the
README file).
22. Trying to use OperServ gives me "Access denied", but my nick is in the
ServicesRoot directive and is registered, and I've identified for my
nick.
You need to be opered (i.e. user mode +o) to access OperServ.
23. Anope spricht kein Deutsch!, etc. (Anope doesn't speak my
language!)
See section 5 of the README file.
24. I selected a language other than English, but sometimes Anope sends
responses in English instead.
Some language files are not complete--in other words, they don't
have a translation of every message Anope uses, but only some of
them. In this case, the missing messages will be displayed in
English. You can either wait for the primary translator to provide
us with a translation, or do the translation yourself and send us
the messages translated into your language.
25. I've found a bug that's not mentioned here or in the README or
BUGS files. What should I do?
See section 6 of the README file.
26. Your Services program doesn't do XYZ like DALnet (or other) Services.
What's wrong?
Nothing is wrong, except your expectations. Anope is a
completely different program from that used on DALnet; they are
similar in concept only.
27. I've got a great new idea for Services. Do you want it?
We are always interested in hearing new ideas. HOWEVER, do not
expect your proposal to be in the next Anope release for sure.
As a rule, we usually don't add anything that can be equivalently
done by other means, or that we consider totally useless; see below
for examples of things we don't plan to add.
Our general intent is for Anope to provide as much functionality
as possible--while staying as lean as possible. So features which
are arguably beneficial will tend to be added, while features of
limited or no benefit or which can be equally provided by something
else already in use will tend to be passed over.
If you'd like to give us your idea, you can go to our website at
http://www.anope.org/ and add it as a Feature Request on our Bug
Tracking System. Or, if unsure, you can discuss it on our online
Forum, in the Ideas and Suggestions section.
28. Examples of features we have been asked about and why we won't add (or
haven't yet added) them--so don't ask us about them:
- An option to make ChanServ stay in some/all registered channels:
we see absolutely no necessity for this feature, since BotServ
already does this anyway.
- A "current time" field in NickServ and ChanServ INFO displays:
Most people have clocks of some sort either on their computer
screens or on their walls (or both), and all IRC servers, as well
as Services, have a command to return the server's current time.
Thus a current-time field in INFO displays would simply take up
extra space for no reason.
29. How do I add bots to BotServ?
Read /msg BotServ HELP and /msg BotServ HELP BOT.
30. When I used the OperServ RAW command, Anope and/or my network
crashed, or did weird things! Please fix this bug!
"That's not a bug, it's a feature."
Have you ever typed /msg OperServ HELP RAW? It's clearly stated
there that this command is dangerous and that its use may result
in very bad things.
And that's why this command has been disabled by default. If you
enabled and used it, YOU'RE ON YOUR OWN. All help requests will
be ignored, even if the problem happens not immediately.
31. I would like to have the list of the differents RAW on operserv
If you have to ask, you should not be messing with RAW :)
32. I can't get /OS UMODES and /OS SVSNICK do not work!
Make sure you the USE_OSSVS is defined on config.h. Since these
are very controversial commands, they are turned off by default.
Then, make clean ; make ; make install
33. What is a Super-Admin? How does it work? Why might it not work?
Super-Admin's have extra privileges, including being founder on
all channels. It must be activated on a per user basis and is
only available to Services Admins and Services Roots.
It is set using OperServ and is not persistent.
It only works if SuperAdmin is uncommented in the services
configuration file. This is commented by default.
Read /msg OperServ HELP SET SUPERADMIN for further help.