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

NAME

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

SYNOPSIS

       enemies-of-carlotta [opciones] [direcciones]

DESCRIPCI'ON

       enemies-of-carlotta es un gestor sencillo para listas de correo.  Si no
       sabe que 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 pagina de manual.

       Enemies of Carlotta mantiene todos los datos sobre las listas de correo
       en   un   directorio   llamado   ~/.enemies-of-carlotta  .   Se  creara
       automaticamente en cuanto usted cree  la  primera  lista.   Tendra  que
       hacer  arreglos  a mano para que el gestor de listas pueda procesar los
       mensajes.  Los detalles varian de un servidor de correo a  otro.   Para
       qmail y Postfix, vease mas adelante.

       Cada   lista   tiene  uno  o  mas  propietarios,  que  tambien  moderan
       suscripciones o incluso algunos o todos los  envios  a  la  lista.   En
       listas  sin  moderacion  alguna,  el  propietario  de  la  lista  es el
       responsable de contestar las dudas acerca de la lista.  En  listas  con
       moderacion completa, tienen que aprobar cada mensaje, antes de que este
       pueda enviarse a la lista.  En listas con la opcion  posting=auto,  los
       mensajes  de  los  suscriptores se envian automaticamente a la lista, y
       los moderadores tienen que aprobar el resto de mensajes.

OPCIONES

       --name=lista@ejemplo.com
              Especifica sobre que lista ha de actuar la  orden  especificada.
              Casi todas las restantes opciones precisan que especifique antes
              el nombre de la lista con la opcion 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 opcion --owner.

       --owner=direcci'on
              Al crear una lista, especifica un propietario de la lista.

       --language=c'odigo-idioma
              Establece el codigo de idioma que se usa para buscar plantillas.
              El codigo deberia estar vacio  (opcion  por  defecto,  es  decir
              ingles), o un codigo de dos letras como fi o es.

       --cleaning-woman
              Se  encarga  de las direcciones de rebote y hace otras limpiezas
              varias.   Ha  de  ejecutar  periodicamente   enemies-of-carlotta
              --cleaning-woman  ,  algo  asi como una vez por hora.  Efectuara
              una limpieza de todas sus listas.

       --destroy
              Eliminar la lista.

       --edit Modificar la configuracion de la lista.

       --subscription=tipo
              Al crear una lista, establece su  modo  de  suscripcion  a  free
              (libre)  o  bien  moderated (moderado).  Uselo con --edit, o con
              --create.

       --posting=tipo
              Al crear una lista, establece su modo de  envio  de  mensajes  a
              free  (libre),  auto (auto), o bien moderated (moderado).  Uselo
              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
              cDeberia  notificarse a los duenos 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
              cDeberia  notificarse a los duenos 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
              Anade 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 anadan mediante este
              procedimiento no recibiran una confirmacion de suscripcion, sino
              que se las suscribira 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   recibiran   una   confirmacion    de
              desuscripcion, sino que se las eliminara directamente.

       --incoming
              Encargarse  de un mensaje que se recibe por la entrada estandar.
              La direccion del remitente del envoltorio SMTP (envelope  sender
              address)  debe  especificarse  mediante  la  variable de entorno
              SENDER , y la direccion del  destinatario  del  envoltorio  SMTP
              (SMTP  envelope  recipient  address)  debe  especificarse  en la
              variable de entorno RECIPIENT  .   (qmail  y  Postfix  lo  hacen
              automaticamente).

       --skip-prefix=cadena
              Antes  de  analizar la direccion del destinatario para ver a que
              lista  se  refiere,  eliminar  cadena  de  su  comienzo.    Esta
              caracteristica  ayuda  en  el  caso de los dominios virtuales de
              qmail y Postfix; vease mas arriba.

       --domain=nombre.dominio
              Antes de analizar la direccion del destinatario para ver  a  que
              lista   se   refiere,   sustituir   la  parte  del  dominio  por
              nombre.dominio.  Esta caracteristica es util en el caso  de  los
              dominios virtuales de Postfix.

       --is-list
              cSe  refiere  la  lista  especificada  en la opcion --name a una
              lista valida?  Devuelve un estado de salida de cero  (exito)  si
              es valida, o un estado de uno (fallo) si no es valida.

       --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  linea  de
              ordenes.   Notese  que  la  orden  alternativa  debe  seguir las
              convenciones de la interfaz de linea de ordenes 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 retransmision de correo a  traves
              de  el.  Notese que la opcion por defecto es usar la interfaz de
              linea de ordenes.  Esta  opcion  de  enviar  por  SMTP  solo  se
              utilizara si la especifica explicitamente.

       --qmqp-server=nombredemaquina
              Enviar correo usando el servidor QMQP que hay en nombredemaquina
              (puerto 628).  El servidor debe estar configurado para  permitir
              que  la maquina de la lista reenvie correo a traves suyo.  Tenga
              en cuenta que por defecto  se  usa  una  interfaz  de  linea  de
              ordenes para el envio; solo se utilizara QMQP si especifica esta
              opcion.

       --moderate
              Forzar la moderacion de mensajes para un mensaje  dado,  incluso
              si va a ir a parar a una lista de mensajes donde se puede enviar
              libremente.  Puede usar esta opcion para el filtrado  de  correo
              electronico  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 moderacion del mensaje por
              parte de una persona.

       --post Forzar el envio de un mensaje entrante a una lista dada, incluso
              si  va  a  ir  a  parar a una lista que tenga el envio moderado.
              Puede usar esta opcion cuando hay una comprobacion 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  depuracion
              se  envian  al  flujo  de  salida  de  error estandar.  Con esta
              opcion, 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 mas variables de configuracion.  El
              nombre  de  las  variables se da en la linea de ordenes tras las
              opciones.  Cada valor se imprime en una linea aparte.

       --set  Establece los valores de una o mas variables  de  configuracion.
              Los  nombres  y  valores  se dan en la linea de ordenes tras las
              opciones y separadas por signos 'igual' ("=").  Por ejemplo,  lo
              siguiente  estableceria  el  finlandes como idioma de una lista:
              enemies-of-carlotta --name=foo@bar --set language=fi

       --version
              Muestra la version del programa.

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

