Provided by: enemies-of-carlotta_1.2.6-3_all bug

NAME

       enemies-of-carlotta - sencillo gestor de listas de correo

SYNOPSIS

       enemies-of-carlotta [opciones] [direcciones]

DESCRIPCIÓN

       enemies-of-carlotta es un gestor sencillo para listas de correo.  Si no
       sabe qué es un gestor de listas de correo, es mejor que aprenda lo  que
       son,  antes  de  intentar  usar  uno  concreto.   Por desgracia, no hay
       espacio para eso en una página de manual.

       Enemies of Carlotta mantiene todos los datos sobre las listas de correo
       en   un   directorio   llamado   ~/.enemies-of-carlotta  .   Se  creará
       automáticamente en cuanto usted cree  la  primera  lista.   Tendrá  que
       hacer  arreglos  a mano para que el gestor de listas pueda procesar los
       mensajes.  Los detalles varían de un servidor de correo a  otro.   Para
       qmail y Postfix, véase más adelante.

       Cada   lista   tiene  uno  o  más  propietarios,  que  también  moderan
       suscripciones o incluso algunos o todos los  envíos  a  la  lista.   En
       listas  sin  moderación  alguna,  el  propietario  de  la  lista  es el
       responsable de contestar las dudas acerca de la lista.  En  listas  con
       moderación completa, tienen que aprobar cada mensaje, antes de que éste
       pueda enviarse a la lista.  En listas con la opción  posting=auto,  los
       mensajes  de  los  suscriptores se envían automáticamente a la lista, y
       los moderadores tienen que aprobar el resto de mensajes.

