summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Changes1
-rw-r--r--docs/FAQ683
-rw-r--r--version.log6
3 files changed, 339 insertions, 351 deletions
diff --git a/Changes b/Changes
index a34ad2dab..25020110b 100644
--- a/Changes
+++ b/Changes
@@ -7,6 +7,7 @@ Provided by Anope Dev. <dev@anope.org> - 2005
07/01 A Events for channel access/xop updates. [ #00]
06/26 A New module pack module: hs_request. [ #00]
06/03 A Protocol files can now fill mod_current_buffer with custom code. [#389]
+08/29 F Organised docs/FAQ a bit more and slightly restyled it. [ #00]
08/25 F Compiler warnings in tools with gcc4. [ #00]
08/21 F Default config location in example.conf was wrong. [ #00]
08/10 F Few memleaks in bundled os_info module. [ #00]
diff --git a/docs/FAQ b/docs/FAQ
index bb0bd917f..d99ac38ad 100644
--- a/docs/FAQ
+++ b/docs/FAQ
@@ -1,443 +1,426 @@
-Frequently Asked Questions (FAQ) concerning Anope
--------------------------------------------------
+Frequently Asked Question (FAQ) concerning Anope
+------------------------------------------------
-List of Questions
+Table of Contents
-----------------
-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?
+1) General
+ 1.1) What is Anope?
+ 1.2) Where can I find Anope?
+ 1.3) Does Anope run under Windows?
+ 1.4) Can I send you questions without reading the FAQ, INSTALL or README
+ files?
+ 1.5) I need support for the XYZ protocol.
+ 1.6) Your Services program doesn't do XYZ like DALnet (or other) Services.
+ What's wrong?
+ 1.7) I've got a great new idea for Services. Do you want it?
+ 1.8) 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:
+ 1.9) Can you help me?
+ 1.10) Where is RootServ?
+
+2) Installation / Configuration
+ 2.1) When I run "make", I get an error message like "missing separator",
+ "Unassociated shell command", "Unexpected end of line seen", etc.
+ 2.2) I get an error like "Makefile.inc not found".
+ 2.3) I typed "./services" at the command line, but nothing happened!
+ 2.4) 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: ...".
+ 2.5) 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?
+ 2.6) When I say "/connect services.*", it doesn't work!
+ 2.7) Anope starts up okay, but if I try to register a nickname, it comes
+ back with "Sorry, registration failed."
+ 2.8) Anope reports (via /stats u or /msg OperServ STATS) a different number
+ of users online than I get from doing /lusers.
+
+3) OperServ
+ 3.1) Using the OperServ JUPE command results in server messages like
+ "Server juped.server introduced by non-hub server services.my.net".
+ 3.2) I can't use the ADMIN command to add Services admins, it tells me
+ "Permission denied."
+ 3.3) When I add an AKILL, the users matching it don't get killed.
+ 3.4) 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.
+ 3.5) When I used the OperServ RAW command, Anope and/or my network crashed,
+ or did weird things! Please fix this bug!
+ 3.6) I would like to have the list of the different RAW on OperServ.
+ 3.7) I can't get /OS UMODES and /OS SVSNICK to work!
+ 3.8) What is a Super-Admin? How does it work? Why might it not work?
+ 3.9) How can i enable the OperServ RAW command?
+
+4) Bugs / Crashes
+ 4.1) Anope always dies after about five minutes, saying "FATAL ERROR! Can't
+ back up nick.db".
+ 4.2) Anope crashed with a segmentation fault.
+ 4.3) I've found a bug that's not mentioned here or in the README or BUGS
+ files. What should I do?
+
+5) ChanServ
+ 5.1) 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.
+ 5.2) Anope ignored the SET SUCCESSOR setting and deleted a channel when the
+ founder expired.
+ 5.3) How to auto voice all those whom join my #channel?
+ 5.4) My RESTRICTED channel doesn't work, but everything else works
+ perfectly!
+
+6) BotServ
+ 6.1) How do I add bots to BotServ?
+
+7) Language
+ 7.1) Anope complains in the logfile about being unable to load the default
+ language.
+ 7.2) Anope spricht kein Deutsch!, etc. (Anope doesn't speak my language!)
+ 7.3) I selected a language other than English, but sometimes Anope sends
+ responses in English instead.
+
+-------------------------------------------------------------------------------
+
+1) General
+
+1.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
+ :)
+
+1.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://www.anope.org/ in the
+ main page.
-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?
+1.3) Does Anope run under Windows?
-30) When I used the OperServ RAW command, Anope and/or my network
- crashed, or did weird things! Please fix this bug!
+ Yes. For more information on how to obtain the windows version of Anope
+ visit http://windows.anope.org/
-31) I would like to have the list of the different RAW on OperServ
+1.4) Can I send you questions without reading the FAQ, INSTALL or README files?
-32) I can't get /OS UMODES and /OS SVSNICK do not work!
+ 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.
-33) What is a Super-Admin? How does it work? Why might it not work?
+1.5) I need support for the XYZ protocol.
-34) How to auto voice all those whom join my #channel?
+ Since Anope 1.7.9, support for other IRCD's, and thus protocols, has been
+ made modular. More information on making a support file for your favorite
+ IRCD can be found in the docs/IRCD file.
-35) How can i enable the OperServ RAW command?
+1.6) Your Services program doesn't do XYZ like DALnet (or other) Services.
+ What's wrong?
-36) Can you help me?
+ Nothing is wrong, except your expectations. Anope is a completely
+ different program from that used on DALnet; they are similar in concept
+ only.
-37) Where is RootServ?
+1.7) I've got a great new idea for Services. Do you want it?
-38) My RESTRICTED channel doesn't work, but everything else works perfectly!
+ 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 question 1.8 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 on our online Forum, in the Feature
+ Requests section.
+1.8) 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:
-List of answers
----------------
+ * 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.
-1) What is Anope?
+1.9) Can you help me?
- 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 :)
+ No, we can't help you unless you tell us what you need help with.
-2) Where can I find Anope?
+1.10) Where is RootServ?
- The latest version can always be found at the official Anope
- distribution site:
+ Anope does not supply RootServ. All functions you would find in RootServ
+ have been integrated into OperServ. If you really want to use RootServ, you
+ can set the OperServAlias in services.conf to be RootServ. This will enable
+ the RootServ nick to be used for OperServ as well. Read the comments near
+ OperServAlias in the configuration file for more information.
- * http://www.anope.org/
- New version announcements can also be found at http://www.anope.org/
- in the main page.
+2) Installation / Configuration
-3) Does Anope run under Windows?
+2.1) When I run "make", I get an error message like "missing separator",
+ "Unassociated shell command", "Unexpected end of line seen", etc.
- Yes. For more information visit http://windows.anope.org on how to
- obtain the windows version of Anope.
+ 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.
-4) Can I send you questions without reading the FAQ, INSTALL or README files?
+2.2) I get an error like "Makefile.inc not found".
- 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.
+ You forgot to run the Config script first. See the INSTALL file for
+ compilation instructions.
-5) When I run "make", I get an error message like "missing separator",
- "Unassociated shell command", "Unexpected end of line seen", etc.
+2.3) I typed "./services" at the command line, but nothing happened!
- 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.)
+ 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 in the
+ configuration file. (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 we 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.
+ 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.
+ As always, you can check the log file (services.log by default) for error
+ messages. You can also start services with the -nofork command line option
+ to prevent it from running in the background, and it will output the
+ messages written to the log file to the console as well.
-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: ...".
+2.4) 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 section 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?
+2.5) 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.
+ 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!
+2.6) When I say "/connect services.*", it doesn't work!
- Of course not. RTFM (Read The Fine Manual), and see the previous
- answer.
+ 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.
+2.7) Anope starts up okay, but if I try to register a nickname, it comes back
+ with "Sorry, registration failed."
- You forgot to run "make install".
+ Make sure you've selected the correct IRC server type in the configure
+ script; see question 2.4 for details.
-13) Anope always dies after about five minutes, saying "FATAL ERROR!
- Can't back up nick.db".
+2.8) Anope reports (via /stats u or /msg OperServ STATS) a different number of
+ users online than I get from doing /lusers.
- 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.
+ Anope doesn't count its own pseudo-clients (NickServ, ChanServ, etc.) in
+ its user count, while the IRC server does.
-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.
+3) OperServ
-15) Anope crashed with a segmentation fault.
+3.1) Using the OperServ JUPE command results in server messages like "Server
+ juped.server introduced by non-hub server services.my.net".
- 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.
+ Services' uplink must have an H: line for Services in the ircd.conf file,
+ which looks something like:
- 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."
+3.2) 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.
- Also, you must be a global IRC Operator and your nickname must be
- registered and properly indentified with NickServ.
+ Did you define yourself as the Services root? You need to insert your
+ nickname in the ServicesRoot directive in services.conf. Also, you must be
+ a global IRC Operator and your nickname must be registered and properly
+ indentified with NickServ.
-19) When I add an AKILL, the users matching it don't get killed.
+3.3) 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.
+3.4) 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.
- 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:
+ You need to be a global oper (i.e. user mode +o) to access OperServ. This
+ can be configured via the OSOpersOnly directive in services.conf .
- [date] Successor (SuccessorNick) of channel #somechannel owns too
- many channels, deleting channel #somechannel
+3.5) When I used the OperServ RAW command, Anope and/or my network crashed, or
+ did weird things! Please fix this bug!
- 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).
+ "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.
-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.
+3.6) I would like to have the list of the different RAW on OperServ.
- You need to be opered (i.e. user mode +o) to access OperServ.
+ If you have to ask, you should not be messing with RAW :)
-23) Anope spricht kein Deutsch!, etc. (Anope doesn't speak my
- language!)
+3.7) I can't get /OS UMODES and /OS SVSNICK to work!
- See section 5 of the README file.
+ 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
-24) I selected a language other than English, but sometimes Anope sends
- responses in English instead.
+3.8) What is a Super-Admin? How does it work? Why might it not work?
- 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.
+ 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 not commented in the services
+ configuration file. This is commented by default. Read /msg OperServ HELP
+ SET SUPERADMIN for further help.
-25) I've found a bug that's not mentioned here or in the README or
- BUGS files. What should I do?
+3.9) How can i enable the OperServ RAW command?
- See section 6 of the README file.
+ Enabling the OperServ RAW command is VERY dangerous and should never be
+ done on a real network without thinking about it very well first. The RAW
+ command can easily break your whole network if used incorrectly, and thus
+ you will receive NO SUPPORT if you enable RAW on your network.
+
+ Before you enable RAW, be very sure you really want to enable it, and keep
+ in mind that you will NOT BE ABLE to receive ANY SUPPORT anymore, because
+ Anope's stability cannot be guaranteed if RAW is enabled.
+
+ The RAW command comes bundled as a core module for operserv. To load it,
+ add the os_raw module to the list of OperServ core modules. But be sure to
+ keep in mind that when you enable the RAW command, you CANNOT GET ANY
+ SUPPORT for Anope anymore.
-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.
+4) Bugs / Crashes
-27) I've got a great new idea for Services. Do you want it?
+4.1) Anope always dies after about five minutes, saying "FATAL ERROR! Can't
+ back up nick.db".
- 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.
+ 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 Config 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.
- 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.
+4.2) Anope crashed with a segmentation fault.
- If you'd like to give us your idea, you can go to our website at
- http://www.anope.org/ and add it on our online Forum, in the Feature
- Requests section.
+ 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.
-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:
+4.3) I've found a bug that's not mentioned here or in the README or BUGS files.
+ What should I do?
- * 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.
+ See section 6 of the README file.
- * 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?
+5) ChanServ
- Read /msg BotServ HELP and /msg BotServ HELP BOT.
+5.1) 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.
-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."
+ Make sure EVERY server on your network has a U: line for Services in
+ ircd.conf, for example:
+
+ U:services.whatever.net:*:*
- 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.
+5.2) Anope ignored the SET SUCCESSOR setting and deleted a channel when the
+ founder expired.
- 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.
+ 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).
-31) I would like to have the list of the different RAW on OperServ
+5.3) How to auto voice all those whom join my #channel?
- If you have to ask, you should not be messing with RAW :)
+ Execute the following commands (/cs is an alias for /msg ChanServ):
+
+ /cs set #channel secure off
+ /cs set #channel xop off
+ /cs levels #channel set AUTOVOICE -1
-32) I can't get /OS UMODES and /OS SVSNICK do not work!
+5.4) My RESTRICTED channel doesn't work, but everything else works perfectly!
- 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
+ Make sure that you didn't put any of your IRCd's as a ULined server in
+ Anope. Clients from ULined servers are always allowed to join RESTRICTED
+ channels, without checking their access level.
-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 not commented in the services
- configuration file. This is commented by default.
- Read /msg OperServ HELP SET SUPERADMIN for further help.
+6) BotServ
-34) How to auto voice all those whom join my #channel?
+6.1) How do I add bots to BotServ?
- /cs set #channel secure off
- /cs set #channel xop off
- /cs levels #channel set AUTOVOICE -1
+ Read /msg BotServ HELP and /msg BotServ HELP BOT.
-35) How can i enable the OperServ RAW command?
- Enabling the OperServ RAW command is VERY dangerous and should
- never be done on a real network without thinking about it very
- well first. The RAW command can easily break your whole network
- if used incorrectly, and thus you will receive NO SUPPORT if you
- enable RAW on your network.
-
- Before you enable RAW, be very sure you really want to enable it,
- and keep in mind that you will NOT BE ABLE to receive ANY SUPPORT
- anymore, because Anope's stability cannot be guaranteed if RAW is
- enabled.
-
- The RAW command comes bundled as a core module for operserv. To
- load it, add the os_raw module to the list of OperServ core
- modules. But be sure to keep in mind that when you enable the RAW
- command, you CANNOT GET ANY SUPPORT for Anope anymore.
+7) Language
-36) Can you help me?
+7.1) Anope complains in the logfile about being unable to load the default
+ language.
- No, we can't help you unless you tell us what you need help with.
+ You forgot to run "make install".
-37) Where is RootServ?
+7.2) Anope spricht kein Deutsch!, etc. (Anope doesn't speak my language!)
- Anope does not supply RootServ. All functions you would find in
- RootServ have been integrated into OperServ. If you really want
- to use RootServ, you can set the OperServAlias in services.conf
- to be RootServ. This will enable the RootServ nick to be used for
- OperServ as well. Read the comments need OperServAlias in the
- configuration file for more information.
+ See section 5 of the README file.
-38) My RESTRICTED channel doesn't work, but everything else works perfectly!
+7.3) I selected a language other than English, but sometimes Anope sends
+ responses in English instead.
- Make sure that you didn't put any of your IRCd's as a ULined server
- in Anope. Clients from ULined servers are always allowed to join
- RESTRICTED channels, without checking their access level.
+ 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.
diff --git a/version.log b/version.log
index 3764e5424..43714f331 100644
--- a/version.log
+++ b/version.log
@@ -8,10 +8,14 @@
VERSION_MAJOR="1"
VERSION_MINOR="7"
VERSION_PATCH="10"
-VERSION_BUILD="857"
+VERSION_BUILD="858"
# $Log$
#
+# BUILD : 1.7.10 (858)
+# BUGS :
+# NOTES : Converted docs/FAQ to a more organized format
+#
# BUILD : 1.7.10 (857)
# BUGS :
# NOTES : Another FAQ update