CONFIGURACI'ON

       Cada lista esta representada por un directorio, que recibe el nombre de
       la   lista,   y  que  esta  dentro  de  ~/.enemies-of-carlotta.   Dicho
       directorio contiene varios ficheros y directorios, que se describen mas
       abajo.  En  general,  no es necesario tocarlos para nada.  Sin embargo,
       determinadas  configuraciones,  un  tanto   esotericas,   solo   pueden
       establecerse editando a mano el fichero de configuracion de la lista.

       config El  fichero  de  configuracion  de  la  lista.   Su contenido se
              describe mas abajo.

       subscribers
              Base de datos de suscriptores.  Cada linea contiene un grupo  de
              suscriptores,  siendo  los cinco primeros campos delimitados por
              espacios el identificador del grupo, el estado la marca temporal
              de  cuando  se creo el grupo, la marca temporal de cuando cambio
              su estado de 'ok' a 'bounced' (rebotado), y el identificador  de
              la devolucion (bounce).

       archive-box
              Mensajes de la lista archivados.

       bounce-box
              Grupos  de  mensajes rebotados (bounce) y que no estan en estado
              'ok'.

       headers-to-add
              Cabeceras a anadir a los mensajes enviados  a  esta  lista.   Se
              copian  al principio de cualquier cabecera existente exactamente
              tal como esten en el fichero, tras haber anadido  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 aprobacion por parte del moderador.

       subscription-box
              Solicitudes  de  suscripcion  y  desuscripcion  en   espera   de
              confirmacion por parte del usuario.

       templates
              Directorio que contiene plantillas (opcionales) especificas a la
              lista.  Si existe este directorio, se buscan las plantillas alli
              antes  de  ir  en busca de plantillas globales. Un fichero vacio
              indica que el mensaje  correspondiente  no  sera  enviado.  Esto
              puede usarse, por ejemplo, para desactivar los mensajes <<espere
              por la moderacion>> en determinadas listas.

       plugins
              Directorio que contiene plugins. Son archivos fuente  en  Python
              que  carga  EoC automaticamente 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.  Especifiquelas
              con la opcion --owner .

       moderators
              Lista de las direcciones de los moderadores.  Especifiquelas con
              la opcion --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. Util por ejemplo si  la
              lista debe tener una lista fija de suscriptores.

       language
              Sufijo   para  las  plantillas,  para  permitir  el  suporte  de
              multiples 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 codificacion MIME para las cabeceras. Establecer a "yes"
              para  no  hacerlo,  cualquier  otra cosa (incluyendo vacio o sin
              establecer) significa que se utilizara la codificacion.

EJEMPLOS

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

              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, vease 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 linea

              |enemies-of-carlotta --incoming

       Si  tiene configurado un dominio virtual, ejemplo.com, y los correos se
       entregan via /var/qmail/control/virtualdomains a  pepe-ejemplodotcom  ,
       los    ficheros   se   llamarian   .qmail-ejemplodotcom-aficionados   y
       .qmail-ejemplodotcom-aficionados-default y contendrian

              |enemies-of-carlotta                                  --incoming

              --skip-prefix=pepe-ejemplodotcom-
       (todo  en una linea, claro, por si acaso su lector de paginas de manual
       formatea la orden anterior en varias lineas).