OPCIONES

       --name=lista@ejemplo.com
              Especifica sobre qué lista ha de actuar la  orden  especificada.
              Casi todas las restantes opciones precisan que especifique antes
              el nombre de la lista con la opción antedicha.  Con las opciones
              --edit,  --subscribe,  --unsubscribe, y --list , el nombre puede
              abreviarse quitando el signo @ y el dominio que le sigue.

       --create
              Crear  una  lista  nueva.   Ha  de  especificar  al   menos   un
              propietario con la opción --owner.

       --owner=direccin
              Al crear una lista, especifica un propietario de la lista.

       --language=cdigo-idioma
              Establece el código de idioma que se usa para buscar plantillas.
              El código debería estar vacío  (opción  por  defecto,  es  decir
              inglés), o un código de dos letras como fi o es.

       --cleaning-woman
              Se  encarga  de las direcciones de rebote y hace otras limpiezas
              varias.   Ha  de  ejecutar  periódicamente   enemies-of-carlotta
              --cleaning-woman  ,  algo  así como una vez por hora.  Efectuará
              una limpieza de todas sus listas.

       --destroy
              Eliminar la lista.

       --edit Modificar la configuración de la lista.

       --subscription=tipo
              Al crear una lista, establece su  modo  de  suscripción  a  free
              (libre)  o  bien  moderated (moderado).  Úselo con --edit, o con
              --create.

       --posting=tipo
              Al crear una lista, establece su modo de  envío  de  mensajes  a
              free  (libre),  auto (auto), o bien moderated (moderado).  Úselo
              con --edit, o con --create.

       --archived=yes-o-no
              Especifica si los mensajes de la lista deben  archivarse  en  el
              directorio archive-box en el directorio de la lista que a su vez
              existe dentro del directorio ~/.enemies-of-carlotta  .   Utilice
              yes o bien no.

       --mail-on-subscription-changes=yes-o-no
              ¿Debería  notificarse a los dueños de la lista cuando alguien se
              suscribe o desuscribe de ella?  Use yes o no.   Por  defecto  es
              no.

       --mail-on-forced-unsubscription=yes-o-no
              ¿Debería  notificarse a los dueños de la lista cuando se elimina
              a alguien de la lista forzosamente por exceso de  rebotes?   Use
              yes o no.  Por defecto es no.

       --list Muestra los suscriptores de una lista de correo.

       --subscribe
              Añade suscriptores a una lista de correo.  Los argumentos que no
              son opciones, son las direcciones que hay  que  suscribir  a  la
              lista.   Observe que las direcciones que se añadan mediante este
              procedimiento no recibirán una confirmación de suscripción, sino
              que se las suscribirá directamente.

       --unsubscribe
              Elimina suscriptores de una lista de correo.  Los argumentos que
              no son opciones, son las direcciones que hay que desuscribir  de
              la  lista.  Observe que las direcciones que se eliminen mediante
              este   procedimiento   no   recibirán   una   confirmación    de
              desuscripción, sino que se las eliminará directamente.

       --incoming
              Encargarse  de un mensaje que se recibe por la entrada estándar.
              La dirección del remitente del envoltorio SMTP (envelope  sender
              address)  debe  especificarse  mediante  la  variable de entorno
              SENDER , y la dirección del  destinatario  del  envoltorio  SMTP
              (SMTP  envelope  recipient  address)  debe  especificarse  en la
              variable de entorno RECIPIENT  .   (qmail  y  Postfix  lo  hacen
              automáticamente).

       --skip-prefix=cadena
              Antes  de  analizar la dirección del destinatario para ver a qué
              lista  se  refiere,  eliminar  cadena  de  su  comienzo.    Esta
              característica  ayuda  en  el  caso de los dominios virtuales de
              qmail y Postfix; véase más arriba.

       --domain=nombre.dominio
              Antes de analizar la dirección del destinatario para ver  a  qué
              lista   se   refiere,   sustituir   la  parte  del  dominio  por
              nombre.dominio.  Esta característica es útil en el caso  de  los
              dominios virtuales de Postfix.

       --is-list
              ¿Se  refiere  la  lista  especificada  en la opción --name a una
              lista válida?  Devuelve un estado de salida de cero  (éxito)  si
              es válida, o un estado de uno (fallo) si no es válida.

       --sendmail=ruta-hasta-el-programa
              Utilice  ruta-hasta-el-programa  en  lugar de /usr/sbin/sendmail
              para enviar correo  por  medio  de  una  interfaz  de  línea  de
              órdenes.   Nótese  que  la  orden  alternativa  debe  seguir las
              convenciones de la interfaz de línea de órdenes sendmail.

       --smtp-server=nombre.de.servidor
              Enviar el correo  usando  el  servidor  SMTP  nombre.de.servidor
              (puerto  25).   El  server ha de estar configurado para permitir
              que la lista pueda efectuar la retransmisión de correo a  través
              de  él.  Nótese que la opción por defecto es usar la interfaz de
              línea de órdenes.  Esta  opción  de  enviar  por  SMTP  sólo  se
              utilizará si la especifica explícitamente.

       --qmqp-server=nombredemaquina
              Enviar correo usando el servidor QMQP que hay en nombredemaquina
              (puerto 628).  El servidor debe estar configurado para  permitir
              que  la máquina de la lista reenvíe correo a través suyo.  Tenga
              en cuenta que por defecto  se  usa  una  interfaz  de  línea  de
              órdenes para el envío; sólo se utilizará QMQP si especifica esta
              opción.

       --moderate
              Forzar la moderación de mensajes para un mensaje  dado,  incluso
              si va a ir a parar a una lista de mensajes donde se puede envíar
              libremente.  Puede usar esta opción para el filtrado  de  correo
              electrónico  no  solicitado (spam): sus mensajes entrantes pasan
              por el filtro de spam que usted  especifique  y  si  el  mensaje
              califica  como  spam,  se solicita la moderación del mensaje por
              parte de una persona.

       --post Forzar el envío de un mensaje entrante a una lista dada, incluso
              si  va  a  ir  a  parar a una lista que tenga el envío moderado.
              Puede usar esta opción cuando hay una comprobación externa de si
              un  correo  es aceptable en una lista; por ejempo, si dispone de
              un comprobador de firmas digitales.

       --quiet
              De forma predeterminada, los mensajes de registro de  depuración
              se  envían  al  flujo  de  salida  de  error estándar.  Con esta
              opción, se anula dicho comportamiento.

       --sender=foo@ejemplo.com

       --recipient=foo@ejemplo.com
              Estas dos opciones se usan junto a --incoming y  --is-list  para
              imponerse  a  las  variables  de  entorno  SENDER  y  RECIPIENT,
              respectivamente.

       --get  Obtiene los valores de una o más variables de configuración.  El
              nombre  de  las  variables se da en la línea de órdenes tras las
              opciones.  Cada valor se imprime en una línea aparte.

       --set  Establece los valores de una o más variables  de  configuración.
              Los  nombres  y  valores  se dan en la línea de órdenes tras las
              opciones y separadas por signos ’igual’ ("=").  Por ejemplo,  lo
              siguiente  establecería  el  finlandés como idioma de una lista:
              enemies-of-carlotta --name=foo@bar --set language=fi

       --version
              Muestra la versión del programa.

       --show-lists
              Muestra las listas conocidas para enemies-of-carlotta.

