Nom

enemies-of-carlotta - un gestionnaire de listes de diffusion simple

Résumé

enemies-of-carlotta [ options ] [ adresses ]

Description

enemies-of-carlotta est un gestionnaire de listes de diffusion simple. Si vous ne savez pas ce qu'est un gestionnaire de listes de diffusion, vous devez commencez par apprendre de quoi il s'agit avant de vouloir vous en servir.

Enemies of Carlotta conserve toutes les données des listes dans le répertoire ~/.enemies-of-carlotta. Il sera créé automatiquement lorsque vous créerez votre première liste. Vous devez vous arranger manuellement pour que les courriels soient traités par le gestionnaire de liste de diffusion. Les détails peuvent varier d'un système à l'autre. Pour QMail et Postfix, regardez ci-dessous.

Chaque liste possède un ou plusieurs propriétaires, qui modèrent également les inscriptions, ou bien 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 au sujet de la liste. Sur les liste 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 pas besoin d'approuver que les messages qui ne proviennent pas des abonnés.

Options

--name= foo@example.com

Précise la liste sur laquelle la commande doit être effectuée. La plupart des options restantes nécessitent que vous précisiez le nom de la liste avec cette option. 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 Vous devez précisez au moins un propriétaire à l'aide de --owner .

--owner= adresse

Indique la liste des propriétaires lorsque la liste est créée.

--cleaning-woman

Règle les problèmes des messages qui n'ont pas pu être délivrés et nettoie également quelques autres éléments. Vous devez lancer enemies-of-carlotta --cleaning-woman périodiquement. Cela nettoiera l'ensemble de vos listes de diffusion.

--destroy

Détruit la liste.

--edit

Modifie la configuration de la liste.

--subscription= type

Lors de la création d'une liste, définit le mode d'abonnement à free (libre) ou moderated (modéré). Utilisez-le avec --edit , ou --create .

--posting= type

Lors de la création d'une liste, définit le mode d'envoi à free , (libre) auto , (automatique) ou moderated (modéré). Utilisez-le avec --edit , ou --create .

--archived= yes-ou-no

Les messages à destination de la liste doivent-ils être archivés sous la forme d'une archive-box ou d'un répertoire dans le répertoire dans liste ~/.enemies-of-carlotta . Utilisez yes (oui) ou no (non).

--list

Liste l'ensemble des abonnés à une liste de diffusion.

--subscribe

Ajoute des abonnés à la liste. Les arguments qui ne sont pas des options sont les adresses qui doivent être abonnées. Notez que les adresses ajoutées de cette manière ne recevront pas de demande de confirmation d'abonnement.

--unsubscribe

Enlève un abonné de la liste. Les arguments qui ne sont pas des options sont les adresses qui doivent être désabonnées. Notez que les adresses enlevées de cette manière ne recevront pas de demande de confirmation de désabonnement.

--incoming

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

--skip-prefix= chaîne

Avant d'analyser l'adresse de destination pour regarder à quelle liste le message est destiné, ce paramètre permet d'enlever chaîne depuis son début. C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix, voyez ci-dessous.

--domain= nom.domaine

Avant d'analyser l'adresse de destination pour voir à quelle liste le message est destiné, remplace le nom de domaine par nom.domaine . C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix.

--is-list

L'adresse précisée par --name fait-elle référence à un nom de liste valide ? Cela retourne le code d'erreur zéro (succès) si c'est le cas, ou un (échec) dans le cas contraire.

--sendmail= chemin

Utilise chemin au lieu de /usr/sbin/sendmail Pour envoyer des courriels via une interface en ligne de commande. Notez que la commande doit respecter l'interface de la ligne de commande sendmail.

--smtp-server= hôte

Envoi les courriels en utilisant le serveur hôte (port 25). Le serveur doit être configuré pour permettre à la machine sur laquelle fonctionne la liste de l'utiliser pour relais. Notez que par défaut, c'est l'interface en ligne de commande qui est utilisée. L'envoi au moyen de SMTP n'est utilisé que si vous utilisez cette option.

--moderate

Force 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 le spam : Vos messages entrants peuvent être filtrés par n'importe quel système de filtrage des courriels, dès lors qu'un message semble être du spam, vous pouvez demander qu'il soit modéré par une personne humaine.

--quiet

Par défaut, les messages de débogage des journaux sont envoyés sur l'erreur standard. Avec cette option, il ne le sont plus.

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, qui sont 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

Le fichier de configuration de la liste. Le contenu est décrit ci-dessous.

subscribers

La base de données des abonnés. Chaque ligne contient un groupe d'abonné, dont les cinq premiers espaces délimitent les champs qui sont les identifiants des groupes, le statut, le timestamp de la date de création du groupe, le timestamp pour les retours de courriel en cas d'échec, il peut varier de « ok » à « bonced », et l'identifiant du message de retour en cas d'échec.

