diff options
Diffstat (limited to 'docs/FAQ')
| -rw-r--r-- | docs/FAQ | 423 |
1 files changed, 423 insertions, 0 deletions
diff --git a/docs/FAQ b/docs/FAQ new file mode 100644 index 000000000..014d3a34d --- /dev/null +++ b/docs/FAQ @@ -0,0 +1,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. |