CONFIGURACIÓN

       Cada lista está representada por un directorio, que recibe el nombre de
       la   lista,   y  que  está  dentro  de  ~/.enemies-of-carlotta.   Dicho
       directorio contiene varios ficheros y directorios, que se describen más
       abajo.  En  general,  no es necesario tocarlos para nada.  Sin embargo,
       determinadas  configuraciones,  un  tanto   esotéricas,   sólo   pueden
       establecerse editando a mano el fichero de configuración de la lista.

       config El  fichero  de  configuración  de  la  lista.   Su contenido se
              describe más abajo.

       subscribers
              Base de datos de suscriptores.  Cada línea contiene un grupo  de
              suscriptores,  siendo  los cinco primeros campos delimitados por
              espacios el identificador del grupo, el estado la marca temporal
              de  cuándo  se creó el grupo, la marca temporal de cuándo cambió
              su estado de ’ok’ a ’bounced’ (rebotado), y el identificador  de
              la devolución (bounce).

       archive-box
              Mensajes de la lista archivados.

       bounce-box
              Grupos  de  mensajes rebotados (bounce) y que no están en estado
              ’ok’.

       headers-to-add
              Cabeceras a añadir a los mensajes enviados  a  esta  lista.   Se
              copian  al principio de cualquier cabecera existente exactamente
              tal como estén en el fichero, tras haber añadido  las  cabeceras
              de  la  lista  ("List-ID",  etc)  y eliminado las mencionadas en
              headers-to-remove .

       headers-to-remove
              Estas cabeceras se eliminan de los mensajes enviados a la lista.

       moderation-box
              Mensajes en espera de aprobación por parte del moderador.

       subscription-box
              Solicitudes   de   suscripción  y  desuscripción  en  espera  de
              confirmación por parte del usuario.

       templates
              Directorio que contiene plantillas (opcionales) específicas a la
              lista.  Si existe este directorio, se buscan las plantillas allí
              antes de ir en busca de plantillas globales.  Un  fichero  vacío
              indica  que  el  mensaje  correspondiente  no será enviado. Esto
              puede usarse, por ejemplo, para desactivar los mensajes  «espere
              por la moderación» en determinadas listas.

       plugins
              Directorio  que  contiene plugins. Son archivos fuente en Python
              que carga EoC automáticamente al arrancar.  Los  plugins  pueden
              variar la manera en que opera EoC.

       El fichero config tiene un formato palabra_clave=valor :

              [list]
              owners = liw@liw.iki.fi
              archived = no
              posting = free
              subscription = free
              mail-on-subscription-changes = yes
              mail-on-forced-unsubscribe = yes
              language = es

       Las palabras clave archived, posting, y subscription corresponden a las
       opciones de su mismo nombre.  Otras palabras clave son:

       owners Lista de las direcciones de  los  propietarios.   Especifíquelas
              con la opción --owner .

       moderators
              Lista de las direcciones de los moderadores.  Especifíquelas con
              la opción --moderator .

       mail-on-subscription-changes
              Especifica si hay que mandar un correo a los propietarios de  la
              lista cada vez que un usuario se suscribe o se desuscribe.

       mail-on-forced-unsubscribe
              Especifica  si hay que mandar un correo a los propietarios de la
              lista cada vez que un usuario  es  dado  de  baja  por  excesivo
              rebote de mensajes.

       ignore_bounce
              Los  rebotes son ignorados en esta lista. Útil por ejemplo si la
              lista debe tener una lista fija de suscriptores.

       language
              Sufijo  para  las  plantillas,  para  permitir  el  suporte   de
              múltiples lenguas.  (Si language tiene el valor "es", entonces a
              la plantilla llamada "aficionados" se la busca en  primer  lugar
              como "aficionados.es".)

       pristine-headers
              No usar codificación MIME para las cabeceras. Establecer a "yes"
              para no hacerlo, cualquier otra cosa  (incluyendo  vacío  o  sin
              establecer) significa que se utilizará la codificación.

EJEMPLOS

       Para  crear  una  lista llamada cinefilos@ejemplo.com, cuyo propietario
       sea dingo@ejemplo.com, utilice la siguiente orden (todo en una línea):

              enemies-of-carlotta --name=cinefilos@ejemplo.com
              --owner=dingo@ejemplo.com --create

       Observe que debe configurar su servidor de correo en concreto
       para que el correo llegue a la lista.
       Para qmail y postfix, véase infra.

       To see the subscribers on that list:

              enemies-of-carlotta --name=cinefilos@ejemplo.com --list

       Quien quiera suscribirse a la lista ha de escribir un correo a:

              cinefilos-subscribe@ejemplo.com