archive-box

Les messages archivés.

bounce-box

Groupes de messages qui n'ont pu être délivrés et qui sont dans le statut « ok ».

moderation-box

Messages en attente d'approbation du modérateur.

subscription-box

Requêtes d'abonnement de désabonnement en attente de confirmation de la part de l'utilisateur.

le fichier config possède des mot-clé = value format :

[table][row]    [col] .nf [list] owners = liw@liw.iki.fi archived = no posting = free subscription = free mail-on-subscription-changes = yes mail-on-forced-unsubscribe = yes language = fi .fi[/col][/row][/table]

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 les adresses des propriétaires. Définissez-la à l'aide de l'option --owner.

mail-on-subscription-changes

Les propriétaires doivent-ils recevoir un avertissement lorsqu'un utilisateur s'abonne ou se désabonne ?

mail-on-forced-unsubscribe

Les propriétaires doivent-ils recevoir un avertissement lorsqu'une personne est enlevée de la liste car trop de courriels ne lui sont pas parvenus ?

language

Suffixe pour les templates, pour permettre le support de plusieurs langues (Si language est défini à « fr », alors la template nommée « foo » est d'abord recherchée comme « foo.fr ».)

Exemples

Pour créer une liste nommée moviefans@example.com , dont le propriétaire est ding@example.com , utilisez la commande suivante (tout sur la même ligne) : 1

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

Pour voir la liste de tous les abonnés à cette liste : 1

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

Les personnes qui souhaitent être abonnées à la liste doivent envoyer un courriel à 1

moviefans-subscribe@example.com

Qmail

Dans Qmail, pour faire en sorte que le courrier entrant soit traité par Enemies of Carlotta, vous avez besoin de créer quelques fichiers .qmail-extension par liste. Par exemple, si votre nom d'utilisateur est joe et que vous souhaitez utiliser la liste de diffusion joe-fans, vous devrez créer les fichiers .qmail-fans et .qmail-fans-default , qui contiennent 1

|"enemies-of-carlotta --incoming"

Si vous utilisez un domaine virtuel, example.com, et que les courriels sont délivrés via /var/qmail/control/virtualdomains à joe-exampledotcom, les fichiers seront nommés .qmail-exampledotcom-fans et .qmail-exampledotcom-fans-default et ils contiendront 1

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

1 (l'ensemble sur la même ligne, il va de soi).

Postfix

Avec Postfix, vous devrez configurer un fichier .forward contenant 1

"|procmail -p"

1 et un fichier .procmailrc contenant 1

:0 * ? enemies-of-carlotta --name=$RECIPIENT --is-list | enemies-of-carlotta --incoming

Pour utiliser Enemies of Carlotta avec un domaine virtuel Postfix, vous devrez mettre en place une « carte virtuelle d'expressions rationnelles », généralement /etc/postfix/virtual_regexp (ajoutez virtual_maps = regexp:/etc/postfix/virtual_regexp dans votre fichier /etc/postfix/main.cf pour l'activer). Le fichier d'expressions rationnelles a besoin de faire des choses horribles pour conserver l'adresse de destination. Ajoutez ce qui suit dans le fichier d'expressions rationnelles : 1

/^your.virtual.domain$/ dummy /^(yourlist|yourlist-.*)@(your.virtual.domain)$/ joe-virtual-$1

1 (Ça fait deux lignes.) Ensuite dans votre fichier, .procmailrc, ajoutez les options --skip-prefix=joe-virtual- et --domain=your.virtual.domain pour les deux appels à enemies-of-carlotta .

(Oui, je aussi trouve que ces choses là sont trop compliquées)

Fichiers

~/.enemies-of-carlotta

L'ensemble des fichiers en rapports avec vos listes de diffusion.

~/.enemies-of-carlotta/secret

Les mots de passe secrets utilisés pour générer des adresses signées pour le contrôle des couriels d'échec et la validation de l'abonnement.

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

Le répertoire contient les données appartenant à la liste de diffusion foo@example.com. À l'exception du fichier de config qui se trouve dans ce répertoire, vous ne devriez pas éditer autre chose à la main

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

Fichier de configuration pour la liste de diffusion. Vous aurez peut-être besoin de l'éditer à la main si vous souhaitez apporter des changement en ce qui concerne la modération ou bien les propriétaires de la liste.

Voir aussi

Vous serez peut-être intéressé de visiter la page d'accueil d' « Enemies of Carlotta » à l'adresse http://www.iki.fi/liw/eoc/ .

Traduction

Pierre Machard <pmachard@tuxfamily.org>, 2003