Provided by:
enemies-of-carlotta_1.2.6-4_all 
NOM
enemies-of-carlotta - Gestionnaire simple de listes de diffusion
SYNOPSIS
enemies-of-carlotta [options] [adresses]
DESCRIPTION
enemies-of-carlotta est un gestionnaire simple de listes de diffusion.
Enemies of Carlotta conserve toutes les donnees des listes dans le
repertoire ~/.enemies-of-carlotta. Celui-ci sera cree automatiquement
lors de la creation de la premiere liste. Le traitement des courriels
par le gestionnaire de listes doit etre configure manuellement. Les
details peuvent varier d'un systeme a l'autre. Pour QMail et Postfix,
voir ci-dessous.
Chaque liste possede un ou plusieurs proprietaires, qui moderent
egalement les inscriptions ou certains messages, voire tous. Sur les
listes non moderees, les proprietaires de la liste sont charges de
repondre aux questions concernant la liste. Sur les listes totalement
moderees, ils doivent approuver chaque message avant qu'il ne soit
envoye sur la liste. Sur les liste ou posting=auto, les messages des
abonnes sont automatiquement envoyes a la liste, et les moderateurs
n'ont besoin d'approuver que les messages qui ne proviennent pas des
abonnes.
OPTIONS
--name=foo@example.com
preciser la liste sur laquelle la commande doit etre effectuee.
La plupart des options doivent etre accompagnees du nom de la
liste concernee. Avec les options --edit, --subscribe,
--unsubscribe et --list, le nom peut etre abrege en enlevant le
signe @ et le domaine.
--create
creer une nouvelle liste de diffusion. Au moins un proprietaire
doit etre precise a l'aide de --owner.
--owner=adresse
ajouter un proprietaire a la liste lors de sa creation
--moderator=adresse
ajouter un moderateur a la liste lors de sa creation ou de son
edition
--language=code-de-la-langue
configurer le code de la langue utilise pour recuperer les
fichiers modeles. Le code peut etre vide (l'anglais sera utilise
par defaut) ou compose de deux lettres comme fr ou es.
--cleaning-woman
gerer les adresses invalides et nettoyer quelques autres
elements. La commande enemies-of-carlotta --cleaning-woman doit
etre lancee periodiquement, comme une fois par heure, pour
nettoyer l'ensemble des listes de diffusion.
--destroy
detruire une liste
--edit modifier la configuration d'une liste
--subscription=type
definir le mode d'abonnement a free (libre) ou moderated
(modere) lors de la creation de la liste. A utiliser en
combinaison avec --edit ou --create.
--posting=type
definir le mode d'envoi a free (libre), auto (automatique) ou
moderated (modere). A utiliser en combinaison avec --edit ou
--create.
--archived=yes-ou-no
definir si les messages de la liste doivent etre archives dans
le sous-repertoire archive-box du repertoire de la liste,
lui-meme present dans le repertoire ~/.enemies-of-carlotta.
Utiliser yes (oui) ou no (non).
--mail-on-subscription-changes=yes-ou-no
definir si les proprietaires de la liste doivent etre avertis
lors d'un abonnement ou d'un desabonnement. Utiliser yes (oui)
ou no (non). La valeur par defaut est no.
--mail-on-forced-unsubscription=yes-ou-no
definir si les proprietaires de la liste doivent etre avertis
lorsque quelqu'un est retire de la liste en raison d'une adresse
trop souvent invalide. Utiliser yes (oui) ou no (non). La valeur
par defaut est no.
--ignore-bounce=yes-ou-no
definir si les renvois pour adresse invalide doivent etre
ignores. Utiliser yes (oui) ou no (non). La valeur par defaut
est no.
--list lister l'ensemble des abonnes a une liste.
--subscribe
ajouter des abonnes a la liste. Les arguments qui ne sont pas
des options sont les adresses a abonner. Les adresses ajoutees
de cette facon ne recevront pas de demande de confirmation.
--unsubscribe
enlever des abonnes de la liste. Les arguments qui ne sont pas
des options sont les adresses a desabonner. Les adresses
enlevees de cette maniere ne recevront pas de demande de
confirmation.
--incoming
traiter un message entrant sur l'entree standard. L'adresse de
l'expediteur de l'enveloppe SMTP doit etre precisee par la
variable d'environnement SENDER et l'adresse du destinataire de
l'enveloppe SMTP doit etre precisee par la variable
d'environnement RECIPIENT. (QMail et Postfix traitent cela
automatiquement.)
--skip-prefix=cha^ine
retirer cha^ine du debut de l'adresse de destination avant de
l'analyser pour determiner a quelle liste le message est
destine. Ceci permet le traitement des domaines virtuels avec
QMail et Postfix, voir ci-dessous.
--domain=nom.du.domaine
remplacer le nom de domaine par nom.du.domaine dans l'adresse de
destination pour determiner a quelle liste le message est
destine. Ceci permet le traitement des domaines virtuels avec
QMail et Postfix.
--is-list
determiner si l'adresse indiquee par --name fait reference a une
liste valide. Le code de sortie zero (succes) est retourne si
c'est le cas, un (echec) dans le cas contraire.
--sendmail=chemin
utiliser chemin au lieu de /usr/sbin/sendmail pour envoyer des
courriels via une interface en ligne de commande. Cette commande
doit respecter l'interface de la ligne de commande sendmail.
--smtp-server=h^ote
envoyer les courriels en utilisant le serveur SMTP sur h^ote
(port 25). Le serveur doit etre configure pour permettre a la
machine sur laquelle fonctionne la liste de l'utiliser comme
relais. Par defaut, l'interface en ligne de commande est
utilisee. L'envoi par SMTP n'est utilise qu'avec cette option.
--qmqp-server=h^ote
envoyer les courriels en utilisant le serveur QMQP sur h^ote
(port 628). Le serveur doit etre configure pour permettre a la
machine sur laquelle fonctionne la liste de l'utiliser comme
relais. Par defaut, l'interface en ligne de commande est
utilisee. L'envoi par QMQP n'est utilise qu'avec cette option.
--moderate
forcer un message entrant a etre modere, meme s'il est envoye a
une liste ou l'envoi est libre. Cela peut etre utilise pour
filtrer les courriers indesirables : les messages entrants
peuvent etre filtres par n'importe quel systeme de filtrage des
courriels ; des lors qu'un message semble etre indesirable, une
moderation par un humain peut etre demandee.
--post forcer un message entrant a etre envoye, meme s'il est envoye a
une liste ou l'envoi est modere. Cela peut etre utilise
lorsqu'une verification externe a lieu pour definir si le
courriel est acceptable sur la liste, par exemple en verifiant
les signatures electroniques.
--quiet
ne pas envoyer les messages de debogage des journaux sur la
sortie d'erreur standard, contrairement au comportement par
defaut.
--sender=foo@example.com
--recipient=foo@example.com
ecraser les variables d'environnement SENDER et RECIPIENT
respectivement, a utiliser en combinaison avec --incoming et
--is-list.
--get obtenir les valeurs d'une ou plusieurs variables de
configuration. Le nom des variables est indique sur la ligne de
commande apres les options. Chaque valeur est affichee sur une
ligne separee.
--set configurer les valeurs d'une ou plusieurs variables de
configuration. Les noms et valeurs sont donnes sur la ligne de
commande apres les options et separes par un signe d'egalite
(<< = >>). Par exemple, la commande suivante configurerait une
liste en francais : enemies-of-carlotta --name=foo@bar --set
language=fr
--version
afficher la version du programme
--show-lists
lister les listes connues de enemies-of-carlotta
CONFIGURATION
Chaque liste est representee par un repertoire, nomme d'apres le nom de
la liste, sous le repertoire ~/.enemies-of-carlotta. Ce repertoire
contient plusieurs fichiers et repertoires decrits ci-dessous. En
general, il n'est pas necessaire de toucher a ces repertoires.
Cependant, certaines configurations esoteriques peuvent uniquement etre
faites en editant le fichier de configuration de la liste.
config Fichier de configuration de la liste. Le contenu est decrit
ci-dessous.
subscribers
Base de donnees des abonnes. Chaque ligne contient un groupe
d'abonnes, dont les cinq premiers espaces delimitent les champs
qui sont l'identifiant du groupe, l'etat, la date de creation du
groupe, la date du message de retour qui a fait passer l'etat de
la liste de << ok >> a << bounced >>, et l'identifiant du
message de retour.
archive-box
Messages archives.
bounce-box
Groupes des messages de retour qui ne sont pas dans l'etat
<< ok >>.
headers-to-add
En-tetes a ajouter aux courriels envoyes a la liste. Ceux-ci
sont copies aux debuts des en-tetes existants exactement tels
qu'ils sont dans ce fichier, apres que les en-tetes de la liste
(comme << List-ID >>) ont ete ajoutes et que ceux mentionnes
dans headers-to-remove ont ete retires.
headers-to-remove
En-tetes a retirer des messages envoyes a la liste.
moderation-box
Messages en attente d'approbation du moderateur.
subscription-box
Requetes d'abonnement et de desabonnement en attente de
confirmation de la part de l'utilisateur.
templates
Repertoires qui contiennent les modeles specifiques a une liste
(optionnel). Les modeles seront recherches d'abord dans ce
repertoire, s'il existe, puis dans les repertoires du systeme.
Un fichier vide signifie que le message correspondant ne doit
pas etre envoye. Cela peut etre utilise par exemple pour activer
uniquement pour certaines listes les messages du type
<< veuillez attendre la moderation de votre message >>.
plugins
Repertoires contenant des grephons, a savoir des fichiers source
en Python qui sont charges automatiquement par EoC au demarrage.
Ces grephons peuvent modifier le comportement d'EoC.
Le fichier config possede un format de type mot-cl'e=valeur :
[list]
owners = liw@liw.iki.fi
archived = no
posting = free
subscription = free
mail-on-subscription-changes = yes
mail-on-forced-unsubscribe = yes
language = fr
Les mots cles archived, posting, et subscription correspondent aux
options qui portent les memes noms. Les autres mots-cles sont :
owners Liste des adresses des proprietaires, definie avec l'option
--owner.
moderators
Liste des adresses des moderateurs, definie avec l'option
--moderator.
mail-on-subscription-changes
Valeur definissant si les proprietaires doivent etre avertis
lorsqu'un utilisateur s'abonne ou se desabonne.
mail-on-forced-unsubscribe
Valeur definissant si les proprietaires doivent etre avertis si
quelqu'un est retire d'une liste suite a une adresse trop
souvent invalide.
ignore_bounce
Valeur definissant si les messages de retour sont ignores sur la
liste. Utilise par exemple lorsque la liste devrait avoir un
nombre stable d'abonnes.
language
Suffixe pour les modeles, pour permettre la gestion de plusieurs
langues. (Si language est defini a << fr >>, alors le modele
<< foo >> est d'abord recherche en tant que modele
<< foo.fr >>.)
pristine-headers
Valeur definissant si les en-tetes doivent etre encodes au
format MIME. Si la valeur vaut << yes >>, l'encodage aura lieu.
EXEMPLES
Creer une liste nommee moviefans@example.com, dont le proprietaire est
ding@example.com (tout sur la meme ligne) :
enemies-of-carlotta --name=moviefans@example.com
--owner=ding@example.com --create
Le systeme de messagerie doit etre configure pour que ces messages
arrivent sur la liste (et a ses adresses de commande). Pour Qmail et
Postfix, voir ci-dessous.
Afficher la liste de tous les abonnes a cette liste :
enemies-of-carlotta --name=moviefans@example.com --list
Les personnes voulant s'abonner a la liste doivent envoyer un courriel
a
moviefans-subscribe@example.com
QMAIL
Avec Qmail, pour faire en sorte que les courriels entrants soient
traites par Enemies of Carlotta, quelques fichiers .qmail-extension
sont necessaires pour chaque liste. Par exemple, si joe est un nom
d'utilisateur, pour initialiser la liste de diffusion joe-fans, deux
fichiers doivent etre crees : .qmail-fans et .qmail-fans-default, qui
contiendront
|enemies-of-carlotta --incoming
Si les messages a destination d'un domaine virtuel, example.com,
delivres via /var/qmail/control/virtualdomains a joe-exampledotcom, les
fichiers seront nommes .qmail-exampledotcom-fans et
.qmail-exampledotcom-fans-default et contiendront
|enemies-of-carlotta --incoming --skip-prefix=joe-exampledotcom-
(tout sur la meme ligne).
POSTFIX
Avec Postfix, un fichier .forward contenant
"|procmail -p"
sera necessaire, ainsi qu'un fichier .procmailrc contenant
:0
* ? enemies-of-carlotta --name=$RECIPIENT --is-list
| enemies-of-carlotta --incoming
Pour utiliser Enemies of Carlotta avec un domaine virtuel Postfix, une
carte virtuelle d'expressions rationnelles generalement appelee
/etc/postfix/virtual_regexp devra etre creee (pour l'activer, ajouter
virtual_maps = regexp:/etc/postfix/virtual_regexp dans le fichier
/etc/postfix/main.cf). Le fichier d'expressions rationnelles doit
faire des choses horribles pour conserver l'adresse de destination. Il
faut donc ajouter :
/^your.virtual.domain$/ dummy
/^(yourlist|yourlist-.*)@(your.virtual.domain)$/ joe+virtual-$1
Soit deux lignes. Si recipient_delimiter pour Postfix est configure
avec un moins au lieu d'un plus, utiliser joe-virtual. Ensuite dans le
fichier .procmailrc, ajouter les options --skip-prefix=joe-virtual- et
--domain=your.virtual.domain pour les deux appels a
enemies-of-carlotta.
Ces manipulations restent complexes.
COMMANDES PAR MESSAGE
Les utilisateurs et proprietaires utilisent Enemies of Carlotta par
courriel en utilisant des adresses de commande comme
foo-subscribe@example.com. Voici une liste de toutes les adresses de
commande accessibles aux utilisateurs et proprietaires. Dans tous ces
exemples, le nom de la liste de diffusion sera foo@example.com.
Commandes par message accessibles `a tout le monde
Ces commandes peuvent servir a tout le monde et ne demandent aucun
privilege special.
foo@example.com
Envoie un courriel a tous les abonnes. Le message peut avoir a
etre approuve d'abord par les moderateurs de la liste, qui ont
aussi le pouvoir de le rejeter.
foo-owner@example.com
Envoie un courriel au(x) proprietaire(s) de la liste.
foo-help@example.com
Retourne en reponse a ce courriel un message contenant l'aide de
la liste.
foo-subscribe@example.com
Inscrit l'auteur du courriel a la liste. Le gestionnaire de
listes repondra en demandant une confirmation. L'inscription
n'aura lieu qu'en cas de reponse a cette demande. De cette
maniere, les personnes malveillantes ne peuvent ajouter votre
adresse sur une ou beaucoup de listes de diffusion.
foo-subscribe-joe=example.com@example.com
Inscrit joe@example.com a la liste. Pour inscrire une adresse
differente de celle utilisee pour la demande d'abonnement,
utiliser cette forme. La demande de confirmation sera envoyee a
joe@example.com puisque cette adresse seulement sera abonnee a
la liste.
foo-unsubscribe@example.com
Desinscrit l'auteur du courriel de la liste. Encore une fois,
une demande de confirmation sera envoyee pour eviter que des
personnes malveillantes desinscrivent d'autres personnes.
foo-unsubscribe-joe=example.com@example.com
Desinscrit joe@example.com de la liste. Encore une fois, cette
derniere adresse recevra la demande de confirmation.
Commandes par message pour les propri'etaires de la liste.
Les commandes suivantes peuvent etre utilisees pour administrer la
liste.
foo-subscribe-joe=example.com@example.com
Si un proprietaire envoie un courriel de ce type, il recevra la
demande de confirmation a la place de joe@example.com. Il est
souvent preferable de laisser les gens s'inscrire eux-memes,
mais parfois cela peut etre utile que le proprietaire s'en
occupe.
foo-unsubscribe-joe=example.com@example.com
Les proprietaires peuvent egalement desinscrire d'autres
personnes.
foo-list@example.com
Retourne la liste des abonnes a la liste. Cela ne marche que si
l'adresse de l'expediteur est celle de l'un des proprietaires.
L'adresse de l'expediteur est celle utilisee au niveau SMTP et
non celle dans l'en-tete From:.
foo-setlist@example.com
Permet a un proprietaire de configurer la liste des abonnes en
un seul coup. Cela correspond a une suite de commandes
-subscribe et -unsubscribe, mais en plus simple. Tous ceux qui
seront ajoutes a la liste recevront un message de bienvenue,
alors que ceux qui seront retires recevront un message d'adieu.
foo-setlistsilently@example.com
Commande similaire a -setlist, sans les envois des messages de
bienvenue et d'adieu.
GREPHONS
Enemies of Carlotta accepte des grephons. Des connaissances en Python
sont necessaires pour comprendre cette section.
Un grephon est un module Python (un fichier avec un suffixe .py), place
dans le repertoire ~/.enemies-of-carlotta/plugins. Les grephons sont
charges automatiquement au demarrage, si la version declaree de
l'interface correspond a celle utilisee par Enemies of Carlotta. La
version de l'interface est declaree par la variable globale
PLUGIN_INTERFACE_VERSION du module.
Les grephons peuvent definir des fonctions d'ancrage appelees au bon
endroit dans le code d'EoC. Pour le moment, la seule fonction d'ancrage
est send_mail_to_subscribers_hook, qui peut modifier un courriel avant
qu'il ne soit envoye aux abonnes. La fonction devrait ressembler a :
def send_mail_to_subscribers_hook(list, text):
L'argument list est une reference a l'objet MailingList qui correspond
a la liste concernee, et text est le texte complet du courriel tel
qu'il existe actuellement. La fonction devrait retourner le nouveau
contenu de ce courriel.
FICHIERS
~/.enemies-of-carlotta
Ensemble des fichiers en rapport avec les listes de diffusion.
~/.enemies-of-carlotta/secret
Mots de passe secrets utilises pour generer des adresses signees
pour le controle des messages de retour et la validation des
abonnements.
~/.enemies-of-carlotta/foo@example.com
Repertoire contenant les donnees appartenant a la liste de
diffusion foo@example.com. A l'exception du fichier de config
qui se trouve dans ce repertoire, rien ne devrait etre a
modifier.
~/.enemies-of-carlotta/foo@example.com/config
Fichier de configuration pour la liste de diffusion. Ce fichier
devra etre edite pour modifier les options de moderation ou les
proprietaires de la liste.
VOIR AUSSI
Page web d'<< Enemies of Carlotta >> : http://www.iki.fi/liw/eoc/.
TRADUCTION
Pierre Machard <pmachard@tuxfamily.org>, 2003
Thomas Huriaux <thomas.huriaux@gmail.com>, 2005
ENEMIES-OF-CARLOTTA(1)