POSTFIX

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

              "|procmail -p"

       y ademas 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 tipicamente
       esta   en    /etc/postfix/virtual_regexp    (anada    virtual_maps    =
       regexp:/etc/postfix/virtual_regexp  a  su  fichero /etc/postfix/main.cf
       para activar esta carcteristica).  El fichero de expresiones  regulares
       ha   de   hacer   cosas   extranas  para  conservar  la  direccion  del
       destinatario.  Anada lo siguiente al fichero de expresiones regulares:

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

       (Lo anterior estaba en dos lineas). Utilize pepe-virtual en  lugar  del
       anterior  si el recipient_delimiter de su Postfix esta configurado para
       usar un signo menos en vez de mas.  Luego, en  su  fichero  .procmailrc
       anada     la     opcion     --skip-prefix=pepe-virtual-    y    tambien
       --domain=your.virtual.domain    para     las     dos     llamadas     a
       enemies-of-carlotta.

       (Si,  nosotros tambien pensamos que estas configuraciones son demasiado
       complicadas).

'ORDENES PARA EL CORREO

       Los usuarios y los propietarios  de  las  listas  utilizan  Enemies  of
       Carlotta  a traves del correo electronico, usando para ello direcciones
       a modo de ordenes, como por ejemplo  aficionados-subscribe@ejemplo.com.
       He  aqui  una lista de todas las ordenes 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.

   'Ordenes a trav'es de correo que pueden usar todos
       Estas  ordenes  estan  pensadas  para  el  uso general.  No precisan de
       ningun 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 estan 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 direccion hace que el gestor de listas
              de correo nos devuelva un correo con la ayuda existente sobre la
              lista en cuestion.

       aficionados-subscribe@ejemplo.com
              Envie  un  mensaje a esta direccion para suscribirse a la lista.
              El gestor de listas de correo le respondera con una confirmacion
              de  suscripcion.   No  se  le  suscribira a la lista a menos que
              responda a la peticion  de  confirmacion.   De  esta  forma,  un
              usuario malicioso no podra poner su direccion en una o en muchas
              listas de correo.

       aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
              Esta es una manera alternativa de la direccion  de  suscripcion.
              Si  desea  suscribirse  a  la  lista de correo con una direccion
              distinta a aquella desde la que envia el mensaje,  utilice  esta
              modalidad.   En  este  caso,  la  direccion  para suscribirse es
              pepe@ejemplo.com.  Notese que la  peticion  de  confirmacion  se
              envia  a Pepe, puesto que es su direccion la que va a anadirse a
              la lista.

       aficionados-unsubscribe@ejemplo.com
              Para  desuscribirse  de  una  lista,  envie  un  correo  a  esta
              direccion  desde la direccion que desea desuscribir de la lista.
              De nuevo recibira una peticion de confirmacion, 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 direccion.  De nuevo, es  Pepe
              quien recibira la peticion de confirmacion.

   'Ordenes a trav'es de correo que pueden usar los propietarios de las listas
       Se  trata  de  ordenes  que pueden usar los propietarios de listas para
       administrar su lista.

       aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
              Si un propietario de una lista envia un correo  a  la  direccion
              anterior,  el  recibira  la peticion de confirmacion, y no Pepe.
              Generalmente es  mejor  que  los  usuarios  se  suscriban  ellos
              mismos,  pero  a  veces los propietarios de listas pueden desear
              esta  caracteristica,  cuando  tienen  permiso  de  la   persona
              afectada y quieren resultar mas utiles.

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

       aficionados-list@ejemplo.com
              Para ver quien  esta  en  la  lista,  envie  un  correo  a  esta
              direccion.   Solo  funciona  si  la  direccion del remitente del
              correo coincide con un propietario de  la  lista.  La  direccion
              "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   ordenes   -subscribe   y
              -unsubscribe,  solo  que  menos  tedioso.   Todo  el que resulte
              anadido 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  envian  mensajes  ni  de
              bienvenida, ni de despedida.

PLUGINS

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

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

       Los plugin pueden definir  funciones  que  seran  invocadas  desde  los
       lugares apropiados del codigo EoC.  Por el momento, la unica funcion de
       enganche (hook) disponible es send_mail_to_subscribers_hook, que  puede
       manipular  un  mensaje antes de que sea enviado a los suscriptores.  La
       funcion 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 cuestion, y text es el texto completo del
       mensaje de correo en su forma actual.   La  funcion  debe  devolver  el
       nuevo contenido del mensaje de correo.

FICHEROS

       ~/.enemies-of-carlotta
              Aqui  estan  todos  los  ficheros relacionados con sus listas de
              correo.

       ~/.enemies-of-carlotta/secret
              Contrasena secreta que se usa para generar direcciones  firmadas
              para  comprobacion  de  rebotes  de  correo  y  verificacion  de
              suscripcion.

       ~/.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 el.

       ~/.enemies-of-carlotta/aficionados@ejemplo.com/config
              Fichero de configuracion de la lista de correo.  Quiza tenga que
              editar  este  fichero  a  mano  si  desea  cambiar  el estado de
              moderacion de la lista o sus propietarios.

V'EASE TAMBI'EN

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

       La traduccion de esta pagina ha corrido a cargo de Ivan Juanes
              kerberos@gulic.org  y  de  Ricardo Cardenes heimy@gulic.org como
              parte de los proyectos del grupo Gulic.

                                                        ENEMIES-OF-CARLOTTA(1)