summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAdam <Adam@anope.org>2015-01-05 16:31:09 -0500
committerAdam <Adam@anope.org>2015-01-05 19:00:51 -0500
commitd79d8e2608e304760c42bdf87502e3bc51781b88 (patch)
tree179913b8b328f88d52d84c3453fceb28a2d63422 /docs
parent8ab1c71d7dc7a0d47e5711dc72e3fc9c3ee850bb (diff)
parentc46ec39e5088119cd21f5f7e16e64e61a876ca20 (diff)
Merge branch '2.0' into 2.1
Conflicts: CMakeLists.txt include/modules.h include/serialize.h modules/commands/bs_assign.cpp modules/commands/bs_badwords.cpp modules/commands/bs_bot.cpp modules/commands/bs_control.cpp modules/commands/bs_kick.cpp modules/commands/cs_access.cpp modules/commands/cs_akick.cpp modules/commands/cs_drop.cpp modules/commands/cs_entrymsg.cpp modules/commands/cs_flags.cpp modules/commands/cs_info.cpp modules/commands/cs_invite.cpp modules/commands/cs_kick.cpp modules/commands/cs_mode.cpp modules/commands/cs_register.cpp modules/commands/cs_seen.cpp modules/commands/cs_set.cpp modules/commands/cs_suspend.cpp modules/commands/cs_topic.cpp modules/commands/cs_unban.cpp modules/commands/cs_xop.cpp modules/commands/hs_del.cpp modules/commands/hs_list.cpp modules/commands/hs_request.cpp modules/commands/ms_ignore.cpp modules/commands/ms_send.cpp modules/commands/ns_recover.cpp modules/commands/ns_register.cpp modules/commands/ns_suspend.cpp modules/commands/os_dns.cpp modules/commands/os_noop.cpp modules/commands/os_oper.cpp modules/commands/os_session.cpp modules/database/db_sql_live.cpp modules/encryption/enc_bcrypt.cpp modules/extra/m_ldap_authentication.cpp modules/extra/m_ldap_oper.cpp modules/fantasy.cpp modules/m_dnsbl.cpp modules/m_sasl.cpp modules/protocol/hybrid.cpp modules/protocol/inspircd20.cpp modules/protocol/unreal.cpp modules/pseudoclients/chanserv.cpp modules/pseudoclients/nickserv.cpp modules/webcpanel/pages/chanserv/access.cpp modules/webcpanel/webcpanel.cpp modules/webcpanel/webcpanel.h src/command.cpp src/messages.cpp src/modulemanager.cpp src/regchannel.cpp src/serialize.cpp
Diffstat (limited to 'docs')
-rw-r--r--docs/Changes.conf6
-rw-r--r--docs/INSTALL23
-rw-r--r--docs/INSTALL.fr199
3 files changed, 105 insertions, 123 deletions
diff --git a/docs/Changes.conf b/docs/Changes.conf
index de9074f11..c4a5d8ff7 100644
--- a/docs/Changes.conf
+++ b/docs/Changes.conf
@@ -1,3 +1,9 @@
+Anope Version 2.0.2
+-------------------
+Add an operserv/oper/modify privilege, required to use oper add and oper del
+Add a chanserv/access/list privilege, which allow readonly access to ChanServ access and akick lists
+Changed m_dnsbl's result configuration to be more extensible
+
Anope Version 2.0.1
-------------------
Add MUTE command to BotServ fantasy configuration
diff --git a/docs/INSTALL b/docs/INSTALL
index 6d614d0e6..0a923ef97 100644
--- a/docs/INSTALL
+++ b/docs/INSTALL
@@ -21,26 +21,19 @@ Note: You should also read the README and FAQ files!
http://www.anope.org/
- Anope can be built one of two ways. The recommended way is to use CMake.
- You can check if CMake is already installed on your system using the
- command:
+ Anope requires cmake to build. You can check if CMake is already
+ installed on your system using the command:
cmake --version
If it's installed, you will get a line that says something similar to
- "cmake version 2.6-patch 1". If the version is less than 2.4 or you get
+ "cmake version 2.8.12.2". If the version is less than 2.4 or you get
an error saying the command was not found, you will not be able to use
CMake unless you install it yourself into your home directory. CMake
can be downloaded from:
http://www.cmake.org/cmake/resources/software.html
- If you are unable to install CMake yourself (either due to lack of space
- or restrictions by your hosting provider), you still have the alternative
- to use the provided configure script. This option is not recommended and
- will eventually be phased out, but is provided for compatibility for those
- lacking CMake.
-
Next, unpack the package in your home directory, and go into the created
directory.
@@ -51,16 +44,8 @@ Note: You should also read the README and FAQ files!
Now type ./Config to start the configuration script. It will ask you a
few questions, and figure out how to compile Anope on your system. If
you are unsure about the answer to a question, use the default value.
- The question to using configure or cmake depends on your decision from
- above. If you have CMake and wish to use it, answer with cmake, otherwise
- answer with configure.
-
- You can now type make to compile Anope. If there are errors in the
- Makefile, *try to use gmake* instead. If it still doesn't work, you (or
- the system administrator if it's a shell) must install GNU make. You may
- find it at ftp://prep.ai.mit.edu/pub/gnu/.
- Now type make install (or gmake install; see above). This will install
+ Now cd build and type make and make install. This will install
all the needed files in the paths you specified with the configure
script, and setup file permissions. You should ensure that the data
directory is not accessible by other users, as malicious users may
diff --git a/docs/INSTALL.fr b/docs/INSTALL.fr
index 8baa108e8..f7af3aac8 100644
--- a/docs/INSTALL.fr
+++ b/docs/INSTALL.fr
@@ -1,5 +1,5 @@
Instructions d'installation d'Anope
-------------------------------------
+-----------------------------------
1) Installation d'Anope
2) Mettre à jour Anope
@@ -11,148 +11,139 @@ Note : Vous devrez également lire les fichiers README et FAQ !
1) Installation d'Anope
- NOTE IMPORTANTE : il n'est pas recommandé d'utiliser (et même d'installer)
- Anope en tant que root. Utilisez un utilisateur non
- privilégié. Celui que vous utilisez pour l'IRCd ou un
- utilisateur dédié suffira.
+ NOTE IMPORTANTE : il est déconseillé d'utiliser (et même d'installer)
+ Anope en tant que root. Utilisez un utilisateur non
+ privilégié. Celui que vous utilisez pour l'IRCd ou
+ un utilisateur dédié suffira.
- La première chose que vous devez faire est d'obtenir le package Anope (si ce
- n'est déjà fait). Vous pouvez le trouver ici :
+ La première chose que vous devez faire est d'obtenir le package Anope
+ (si ce n'est déjà fait). Vous pouvez le trouver ici :
- http://www.anope.org/
+ http://www.anope.org/
- Anope peut être installé de deux façons. La méthode recommandée est
- d'utiliser CMake. Vous pouvez vérifier si CMake est déjà installé
- sur votre système en utilisant la commande :
+ Anope nécessite cmake pour être compilé. Vous pouvez vérifier si CMake
+ est déjà installé sur votre système avec la commande :
cmake --version
- Si CMake est installé, vous aurez une ligne qui dit quelque chose similaire
- à "cmake version 2.6 cmake-patch 1". Si la version est inférieure à 2.4 ou
- si vous obtenez une erreur disant que la commande n'a pas été trouvée,
- vous ne serez pas en mesure d'utiliser CMake, sauf si vous l'installez
- vous-même dans votre répertoire home. CMake peut être téléchargé ici :
+ Si CMake est installé, vous aurez une ligne qui dit quelque chose comme
+ "cmake version 2.8.12.2". Si la version est inférieure à 2.4 ou si vous
+ obtenez une erreur disant que la commande n'a pas été trouvée, vous ne
+ pourrez pas utiliser CMake à moins de l'installer vous-même dans votre
+ répertoire home. CMake peut être téléchargé ici :
http://www.cmake.org/cmake/resources/software.html
- Si vous n'arrivez pas à l'installer (soit en raison du manque d'espace
- ou de restrictions par votre fournisseur d'hébergement), vous pouvez encore
- utiliser le script de configuration fourni. Cette option n'est pas
- recommandée et finira par être retirée, mais est fournie pour la
- compatibilité de ceux à qui il manque CMake.
-
- Ensuite, décompressez le package dans votre répertoire home, et allez dans
- le répértoire qui vient d'être créé.
-
- Maintenant, tapez ./Config pour lancer le script de configuration. Il va
- vous poser quelques questions, et compiler Anope sur votre système. Si vous
- ne savez pas répondre à une question, utilisez la valeur par défaut. La
- question d'utiliser CMake ou configure dépend de la décision que vous avez
- prise précedemment. Si vous avez CMake et que vous souhaitez l'utiliser,
- répondez avec cmake, sinon répondez avec configure.
-
- Vous pouvez maintenant taper make pour compiler Anope. S'il y'a des erreurs
- dans le Makefile, *essayez d'utiliser* gmake à la place. Si cela ne
- fonctionne toujours pas, vous (ou votre administrateur système) devriez
- installer GNU make.
- Vous pouvez le trouver ici : ftp://prep.ai.mit.edu/pub/gnu/.
-
- Maintenant, tapez make install (ou gmake install ; voir ci-dessus). Cela
- permet d'installer tous les fichiers nécessaires dans les chemins que vous
- avez spécifié au script configure, et de régler les permissions des fichiers.
- Vous devez vous assurer que le répertoire data n'est pas accessible par les
- autres utilisateurs, des utilisateurs malveillants pourraient causer des
- problèmes sur votre réseau, si les mots de passe ne sont pas chiffrés,
- ou lire les mémos de tout utilisateur.
-
- Si vous voyez des erreurs lors de ce processus, merci de nous envoyer un
- e-mail avec la sortie d'erreur *complète* et n'oubliez pas de mentionner
- les versions de votre système, compilateur et bibliothèque C++.
-
- Allez maintenant dans le répertoire de données (par défaut, ~/services/data).
- Copiez l'exemple de fichier de configuration (example.conf) en services.conf
- et ouvrez ce dernier avec votre éditeur de texte favori. Il contient toute
- les directives de configuration. Anope va l'utiliser au démarrage.
- Lisez attentivement les instructions contenues dans le fichier.
- L'utilisation des valeurs par défaut n'est pas recommendé et Anope ne
- fonctionnera probablement pas.
-
- Si vous avez besoin d'aide, abonnez-vous à la liste de diffusion Anope
- et envoyez-y vos e-mails pour obtenir de l'aide de la part des autres
- utilisateurs. Voir le fichier README pour plus d'informations.
+ Ensuite, décompressez le package dans votre répertoire home, et allez
+ dans le répértoire qui vient d'être créé.
+
+ Si il y a des modules facultatifs que vous voulez activer comme m_mysql,
+ exécuter le script 'extras' pour les activer. Si vous ne savez pas, vous
+ pouvez les activer plus tard.
+
+ Maintenant, tapez ./Config pour lancer le script de configuration. Il
+ va vous poser quelques questions, et déterminer comment compiler Anope
+ sur votre système. Si vous ne savez pas comment répondre à une question,
+ utilisez la valeur par défaut.
+
+ Allez dans le dossier build (cd build) et tapez make et make install.
+ Ceci va installer tous les fichiers nécessaires dans les dossiers que
+ vous avez indiqués avec le script Config et régler les permissions des
+ fichiers. Vous devez vous assurer que le répertoire data n'est pas
+ accessible par les autres utilisateurs, car des utilisateurs
+ malveillants pourraient causer des problèmes sur votre réseau, si les
+ mots de passe ne sont pas chiffrés, ou lire les mémos de tous les
+ utilisateurs.
+
+ Allez maintenant dans le répertoire conf (par défaut, ~/services/conf).
+ Copiez l'exemple de fichier de configuration (example.conf) en
+ services.conf et ouvrez ce dernier avec votre éditeur de texte favori.
+ Il contient toutes les directives de configuration qu'Anope va utiliser
+ en démarrant. Lisez attentivement les instructions contenues dans le
+ fichier. L'utilisation des valeurs par défaut n'est pas toujours
+ recommandée, et Anope ne fonctionnera probablement pas !
+
+ Si vous avez besoin d'aide, vous pouvez aller sur le site
+ http://forum.anope.org/ ou le canal #anope sur irc.anope.org.
+ Fournissez *l'essemble* des erreurs qui apparaîssent, en plus de
+ toutes informations utiles, comme les versions de votre OS, du
+ compilateur utilisé et de la librairie C++. Lisez le fichier README
+ pour plus d'informations.
2) Mettre à jour Anope
- Pour mettre à jour Anope, suivez simplement les instructions d'installation
- décrites dans la section 1. Il y a cependant une ligne de conduite
- spécifique :
+ Pour mettre à jour Anope, suivez simplement les instructions
+ d'installation décrites dans la section 1. Prenez garde cependant :
* IMPORTANT : Sauvegardez vos anciennes bases de données !
- * Si vous mettez à jour vers une nouvelle version majeure, toujours
- redémarrer avec un fichier de configuration neuf depuis example.conf.
+ * Si vous mettez à jour vers une nouvelle version majeure,
+ recommencez *toujours* toute votre configuration à partir du
+ fichier example.conf.
3) Configuration de l'IRCd
Les Services agissent comme un serveur IRC avec des pseudo-clients.
- Pour les relier à votre réseau, vous aurez besoin de configurer votre IRCd
- pour permettre aux services de linker.
+ Pour les relier à votre réseau, vous aurez besoin de configurer votre
+ IRCd pour permettre aux services de se connecter.
- La configuration varie selon les IRCd, mais vous aurez probablement besoin
- d'un block link (aussi appelé connect block, ou C line), un U line (aussi
- appelé shared block) et assurez-vous que l'IRCd écoute sur le port donné
- dans le block link.
+ La configuration dépend de l'IRCd utilisé, mais vous aurez probablement
+ besoin d'un bloc link (aussi appelé connect block, ou C:line) et un
+ U:line (aussi appelé shared block). Assurez-vous que l'IRCd écoute
+ sur le port donné dans le bloc link.
- Des exemples de configurations de link peuvent être trouvés dans le fichier
- example.conf pour certains des IRCd les plus populaires.
+ Des exemples de configurations de bloc link peuvent être trouvés dans
+ le fichier example.conf pour certains des IRCd les plus populaires.
Souvenez-vous de /rehash votre IRCd pour appliquer les changements.
- Vous pouvez également essayer notre créateur de link interactif situé ici :
+ Vous pouvez également essayer notre créateur de bloc link interactif
+ situé ici :
http://anope.org/ilm.php
4) Mettre en route Anope
- Allez dans le répertoire où les fichiers binaires ont été installés (par
- défaut, ~/services/bin). Tapez ./services pour lancer Anope.
+ Allez dans le répertoire où les fichiers binaires ont été installés
+ (par défaut, ~/services/bin). Tapez ./services pour lancer Anope.
- S'il ya des erreurs de syntaxe dans le fichier de configuration, elles
- seront affichées sur l'écran. Corrigez-les jusqu'à ce qu'il n'y en ait plus.
- Un démarrage réussi ne générera pas de message.
+ S'il y a des erreurs de syntaxe dans le fichier de configuration, elles
+ seront affichées à l'écran. Corrigez-les jusqu'à ce qu'il n'y en ait
+ plus. Un démarrage réussi ne générera pas de message.
- Donnez aux services au moins une minute pour se connecter à votre réseau.
- Certains IRCds sur certains systèmes peuvent être très lents pour le
- processus de liaison. Si rien n'arrive après environ une minute, il y a
- probablement un problème de configuration. Essayez de lancer Anope en mode
- debug ./services -debug -nofork pour voir toutes les erreurs rencontrées
- et essayez de les corriger.
+ Donnez aux services au moins une minute pour se connecter à votre
+ réseau, car certains IRCds sur certains systèmes peuvent être très
+ lents pour le processus de liaison. Si rien ne se passe après environ
+ une minute, il y a probablement un problème de configuration. Essayez
+ de lancer Anope en mode debug avec ./services -debug -nofork pour voir
+ toutes les erreurs rencontrées et essayez de les corriger.
- Si vous avez besoin d'aide pour résoudre des erreurs, n'hésitez pas à vous
- abonner à la liste de diffusion Anope et d'y poser vos question.
+ Si vous avez besoin d'aide pour résoudre des erreurs, n'hésitez pas à
+ vous abonner à la liste de diffusion Anope et d'y poser vos question.
Voir le fichier README pour plus de détails.
5) Mettre en place un crontab
- Une entrée crontab vous permettra de vérifier périodiquement si Anope est
- toujours en cours d'exécution et de le redémarrer s'il n'est pas.
+ Une entrée crontab vous permettra de vérifier périodiquement si Anope
+ est toujours en cours d'exécution et de le redémarrer s'il n'est pas.
- D'abord renommez le script example.chk qui est dans le chemin d'Anope
- (par défaut, ~/services/data) en services.chk et modifiez-le. Vous aurez
- besoin de modifier la partie CONFIGURATION du fichier. Assurez-vous ensuite
- que le fichier est marqué comme exécutable en tapant chmod +x services.chk
- et essayez de lancer le script pour voir si cela fonctionne (Anope ne doit
- pas être en marche lorsque vous faites cela ;))
+ D'abord renommez le script example.chk qui est dans les dossiers
+ d'Anope (par défaut, ~/services/conf) en services.chk et modifiez-le.
+ Vous aurez besoin de modifier la partie CONFIGURATION du fichier.
+ Assurez-vous ensuite que le fichier est marqué comme exécutable en
+ tapant chmod +x services.chk et essayez de lancer le script pour voir
+ si cela fonctionne (Anope ne doit pas être en marche lorsque vous
+ testez cela ;))
- Lorsque c'est fait, vous devrez ajouter l'entrée crontab. Tapez crontab -e.
- Cela va ouvrir l'éditeur de texte par défaut avec le fichier crontab.
- Entrez la ligne suivante (avec le chemin correct) :
+ Lorsque c'est fait, vous devrez ajouter l'entrée crontab. Entrez
+ crontab -e. Cela va ouvrir l'éditeur de texte par défaut avec le
+ fichier crontab. Entrez la ligne suivante (avec le chemin correct) :
- */5 * * * * /home/ircd/services/data/services.chk > /dev/null 2>&1
+ */5 * * * * /home/ircd/services/conf/services.chk > /dev/null 2>&1
Le */5 au début signifie "vérifier toutes les 5 minutes". Vous pouvez
- remplacer le 5 par un autre numéro si vous voulez (mais moins de 60).
- Consultez pages de manuel de votre système pour plus de détails sur la
- syntaxe du fichier crontab. Les pages de manuel intéressantes sont
+ remplacer le 5 par un autre numéro si vous voulez (mais moins de 60).
+ Consultez les pages de manuel de votre système pour plus de détails sur
+ la syntaxe du fichier crontab. Les pages de manuel intéressantes sont
crontab(5), crontab(1) et cron(8).
- Sauvegardez, quittez et c'est installé.
+ Sauvegardez, quittez, et c'est installé !