enemies-of-carlotta.1.fr

   1 .\" Relecture Gérard Delafond
   2 .TH ENEMIES-OF-CARLOTTA 1
   3 .SH NOM
   4 enemies-of-carlotta \- un gestionnaire de listes de diffusion simple
   5 .SH SYNOPSIS
   6 .B enemies-of-carlotta
   7 .IR "" [ options "] [" adresses ]
   8 .SH "DESCRIPTION"
   9 .B enemies-of-carlotta
  10 est un gestionnaire de listes de diffusion simple.
  11 Si vous ne savez pas ce qu'est un gestionnaire de listes de diffusion, vous
  12 devez commencez par apprendre de quoi il s'agit avant de vouloir vous en
  13 servir.
  14 .PP
  15 Enemies of Carlotta conserve toutes les données des listes dans le répertoire
  16 .I ~/.enemies-of-carlotta.
  17 Il sera créé automatiquement lorsque vous créerez votre première liste.
  18 Vous devez vous arranger manuellement pour que les courriels soient traités
  19 par le gestionnaire de liste de diffusion.
  20 Les détails peuvent varier d'un système à l'autre.
  21 Pour QMail et Postfix, regardez ci-dessous.
  22 .PP
  23 Chaque liste possède un ou plusieurs propriétaires, qui modèrent également
  24 les inscriptions, ou bien certains messages, voire tous.
  25 Sur les listes non modérées, les propriétaires de la liste sont chargés de
  26 répondre aux questions au sujet de la liste.
  27 Sur les liste totalement modérées, ils doivent approuver chaque message
  28 avant qu'il ne soit envoyé sur la liste.
  29 Sur les liste où
  30 .IR posting=auto ,
  31 les messages des abonnés sont automatiquement envoyés à la liste, et les
  32 modérateurs n'ont pas besoin d'approuver que les messages qui ne
  33 proviennent pas des abonnés.
  34 .SH OPTIONS
  35 .\" ---------------------------------------------------------------
  36 .TP
  37 .BR --name= foo@example.com
  38 Précise la liste sur laquelle la commande doit être effectuée.
  39 La plupart des options restantes nécessitent que vous précisiez
  40 le nom de la liste avec cette option.
  41 Avec les options --edit, --subscribe, --unsubscribe, et --list,
  42 le nom peut être abrégé en enlevant le signe @ et le domaine.
  43 .\" ---------------------------------------------------------------
  44 .TP
  45 .BI --create
  46 Créer une nouvelle liste de diffusion
  47 Vous devez précisez au moins un propriétaire à l'aide de
  48 .BR --owner .
  49 .\" ---------------------------------------------------------------
  50 .TP
  51 .BI --owner= adresse
  52 Indique la liste des propriétaires lorsque la liste est créée.
  53 .\" ---------------------------------------------------------------
  54 .TP
  55 .B --cleaning-woman
  56 Règle les problèmes des messages qui n'ont pas pu être délivrés et
  57 nettoie également quelques autres éléments.
  58 Vous devez lancer
  59 .B "enemies-of-carlotta --cleaning-woman"
  60 périodiquement.
  61 Cela nettoiera l'ensemble de vos listes de diffusion.
  62 .\" ---------------------------------------------------------------
  63 .TP
  64 .BI --destroy
  65 Détruit la liste.
  66 .\" ---------------------------------------------------------------
  67 .TP
  68 .BI --edit
  69 Modifie la configuration de la liste.
  70 .\" ---------------------------------------------------------------
  71 .TP
  72 .BI --subscription= type
  73 Lors de la création d'une liste, définit le mode d'abonnement à
  74 .I free
  75 (libre) ou
  76 .IR moderated
  77 (modéré).
  78 Utilisez-le avec
  79 .BR --edit ,
  80 ou
  81 .BR --create .
  82 .\" ---------------------------------------------------------------
  83 .TP
  84 .BI --posting= type
  85 Lors de la création d'une liste, définit le mode d'envoi à
  86 .IR free ,
  87 (libre)
  88 .IR auto ,
  89 (automatique)
  90 ou
  91 .IR moderated
  92 (modéré).
  93 Utilisez-le avec
  94 .BR --edit ,
  95 ou
  96 .BR --create .
  97 .\" ---------------------------------------------------------------
  98 .TP
  99 .BI --archived= yes-ou-no
 100 Les messages à destination de la liste doivent-ils être archivés sous
 101 la forme d'une
 102 .B archive-box
 103 ou d'un répertoire dans le répertoire dans liste
 104 .B "~/.enemies-of-carlotta"
 105 .
 106 Utilisez
 107 .I yes
 108 (oui) ou
 109 .IR no
 110 (non).
 111 .\" ---------------------------------------------------------------
 112 .TP
 113 .BI --list
 114 Liste l'ensemble des abonnés à une liste de diffusion.
 115 .\" ---------------------------------------------------------------
 116 .TP
 117 .BI --subscribe
 118 Ajoute des abonnés à la liste.
 119 Les arguments qui ne sont pas des options sont les adresses qui doivent
 120 être abonnées. Notez que les adresses ajoutées de cette manière ne
 121 recevront pas de demande de confirmation d'abonnement.
 122 .\" ---------------------------------------------------------------
 123 .TP
 124 .BI --unsubscribe
 125 Enlève un abonné de la liste.
 126 Les arguments qui ne sont pas des options sont les adresses qui doivent
 127 être désabonnées. Notez que les adresses enlevées de cette manière ne
 128 recevront pas de demande de confirmation de désabonnement.
 129 .\" ---------------------------------------------------------------
 130 .TP
 131 .B --incoming
 132 Traite un message entrant sur l'entrée standard.
 133 L'enveloppe SMTP qui précise l'adresse de l'expéditeur doit être
 134 précisée par la variable d'environnement
 135 .I SENDER
 136 et l'enveloppe SMTP qui précise l'adresse du destinataire doit être
 137 précisée par la variable d'environnement
 138 .I RECIPIENT
 139 (QMail et Postfix traitent cela automatiquement.)
 140 .\" ---------------------------------------------------------------
 141 .TP
 142 .BI --skip-prefix= chaîne
 143 Avant d'analyser l'adresse de destination pour regarder à quelle liste
 144 le message est destiné, ce paramètre permet d'enlever
 145 .I chaîne
 146 depuis son début.
 147 C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix,
 148 voyez ci-dessous.
 149 .\" ---------------------------------------------------------------
 150 .TP
 151 .BI --domain= nom.domaine
 152 Avant d'analyser l'adresse de destination pour voir à quelle liste le message
 153 est destiné, remplace le nom de domaine par
 154 .IR nom.domaine .
 155 C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix.
 156 .\" ---------------------------------------------------------------
 157 .TP
 158 .BI --is-list
 159 L'adresse précisée par
 160 .B --name
 161 fait-elle référence à un nom de liste valide\ ?
 162 Cela retourne le code d'erreur zéro (succès) si c'est le cas, ou un (échec)
 163 dans le cas contraire.
 164 .\" ---------------------------------------------------------------
 165 .TP
 166 .BI --sendmail= chemin
 167 Utilise
 168 .I chemin
 169 au lieu de
 170 .B /usr/sbin/sendmail
 171 Pour envoyer des courriels via une interface en ligne de commande.
 172 Notez que la commande doit respecter l'interface de la ligne de commande
 173 sendmail.
 174 .\" ---------------------------------------------------------------
 175 .TP
 176 .BI --smtp-server= hôte
 177 Envoi les courriels en utilisant le serveur
 178 .I hôte
 179 (port 25).
 180 Le serveur doit être configuré pour permettre à la machine sur laquelle
 181 fonctionne la liste de l'utiliser pour relais.
 182 Notez que par défaut, c'est l'interface en ligne de commande qui est utilisée.
 183 L'envoi au moyen de SMTP n'est utilisé que si vous utilisez cette option.
 184 .\" ---------------------------------------------------------------
 185 .TP
 186 .BI --moderate
 187 Force un message entrant à être modéré, même s'il est envoyé à une liste
 188 où l'envoi est libre.
 189 Cela peut être utilisé pour filtrer le spam\ :
 190 Vos messages entrants peuvent être filtrés par n'importe quel système de
 191 filtrage des courriels, dès lors qu'un message semble être du spam,
 192 vous pouvez demander qu'il soit modéré par une personne humaine.
 193 .\" ---------------------------------------------------------------
 194 .TP
 195 .BI --quiet
 196 Par défaut, les messages de débogage des journaux sont envoyés sur
 197 l'erreur standard.
 198 Avec cette option, il ne le sont plus.
 199 .\" ---------------------------------------------------------------
 200 .SH CONFIGURATION
 201 Chaque liste est représentée par un répertoire, nommé d'après le nom de
 202 la liste, sous le répertoire
 203 .IR ~/.enemies-of-carlotta .
 204 Ce répertoire contient plusieurs fichiers et répertoires, qui sont décrits
 205 ci-dessous.
 206 En général, il n'est pas nécessaire de toucher à ces répertoires.
 207 Cependant, certaines configurations ésotériques peuvent uniquement être
 208 faites en éditant le fichier de configuration de la liste.
 209 .TP
 210 .B config
 211 Le fichier de configuration de la liste.
 212 Le contenu est décrit ci-dessous.
 213 .TP
 214 .B subscribers
 215 La base de données des abonnés.
 216 Chaque ligne contient un groupe d'abonné, dont les cinq premiers
 217 espaces délimitent les champs qui sont les identifiants des groupes,
 218 le statut, le timestamp de la date de création du groupe, le timestamp
 219 pour les retours de courriel en cas d'échec, il peut varier de «\ ok\ »
 220 à «\ bonced\ », et l'identifiant du message de retour en cas d'échec.
 221 .TP
 222 .B archive-box
 223 Les messages archivés.
 224 .TP
 225 .B bounce-box
 226 Groupes de messages qui n'ont pu être délivrés et qui sont dans le
 227 statut «\ ok\ ».
 228 .TP
 229 .B moderation-box
 230 Messages en attente d'approbation du modérateur.
 231 .TP
 232 .B subscription-box
 233 Requêtes d'abonnement de désabonnement en attente de confirmation de la
 234 part de l'utilisateur.
 235 .PP
 236 le fichier
 237 .B config
 238 possède des
 239 .IR mot-clé = value
 240 format\ :
 241 .PP
 242 .RS
 243 .nf
 244 [list]
 245 owners = liw@liw.iki.fi
 246 archived = no
 247 posting = free
 248 subscription = free
 249 mail-on-subscription-changes = yes
 250 mail-on-forced-unsubscribe = yes
 251 language = fi
 252 .fi
 253 .RE
 254 .PP
 255 Les mots clés
 256 .BR archived ,
 257 .BR posting ,
 258 et
 259 .B subscription
 260 correspondent aux options qui portent les mêmes noms.
 261 Les autres mots-clés sont\ :
 262 .TP
 263 .B owners
 264 Liste les adresses des propriétaires. Définissez-la à l'aide de
 265 l'option
 266 .I --owner.
 267 .TP
 268 .B mail-on-subscription-changes
 269 Les propriétaires doivent-ils recevoir un avertissement lorsqu'un utilisateur
 270 s'abonne ou se désabonne\ ?
 271 .TP
 272 .B mail-on-forced-unsubscribe
 273 Les propriétaires doivent-ils recevoir un avertissement lorsqu'une personne
 274 est enlevée de la liste car trop de courriels ne lui sont pas parvenus\ ?
 275 .TP
 276 .B language
 277 Suffixe pour les templates, pour permettre le support de plusieurs
 278 langues
 279 (Si
 280 .I language
 281 est défini à «\ fr\ », alors la template nommée «\ foo\ » est d'abord
 282 recherchée comme «\ foo.fr\ ».)
 283 .\" ---------------------------------------------------------------
 284 .SH EXEMPLES
 285 Pour créer une liste nommée
 286 .IR moviefans@example.com ,
 287 dont le propriétaire est
 288 .IR ding@example.com ,
 289 utilisez la commande suivante (tout sur la même ligne)\ :
 290 .sp 1
 291 .RS
 292 enemies-of-carlotta --name=ding@example.com --create
 293 .RE
 294 .PP
 295 Pour voir la liste de tous les abonnés à cette liste\ :
 296 .sp 1
 297 .RS
 298 enemies-of-carlotta --name=moviefans@example.com --list
 299 .RE
 300 .PP
 301 Les personnes qui souhaitent être abonnées à la liste doivent
 302 envoyer un courriel à
 303 .sp 1
 304 .RS
 305 moviefans-subscribe@example.com
 306 .RE
 307 .SH QMAIL
 308 Dans Qmail, pour faire en sorte que le courrier entrant soit traité
 309 par Enemies of Carlotta, vous avez besoin de créer quelques fichiers
 310 .I .qmail-extension
 311 par liste.
 312 Par exemple, si votre nom d'utilisateur est joe et que vous souhaitez
 313 utiliser la liste de diffusion joe-fans, vous devrez créer les
 314 fichiers
 315 .I .qmail-fans
 316 et
 317 .IR .qmail-fans-default ,
 318 qui contiennent
 319 .sp 1
 320 .RS
 321 |"enemies-of-carlotta --incoming"
 322 .RE
 323 .PP
 324 Si vous utilisez un domaine virtuel, example.com, et que les
 325 courriels sont délivrés via
 326 .I /var/qmail/control/virtualdomains à joe-exampledotcom,
 327 les fichiers seront nommés
 328 .I .qmail-exampledotcom-fans
 329 et
 330 .I .qmail-exampledotcom-fans-default
 331 et ils contiendront
 332 .sp 1
 333 .RS
 334 |"enemies-of-carlotta --incoming
 335 .br
 336 --skip-prefix=joe-exampledotcom-"
 337 .RE
 338 .sp 1
 339 (l'ensemble sur la même ligne, il va de soi).
 340 .SH POSTFIX
 341 Avec Postfix, vous devrez configurer un fichier
 342 .I .forward
 343 contenant
 344 .sp 1
 345 .RS
 346 "|procmail -p"
 347 .RE
 348 .sp 1
 349 et un fichier
 350 .I .procmailrc
 351 contenant
 352 .sp 1
 353 .RS
 354 :0
 355 .br
 356 * ? enemies-of-carlotta --name=$RECIPIENT --is-list
 357 .br
 358 | enemies-of-carlotta --incoming
 359 .RE
 360 .PP
 361 Pour utiliser Enemies of Carlotta avec un domaine virtuel Postfix,
 362 vous devrez mettre en place une
 363 .I «\ carte virtuelle d'expressions rationnelles\ »,
 364 généralement
 365 .I /etc/postfix/virtual_regexp
 366 (ajoutez
 367 .I "virtual_maps = regexp:/etc/postfix/virtual_regexp"
 368 dans votre fichier
 369 .I /etc/postfix/main.cf
 370 pour l'activer).
 371 Le fichier d'expressions rationnelles a besoin de faire des choses
 372 horribles pour conserver l'adresse de destination.
 373 Ajoutez ce qui suit dans le fichier d'expressions rationnelles\ :
 374 .sp 1
 375 .RS
 376 /^your\.virtual\.domain$/ dummy
 377 .br
 378 /^(yourlist|yourlist-.*)@(your\.virtual\.domain)$/ joe-virtual-$1
 379 .RE
 380 .sp 1
 381 (Ça fait deux lignes.)
 382 Ensuite dans votre fichier,
 383 .I .procmailrc,
 384 ajoutez les options
 385 .I "--skip-prefix=joe-virtual-"
 386 et
 387 .I --domain=your.virtual.domain
 388 pour les deux appels à
 389 .BR enemies-of-carlotta .
 390 .PP
 391 (Oui, je aussi trouve que ces choses là sont trop compliquées)
 392 .SH FICHIERS
 393 .TP
 394 .I ~/.enemies-of-carlotta
 395 L'ensemble des fichiers en rapports avec vos listes de diffusion.
 396 .TP
 397 .I ~/.enemies-of-carlotta/secret
 398 Les mots de passe secrets utilisés pour générer des adresses signées pour
 399 le contrôle des couriels d'échec et la validation de l'abonnement.
 400 .TP
 401 .I ~/.enemies-of-carlotta/foo@example.com
 402 Le répertoire contient les données appartenant à la liste de diffusion
 403 foo@example.com.
 404 À l'exception du fichier de
 405 .I config
 406 qui se trouve dans ce répertoire, vous ne devriez pas éditer autre chose
 407 à la main
 408 .TP
 409 .I ~/.enemies-of-carlotta/foo@example.com/config
 410 Fichier de configuration pour la liste de diffusion.
 411 Vous aurez peut-être besoin de l'éditer à la main si vous souhaitez
 412 apporter des changement en ce qui concerne la modération ou bien les
 413 propriétaires de la liste.
 414 .SH "VOIR AUSSI"
 415 Vous serez peut-être intéressé de visiter
 416 la page d'accueil d'
 417 .I «\ Enemies of Carlotta\ »
 418 à l'adresse
 419 .IR http://www.iki.fi/liw/eoc/ .
 420 .SH "TRADUCTION"
 421 Pierre Machard <pmachard@tuxfamily.org>, 2003