Linux Certif

Toute la documentation sur la certification Linux LPI

enemies-of-carlotta

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 donnיes des listes dans le rיpertoire ~/.enemies-of-carlotta. Celui-ci sera crיי automatiquement lors de la crיation de la premiטre liste. Le traitement des courriels par le gestionnaire de listes doit ךtre configurי manuellement. Les dיtails peuvent varier d'un systטme א l'autre. Pour QMail et Postfix, voir ci-dessous.

Chaque liste possטde un ou plusieurs propriיtaires, qui modטrent יgalement les inscriptions ou certains messages, voire tous. Sur les listes non modיrיes, les propriיtaires de la liste sont chargיs de rיpondre aux questions concernant la liste. Sur les listes totalement modיrיes, ils doivent approuver chaque message avant qu'il ne soit envoyי sur la liste. Sur les liste oש posting=auto, les messages des abonnיs sont automatiquement envoyיs א la liste, et les modיrateurs n'ont besoin d'approuver que les messages qui ne proviennent pas des abonnיs.

OPTIONS

--name=foo@example.com

prיciser la liste sur laquelle la commande doit ךtre effectuיe. La plupart des options doivent ךtre accompagnיes du nom de la liste concernיe. Avec les options --edit, --subscribe, --unsubscribe et --list, le nom peut ךtre abrיgי en enlevant le signe @ et le domaine.

--create

crיer une nouvelle liste de diffusion. Au moins un propriיtaire doit ךtre prיcisי א l'aide de --owner.

--owner=adresse

ajouter un propriיtaire א la liste lors de sa crיation

--moderator=adresse

ajouter un modיrateur א la liste lors de sa crיation ou de son יdition

--language=code-de-la-langue