QMAIL

       Con qmail, para conseguir que el  correo  entrante  sea  procesado  por
       Enemies  of Carlotta, tiene que crear dos ficheros .qmail-extension por
       cada lista.  Por ejemplo, si su nombre de  usuario  es  pepe  y  quiere
       ejecutar   la   lista  pepe-aficionados,  ha  de  crear  dos  ficheros,
       .qmail-aficionados y .qmail-aficionados-default, que contengan la línea

              |enemies-of-carlotta --incoming

       Si  tiene configurado un dominio virtual, ejemplo.com, y los correos se
       entregan vía /var/qmail/control/virtualdomains a  pepe-ejemplodotcom  ,
       los    ficheros   se   llamarían   .qmail-ejemplodotcom-aficionados   y
       .qmail-ejemplodotcom-aficionados-default y contendrían

              |enemies-of-carlotta                                  --incoming

              --skip-prefix=pepe-ejemplodotcom-
       (todo  en una línea, claro, por si acaso su lector de páginas de manual
       formatea la orden anterior en varias líneas).

POSTFIX

       Con postfix, ha de configurar un fichero .forward que contenga

              "|procmail -p"

       y además un fichero .procmailrc que contenga

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

       Para usar Enemies of Carlotta con un dominio virtual de Postfix, ha  de
       configurar  un  mapa virtual de expresiones regulares , que típicamente
       está   en    /etc/postfix/virtual_regexp    (añada    virtual_maps    =
       regexp:/etc/postfix/virtual_regexp  a  su  fichero /etc/postfix/main.cf
       para activar esta carcterística).  El fichero de expresiones  regulares
       ha   de   hacer   cosas   extrañas  para  conservar  la  dirección  del
       destinatario.  Añada lo siguiente al fichero de expresiones regulares:

              /^su.dominio.virtual$/ dummy
              /^(sulista|sulista-.*)@(su.dominio.virtual)$/ pepe+virtual-$1

       (Lo anterior estaba en dos líneas). Utilize pepe-virtual en  lugar  del
       anterior  si el recipient_delimiter de su Postfix está configurado para
       usar un signo menos en vez de más.  Luego, en  su  fichero  .procmailrc
       añada     la     opción     --skip-prefix=pepe-virtual-    y    también
       --domain=your.virtual.domain    para     las     dos     llamadas     a
       enemies-of-carlotta.

       (Sí,  nosotros también pensamos que estas configuraciones son demasiado
       complicadas).

ÓRDENES PARA EL CORREO

       Los usuarios y los propietarios  de  las  listas  utilizan  Enemies  of
       Carlotta  a través del correo electrónico, usando para ello direcciones
       a modo de órdenes, como por ejemplo  aficionados-subscribe@ejemplo.com.
       He  aquí  una lista de todas las órdenes que pueden usar tanto usuarios
       como propietarios de listas de correo.  En  todos  estos  ejemplos,  el
       nombre de la lista de correo es aficionados@ejemplo.com.

   Órdenes a través de correo que pueden usar todos
       Estas  órdenes  están  pensadas  para  el  uso general.  No precisan de
       ningún privilegio especial.

       aficionados@ejemplo.com
              Enviar correo a todos los suscritos  a  la  lista.   El  mensaje
              pueden   haberlo   aprobado  previamente  de  forma  manual  los
              administradores de la lista, que están facultados para  rechazar
              los mensajes.

       aficionados-owner@ejemplo.com
              Enviar un correo al propietario o propietarios de la lista.

       aficionados-help@ejemplo.com
              Enviar  un  correo a esta dirección hace que el gestor de listas
              de correo nos devuelva un correo con la ayuda existente sobre la
              lista en cuestión.

       aficionados-subscribe@ejemplo.com
              Envíe  un  mensaje a esta dirección para suscribirse a la lista.
              El gestor de listas de correo le responderá con una confirmación
              de  suscripción.   No  se  le  suscribirá a la lista a menos que
              responda a la petición  de  confirmación.   De  esta  forma,  un
              usuario malicioso no podrá poner su dirección en una o en muchas
              listas de correo.

       aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
              Esta es una manera alternativa de la dirección  de  suscripción.
              Si  desea  suscribirse  a  la  lista de correo con una dirección
              distinta a aquella desde la que envía el mensaje,  utilice  esta
              modalidad.   En  este  caso,  la  dirección  para suscribirse es
              pepe@ejemplo.com.  Nótese que la  petición  de  confirmación  se
              envía  a Pepe, puesto que es su dirección la que va a añadirse a
              la lista.

       aficionados-unsubscribe@ejemplo.com
              Para  desuscribirse  de  una  lista,  envíe  un  correo  a  esta
              dirección  desde la dirección que desea desuscribir de la lista.
              De nuevo recibirá una petición de confirmación, para evitar  que
              un usuario malicioso le desuscriba de una lista de correo contra
              su voluntad.

       aficionados-unsubscribe-pepe=ejemplo.com@ejemplo.com
              Para desuscribir a Pepe, use esta dirección.  De nuevo, es  Pepe
              quien recibirá la petición de confirmación.

   Órdenes a través de correo que pueden usar los propietarios de las listas
       Se  trata  de  órdenes  que pueden usar los propietarios de listas para
       administrar su lista.

       aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
              Si un propietario de una lista envía un correo  a  la  dirección
              anterior,  él  recibirá  la petición de confirmación, y no Pepe.
              Generalmente es  mejor  que  los  usuarios  se  suscriban  ellos
              mismos,  pero  a  veces los propietarios de listas pueden desear
              esta  característica,  cuando  tienen  permiso  de  la   persona
              afectada y quieren resultar más útiles.

       aficionados-unsubscribe-pepe=ejemplo.com@ejemplo.com
              Los  propietarios  de  listas también pueden desuscribir a otros
              usuarios.

       aficionados-list@ejemplo.com
              Para ver quién  está  en  la  lista,  envíe  un  correo  a  esta
              dirección.   Sólo  funciona  si  la  dirección del remitente del
              correo coincide con un propietario de  la  lista.  La  dirección
              "sender  address"  se usa a nivel del protocolo SMTP, y no es la
              del encabezamiento "From:"

       aficionados-setlist@ejemplo.com
              Esta orden permite al propietario de una  lista  especificar  de
              una  sola  vez  toda  la lista de suscriptores. Es equivalente a
              utilizar  montones  y   montones   de   órdenes   -subscribe   y
              -unsubscribe,  sólo  que  menos  tedioso.   Todo  el que resulte
              añadido a la lista recibe un mensaje de bienvenida,  y  todo  el
              que  quede eliminado de la lista recibe un mensaje de despedida.

       aficionados-setlistsilently@ejemplo.com
              Semejante  a  -setlist,  pero  no  se  envían  mensajes  ni   de
              bienvenida, ni de despedida.

PLUGINS

       Enemies  of  Carlotta  admite plugins.  Si no sabe programar en Python,
       probablemente se puede saltar esta sección.

       Un plugin es un módulo de Python (fichero  con  un  sufijo  .py  en  el
       nombre), situado en el directorio ~/.enemies-of-carlotta/plugins .  Los
       plugins se cargan automáticamente durante el arranque,  si  la  versión
       declarada  de  su interfaz se ajusta con la implementada por Enemies of
       Carlotta. La versión de la interfaz se declara en  la  variable  global
       del módulo PLUGIN_INTERFACE_VERSION.

       Los  plugin  pueden  definir  funciones  que  serán invocadas desde los
       lugares apropiados del código EoC.  Por el momento, la única función de
       enganche  (hook) disponible es send_mail_to_subscribers_hook, que puede
       manipular un mensaje antes de que sea enviado a los  suscriptores.   La
       función debe parecerse a esto:

            def send_mail_to_subscribers_hook(list, text):

       El   argumento  list  es  una  referencia  al  objeto  MailingList  que
       corresponde a la lista en cuestión, y text es  el  texto  completo  del
       mensaje  de  correo  en  su  forma actual.  La función debe devolver el
       nuevo contenido del mensaje de correo.

FICHEROS

       ~/.enemies-of-carlotta
              Aquí están todos los ficheros relacionados  con  sus  listas  de
              correo.

       ~/.enemies-of-carlotta/secret
              Contraseña  secreta que se usa para generar direcciones firmadas
              para  comprobación  de  rebotes  de  correo  y  verificación  de
              suscripción.

       ~/.enemies-of-carlotta/aficionados@ejemplo.com
              Directorio   que   contiene  los  datos  relativos  a  la  lista
              aficionados@ejemplo.com.  Excepto  el  fichero  config  de  este
              directorio, no debe editar a mano nada de lo contenido en él.

       ~/.enemies-of-carlotta/aficionados@ejemplo.com/config
              Fichero de configuración de la lista de correo.  Quizá tenga que
              editar este fichero  a  mano  si  desea  cambiar  el  estado  de
              moderación de la lista o sus propietarios.

VÉASE TAMBIÉN

       Visite    la    página    de    Enemies    of   Carlotta   alojada   en
       http://www.iki.fi/liw/eoc/.

       La traducción de esta página ha corrido a cargo de Iván Juanes
              kerberos@gulic.org y de Ricardo  Cárdenes  heimy@gulic.org  como
              parte de los proyectos del grupo Gulic.

                                                        ENEMIES-OF-CARLOTTA(1)