configurer le code de la langue utilisי pour rיcupיrer les fichiers modטles. Le code peut ךtre vide (l'anglais sera utilisי par dיfaut) ou composי de deux lettres comme fr ou es.

--cleaning-woman

gיrer les adresses invalides et nettoyer quelques autres יlיments. La commande enemies-of-carlotta --cleaning-woman doit ךtre lancיe pיriodiquement, comme une fois par heure, pour nettoyer l'ensemble des listes de diffusion.

--destroy

dיtruire une liste

--edit

modifier la configuration d'une liste

--subscription=type

dיfinir le mode d'abonnement א free (libre) ou moderated (modיrי) lors de la crיation de la liste. ְ utiliser en combinaison avec --edit ou --create.

--posting=type

dיfinir le mode d'envoi א free (libre), auto (automatique) ou moderated (modיrי). ְ utiliser en combinaison avec --edit ou --create.

--archived=yes-ou-no

dיfinir si les messages de la liste doivent ךtre archivיs dans le sous-rיpertoire archive-box du rיpertoire de la liste, lui-mךme prיsent dans le rיpertoire ~/.enemies-of-carlotta. Utiliser yes (oui) ou no (non).

--mail-on-subscription-changes=yes-ou-no

dיfinir si les propriיtaires de la liste doivent ךtre avertis lors d'un abonnement ou d'un dיsabonnement. Utiliser yes (oui) ou no (non). La valeur par dיfaut est no.

--mail-on-forced-unsubscription=yes-ou-no

dיfinir si les propriיtaires de la liste doivent ךtre avertis lorsque quelqu'un est retirי de la liste en raison d'une adresse trop souvent invalide. Utiliser yes (oui) ou no (non). La valeur par dיfaut est no.

--ignore-bounce=yes-ou-no

dיfinir si les renvois pour adresse invalide doivent ךtre ignorיs. Utiliser yes (oui) ou no (non). La valeur par dיfaut est no.

--list

lister l'ensemble des abonnיs א une liste.

--subscribe

ajouter des abonnיs א la liste. Les arguments qui ne sont pas des options sont les adresses א abonner. Les adresses ajoutיes de cette faחon ne recevront pas de demande de confirmation.

--unsubscribe

enlever des abonnיs de la liste. Les arguments qui ne sont pas des options sont les adresses א dיsabonner. Les adresses enlevיes de cette maniטre ne recevront pas de demande de confirmation.

--incoming

traiter un message entrant sur l'entrיe standard. L'adresse de l'expיditeur de l'enveloppe SMTP doit ךtre prיcisיe par la variable d'environnement SENDER et l'adresse du destinataire de l'enveloppe SMTP doit ךtre prיcisיe par la variable d'environnement RECIPIENT. (QMail et Postfix traitent cela automatiquement.)

--skip-prefix=chaמne

retirer chaמne du dיbut de l'adresse de destination avant de l'analyser pour dיterminer א quelle liste le message est destinי. 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 dיterminer א quelle liste le message est destinי. Ceci permet le traitement des domaines virtuels avec QMail et Postfix.

--is-list

dיterminer si l'adresse indiquיe par --name fait rיfיrence א une liste valide. Le code de sortie zיro (succטs) est retournי si c'est le cas, un (יchec) 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פte

envoyer les courriels en utilisant le serveur SMTP sur hפte (port 25). Le serveur doit ךtre configurי pour permettre א la machine sur laquelle fonctionne la liste de l'utiliser comme relais. Par dיfaut, l'interface en ligne de commande est utilisיe. L'envoi par SMTP n'est utilisי qu'avec cette option.

--qmqp-server=hפte

envoyer les courriels en utilisant le serveur QMQP sur hפte (port 628). Le serveur doit ךtre configurי pour permettre א la machine sur laquelle fonctionne la liste de l'utiliser comme relais. Par dיfaut, l'interface en ligne de commande est utilisיe. L'envoi par QMQP n'est utilisי qu'avec cette option.

--moderate

forcer un message entrant א ךtre modיrי, mךme s'il est envoyי א une liste oש l'envoi est libre. Cela peut ךtre utilisי pour filtrer les courriers indיsirables : les messages entrants peuvent ךtre filtrיs par n'importe quel systטme de filtrage des courriels ; dטs lors qu'un message semble ךtre indיsirable, une modיration par un humain peut ךtre demandיe.

--post

forcer un message entrant א ךtre envoyי, mךme s'il est envoyי א une liste oש l'envoi est modיrי. Cela peut ךtre utilisי lorsqu'une vיrification externe a lieu pour dיfinir si le courriel est acceptable sur la liste, par exemple en vיrifiant les signatures יlectroniques.

--quiet

ne pas envoyer les messages de dיbogage des journaux sur la sortie d'erreur standard, contrairement au comportement par dיfaut.

--sender=foo@example.com

--recipient=foo@example.com

יcraser les variables d'environnement SENDER et RECIPIENT respectivement, א utiliser en combinaison avec --incoming et --is-list.

--get

obtenir les valeurs d'une ou plusieurs variables de configuration. Le nom des variables est indiquי sur la ligne de commande aprטs les options. Chaque valeur est affichיe sur une ligne sיparיe.

--set

configurer les valeurs d'une ou plusieurs variables de configuration. Les noms et valeurs sont donnיs sur la ligne de commande aprטs les options et sיparיs par un signe d'יgalitי (« = »). Par exemple, la commande suivante configurerait une liste en franחais : 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 reprיsentיe par un rיpertoire, nommי d'aprטs le nom de la liste, sous le rיpertoire ~/.enemies-of-carlotta. Ce rיpertoire contient plusieurs fichiers et rיpertoires dיcrits ci-dessous. En gיnיral, il n'est pas nיcessaire de toucher א ces rיpertoires. Cependant, certaines configurations יsotיriques peuvent uniquement ךtre faites en יditant le fichier de configuration de la liste.

config

Fichier de configuration de la liste. Le contenu est dיcrit ci-dessous.

subscribers

Base de donnיes des abonnיs. Chaque ligne contient un groupe d'abonnיs, dont les cinq premiers espaces dיlimitent les champs qui sont l'identifiant du groupe, l'יtat, la date de crיation du groupe, la date du message de retour qui a fait passer l'יtat de la liste de « ok » א « bounced », et l'identifiant du message de retour.

archive-box

Messages archivיs.

bounce-box

Groupes des messages de retour qui ne sont pas dans l'יtat « ok ».

headers-to-add

En-tךtes א ajouter aux courriels envoyיs א la liste. Ceux-ci sont copiיs aux dיbuts des en-tךtes existants exactement tels qu'ils sont dans ce fichier, aprטs que les en-tךtes de la liste (comme « List-ID ») ont יtי ajoutיs et que ceux mentionnיs dans headers-to-remove ont יtי retirיs.

headers-to-remove

En-tךtes א retirer des messages envoyיs א la liste.

moderation-box

Messages en attente d'approbation du modיrateur.

subscription-box

Requךtes d'abonnement et de dיsabonnement en attente de confirmation de la part de l'utilisateur.

templates

Rיpertoires qui contiennent les modטles spיcifiques א une liste (optionnel). Les modטles seront recherchיs d'abord dans ce rיpertoire, s'il existe, puis dans les rיpertoires du systטme. Un fichier vide signifie que le message correspondant ne doit pas ךtre envoyי. Cela peut ךtre utilisי par exemple pour activer uniquement pour certaines listes les messages du type « veuillez attendre la modיration de votre message ».

plugins

Rיpertoires contenant des grephons, א savoir des fichiers source en Python qui sont chargיs automatiquement par EoC au dיmarrage. Ces grephons peuvent modifier le comportement d'EoC.

Le fichier config possטde un format de type mot-clי=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 clיs archived, posting, et subscription correspondent aux options qui portent les mךmes noms. Les autres mots-clיs sont :

owners

Liste des adresses des propriיtaires, dיfinie avec l'option --owner.

moderators

Liste des adresses des modיrateurs, dיfinie avec l'option --moderator.

mail-on-subscription-changes

Valeur dיfinissant si les propriיtaires doivent ךtre avertis lorsqu'un utilisateur s'abonne ou se dיsabonne.

mail-on-forced-unsubscribe

Valeur dיfinissant si les propriיtaires doivent ךtre avertis si quelqu'un est retirי d'une liste suite א une adresse trop souvent invalide.

ignore_bounce

Valeur dיfinissant si les messages de retour sont ignorיs sur la liste. Utilisי par exemple lorsque la liste devrait avoir un nombre stable d'abonnיs.

language

Suffixe pour les modטles, pour permettre la gestion de plusieurs langues. (Si language est dיfini א « fr », alors le modטle « foo » est d'abord recherchי en tant que modטle « foo.fr ».)

pristine-headers

Valeur dיfinissant si les en-tךtes doivent ךtre encodיs au format MIME. Si la valeur vaut « yes », l'encodage aura lieu.

EXEMPLES

Crיer une liste nommיe moviefans@example.com, dont le propriיtaire est ding@example.com (tout sur la mךme ligne) :

enemies-of-carlotta --name=moviefans@example.com --owner=ding@example.com --create

Le systטme de messagerie doit ךtre configurי pour que ces messages arrivent sur la liste (et א ses adresses de commande). Pour Qmail et Postfix, voir ci-dessous.

Afficher la liste de tous les abonnיs א cette liste :

enemies-of-carlotta --name=moviefans@example.com --list

Les personnes voulant s'abonner א la liste doivent envoyer un courriel א

moviefans-subscribe@example.com

QMAIL

Avec Qmail, pour faire en sorte que les courriels entrants soient traitיs par Enemies of Carlotta, quelques fichiers .qmail-extension sont nיcessaires pour chaque liste. Par exemple, si joe est un nom d'utilisateur, pour initialiser la liste de diffusion joe-fans, deux fichiers doivent ךtre crייs : .qmail-fans et .qmail-fans-default, qui contiendront

|enemies-of-carlotta --incoming

Si les messages א destination d'un domaine virtuel, example.com, dיlivrיs via /var/qmail/control/virtualdomains א joe-exampledotcom, les fichiers seront nommיs .qmail-exampledotcom-fans et .qmail-exampledotcom-fans-default et contiendront

|enemies-of-carlotta --incoming --skip-prefix=joe-exampledotcom-

(tout sur la mךme ligne).

POSTFIX

Avec Postfix, un fichier .forward contenant

"|procmail -p"

sera nיcessaire, 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 gיnיralement appelיe /etc/postfix/virtual_regexp devra ךtre crייe (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 configurי 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 א enemies-of-carlotta.

Ces manipulations restent complexes.

COMMANDES PAR MESSAGE

Les utilisateurs et propriיtaires 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 propriיtaires. Dans tous ces exemples, le nom de la liste de diffusion sera foo@example.com.

Commandes par message accessibles א tout le monde

Ces commandes peuvent servir א tout le monde et ne demandent aucun privilטge spיcial.

foo@example.com

Envoie un courriel א tous les abonnיs. Le message peut avoir א ךtre approuvי d'abord par les modיrateurs de la liste, qui ont aussi le pouvoir de le rejeter.

foo-owner@example.com

Envoie un courriel au(x) propriיtaire(s) de la liste.

foo-help@example.com

Retourne en rיponse א ce courriel un message contenant l'aide de la liste.

foo-subscribe@example.com

Inscrit l'auteur du courriel א la liste. Le gestionnaire de listes rיpondra en demandant une confirmation. L'inscription n'aura lieu qu'en cas de rיponse א cette demande. De cette maniטre, 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 א la liste. Pour inscrire une adresse diffיrente de celle utilisיe pour la demande d'abonnement, utiliser cette forme. La demande de confirmation sera envoyיe א joe@example.com puisque cette adresse seulement sera abonnיe א la liste.

foo-unsubscribe@example.com

Dיsinscrit l'auteur du courriel de la liste. Encore une fois, une demande de confirmation sera envoyיe pour יviter que des personnes malveillantes dיsinscrivent d'autres personnes.

foo-unsubscribe-joe=example.com@example.com

Dיsinscrit joe@example.com de la liste. Encore une fois, cette derniטre adresse recevra la demande de confirmation.

Commandes par message pour les propriיtaires de la liste.

Les commandes suivantes peuvent ךtre utilisיes pour administrer la liste.

foo-subscribe-joe=example.com@example.com

Si un propriיtaire envoie un courriel de ce type, il recevra la demande de confirmation א la place de joe@example.com. Il est souvent prיfיrable de laisser les gens s'inscrire eux-mךmes, mais parfois cela peut ךtre utile que le propriיtaire s'en occupe.

foo-unsubscribe-joe=example.com@example.com

Les propriיtaires peuvent יgalement dיsinscrire d'autres personnes.

foo-list@example.com

Retourne la liste des abonnיs א la liste. Cela ne marche que si l'adresse de l'expיditeur est celle de l'un des propriיtaires. L'adresse de l'expיditeur est celle utilisיe au niveau SMTP et non celle dans l'en-tךte From:.

foo-setlist@example.com

Permet א un propriיtaire de configurer la liste des abonnיs en un seul coup. Cela correspond א une suite de commandes -subscribe et -unsubscribe, mais en plus simple. Tous ceux qui seront ajoutיs א la liste recevront un message de bienvenue, alors que ceux qui seront retirיs recevront un message d'adieu.

foo-setlistsilently@example.com

Commande similaire א -setlist, sans les envois des messages de bienvenue et d'adieu.

GREPHONS

Enemies of Carlotta accepte des grephons. Des connaissances en Python sont nיcessaires pour comprendre cette section.

Un grephon est un module Python (un fichier avec un suffixe .py), placי dans le rיpertoire ~/.enemies-of-carlotta/plugins. Les grephons sont chargיs automatiquement au dיmarrage, si la version dיclarיe de l'interface correspond א celle utilisיe par Enemies of Carlotta. La version de l'interface est dיclarיe par la variable globale PLUGIN_INTERFACE_VERSION du module.

Les grephons peuvent dיfinir des fonctions d'ancrage appelיes 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 envoyי aux abonnיs. La fonction devrait ressembler א :

      def send_mail_to_subscribers_hook(list, text):

L'argument list est une rיfיrence א l'objet MailingList qui correspond א la liste concernיe, 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 utilisיs pour gיnיrer des adresses signיes pour le contrפle des messages de retour et la validation des abonnements.

~/.enemies-of-carlotta/foo@example.com

Rיpertoire contenant les donnיes appartenant א la liste de diffusion foo@example.com. ְ l'exception du fichier de config qui se trouve dans ce rיpertoire, rien ne devrait ךtre א modifier.

~/.enemies-of-carlotta/foo@example.com/config

Fichier de configuration pour la liste de diffusion. Ce fichier devra ךtre יditי pour modifier les options de modיration ou les propriיtaires 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