[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
guida a PeaceLink: l'owner
MANUALE DELL'OWNER
------------------
a cura di Marco Trotta mrta@libero.it
Le nuove soluzioni tecniche introdotte dentro Peacelink hanno trasformato le
mailing list esistenti spostando il gestore delle liste dal lato BBS al
Internet (sul server Alex Langer). Questo permette, per esempio:
- ai messaggi di essere distribuiti in tempo reale e rendere la procedura di
subscribe ed unsubscribe da parte degli utenti piu` rapida ed intuitiva
- di avere maggiori possibilita` tecniche (smistamento tramite filtri piu`
accurato, maggiore integrazione con il webgate, ecc.)
- di rendere i moderatori anche owner delle proprie liste.
Essere owner significa avere la possibilita` di intervenire in alcuni
processi di gestione della lista, per esempio:
- aggiungere o togliere un indirizzo
- verificare l'esistenza di un indirizzo
- richiedere la lista aggiornata di tutti gli indirizzi della mailing list
- ecc.
Gli owners sono i moderatori della mailing list registrati con un indirizzo
ed una password (che indicheremo con una password fittizia: "test123") per
poter operare in maniera esclusiva sulla lista.
== DALLA TEORIA ALLA PRATICA ==
Gli owners hanno a disposizione un indirizzo di posta elettronica:
pck-[nome_della_lista_che_moderano]-request@peacelink.it
dove spedire i messaggi contententi i comandi per poter operare sulla lista.
Con questo indirizzo, inoltre, il server comunichera` a ciascun owner le
informazioni tecniche sulla lista (utenti sconosciuti, nuove sottoscrizioni,
ecc.) ed il risultato dell'esecuzione di un comando.
I comandi disponibili sono questi:
- subscribe [mailaddress]
Aggiunge un indirizzo alla lista
- unsubscribe [mailaddress]
Toglie un indirizzo dalla lista
- checkdist [mailaddress]
Verifica che un indirizzo sia compreso in lista
- showdist
Serve a farsi spedire l'indirizzo completo di tutti gli indirizzi che
sottoscrivono la mailing list
- showlist
Comando da implementare: showlist: Customise first (?!?!?)
- showlog
Serve a farsi spedire il "log file" della lista, ovvero una specie di
registro dove il server indica tutto quello che e` successo in ordine
cronologico (chi si e` sottoscritto, utenti sconosciuti, ecc.)
- wipelog
Serve a cancellare il "log file" della lista (ovvero le ultime
registrazioni per averne una lettura piu` semplice alla prossima richiesta
con showlog)
- version
Spedisce la versione del gestore di lista.
- help
Spedisce l'elenco (questo) di tutti i comandi che il gestore della lista
puo` interpretare.
- info
Analogo a help
La sintassi per inviarli al server usa il campo "X-Command:" dell'header del
messaggio. In mancanza di un programma di posta elettronica che consenta
all'utente di operare direttamente su di esso, si puo` inserire in questa
forma nel corpo del messaggio:
From: [indirizzo_dell'Owner]
To: pck-[nome_della_lista_che_moderano]-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: [indirizzo_dell'Owner] [password] [comando]
^ ^ ^
Mi raccomando gli spazi !!! :-) Questo, come nell'esempio, a patto che sia
la *prima* riga del messaggio, senza spazi ne' altri caratteri prima.
In altra maniera si rischia una scorretta interpretazione del comando
Per esempio, nel mio caso:
From: matro@hotpop.com
To: pck-yugoslavia-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: matro@hotpop.com test123 help
Si possono inviare anche piu` comandi contemporaneamente, in questo caso il
server li interpretera` in sequenza. La sintassi e` questa:
From: [indirizzo_dell'Owner]
To: pck-[nome_della_lista_che_moderano]-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: [indirizzo_dell'Owner] [password] [comando]
[comando]
[comando]
[comando]
[...]
^^^^^^^^
Ogni riga, dopo la prima, inizia con un TAB (quel tasto [->] a destra della
Q di ogni tastiera). In questo caso, pena la scorretta interpretazione del
comando, quest'ultimo deve essere posizionato su ogni linea tramite un
ritorno a capo (return).
Per esempio, nel mio caso:
From: matro@hotpop.com
To: pck-yugoslavia-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: matro@hotpop.com test123 unsubscribe bill@whitehouse.gov
unsubscribe max@democraticidisinistra.it
unsubscribe blair@labour.uk
unsubscribe slobo@gov.yu
Tutti questi comandi NON significano che d'ora in poi le sottoscrizioni
avvengono solo per mano degli owner.
La procedura per gli utenti rimane, cambia la sintassi. Ora per
sottoscrivere le mailing list di Peacelink devono inviare un messaggio con
queste indicazioni:
From: [indirizzo_utente]
To: pck-[nome_della_lista_da_sottoscrivere]-request@peacelink.it
Subject: subscribe
-----------------------------------------------------------------
A questo comando il server risponde con questo messaggio al quale
replicare per la conferma lasciando nel soggetto il comando confirm
con il codice alfanumerico generato:
+---------------------------------------------------------------------------+
|From: pck-[nome_della_lista_da_sottoscrivere]-request@peacelink.it
|
|To: CONFIRM [codice_alfanumerico]
|
|Subject: subscribe
|
|---------------------------------------------------------------------------|
|
|
| E' stata ricevuta una tua richiesta dal seguente indirizzo:
|
|
|
| [indirizzo_utente]
|
|
|
| di iscrizione alla lista pck-yugoslavia .
|
|
|
| Per essere iscritto devi confermare la tua iscrizione
|
| inviando una email all'indirizzo:
|
|
|
| pck-[nome_della_lista_da_sottoscrivere]-request@peacelink.it
|
|
|
| inserendo nel Subject il testo:
|
|
|
| CONFIRM [codice_alfanumerico]
|
|
|
| Con un buon programma di e-mail ti basta eseguire un reply
|
| al presente messaggio
|
|
|
|
|
| You have requested that the following address:
|
|
|
| [indirizzo_utente]
|
|
|
| be added to the pck-[nome_della_lista_da_sottoscrivere] mailing list.
|
|
|
| You have NOT yet been subscribed to the mailing list.
|
| To subscribe you need to confirm your subscription
|
| request by sending email to the address:
|
|
|
| pck-[nome_della_lista_da_sottoscrivere]-request@peacelink.it
|
|
|
| with the Subject string:
|
|
|
| CONFIRM [codice_alfanumerico]
|
|
|
| With a reasonable good email program a reply to this
|
| message should be sufficient
|
| When your confirm message has been received the above listed address
|
| will be (un)subscribed. If the above address is incorrect, please do
not |
| send in the confirm message listed above. Instead, send a new
|
| (un)subscribe request containing the Subject:
|
|
|
| subscribe correct-address@correct-domain
|
|
|
| or
|
|
|
| unsubscribe correct-address@correct-domain
|
|
|
| and wait for a new confirmation message.
|
|
|
| A copy of the (un)subcription request appears below. In the event that
|
| you did not send a request to (un)subscribe, the headers of the message
|
| may help you discover who sent the request.
|
|
|
|[...]
|
|
|
+---------------------------------------------------------------------------+
== MI SCRIVONO GLI ALIENI !! ==
(ovvero proviamo ad intepretare le risposte del server :-)
Se tutto va bene fin qui, queste dovrebbero essere le risposte del server
nel caso voi mandate i seguenti comandi:
____________
1) SUBSCRIBE
From: matro@hotpop.com
To: pck-yugoslavia-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: matro@hotpop.com test123 subscribe onu@onu.org
+--------------------------------------------------------------------------+
|From: Marco Trotta <matro@hotpop.com> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: |
|X-Processed: matro@hotpop.com test123 subscribe onu@onu.org |
|X-Envelope-To: pck-yugoslavia-request |
|Date: Sat, 12 Jun 1999 13:24:24 +0200 |
|--------------------------------------------------------------------------|
| |
|The prospective subscriber address generates the following |
|multigram matches to the current list: |
| |
| 23 onu@onu.org 32760 onu@onu.org |
| 56 utenti1@dominio.com 22839 onu@onu.org |
| 42 utenti2@dominio.com 22672 onu@onu.org |
| 68 utenti3@dominio.com 21593 onu@onu.org |
| 67 utenti4@dominio.com 1267 onu@onu.org |
| 20 utenti5@dominio.com 1071 onu@onu.org |
| 59 utenti6@dominio.com 773 onu@onu.org |
| 38 utenti7@dominio.com 707 onu@onu.org |
+--------------------------------------------------------------------------+
La colonna di sinistra e` ordinata alfabeticamente in base al dominio
dell'indirizzo (cio` che e` a destra della @)
______________
2) UNSUBSCRIBE
From: matro@hotpop.com
To: pck-yugoslavia-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: matro@hotpop.com test123 unsubscribe scognamiglio@udr.org
+--------------------------------------------------------------------------+
|From: Marco Trotta <matro@hotpop.com> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: |
|X-Processed: matro@hotpop.com test123 unsubscribe scognamiglio@udr.org |
|Date: Sat, 12 Jun 1999 13:24:31 +0200 |
|--------------------------------------------------------------------------|
| |
|The address that is about to unsubscribed generates the |
|following multigram matches to the current list: |
| |
| 25 scognamiglio@rinnovamento.it 32760 scognamiglio@udr.org |
| 12 utenti1@dominio.com 1936 scognamiglio@udr.org |
| 18 utenti2@dominio.com 1104 scognamiglio@udr.org |
| 29 utenti3@dominio.com 936 scognamiglio@udr.org |
| 2 utenti4@dominio.com 457 scognamiglio@udr.org |
| 26 utenti5@dominio.com 104 scognamiglio@udr.org |
| 31 utenti6@dominio.com 52 scognamiglio@udr.org |
| 53 utenti7@dominio.com 37 scognamiglio@udr.org |
+--------------------------------------------------------------------------+
____________
3) CHECKDIST
From: matro@hotpop.com
To: pck-yugoslavia-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: matro@hotpop.com test123 checkdist est@ecn.org
+--------------------------------------------------------------------------+
|From: Marco Trotta <matro@hotpop.com> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: |
|X-Processed: matro@hotpop.com test123 checkdist est@ecn.org |
|Date: Thu, 10 Jun 1999 11:30:17 +0200 |
|--------------------------------------------------------------------------|
| |
|Multigram checking the dist file for matches with |
|est@ecn.org: |
| |
| 49 est@ecn.org 32757 est@ecn.org |
| 73 ka@login.it 199 est@ecn.org |
| 24 gubi@zzz.it 0 est@ecn.org |
| 58 isotest@inrete.it -1049 est@ecn.org |
| 28 kfqma@tin.it -1167 est@ecn.org |
| 54 pvier@iol.it -1366 est@ecn.org |
| 37 franci@zzz.it -2521 est@ecn.org |
| 6 negrato@tin.it -3312 est@ecn.org |
+--------------------------------------------------------------------------+
n match punteggio email
Incolonnati cosi`, questi dati significano
email: indirizzo da controllare
match: corrispondenza trovata nel file ``accept'' (che contiene gli
indirizzi)
n: numero di riga in cui suddetta corrispondenza e` presente nel
succitato file
punteggio: punteggio assegnato al match, ordinati in ordine di grandezza
rappresentano la probabilita` di correlazione
___________
4) SHOWDIST
From: matro@hotpop.com
To: pck-yugoslavia-request@peacelink.it
Subject:
-----------------------------------------------------------------
X-command: matro@hotpop.com test123 showdist
+--------------------------------------------------------------------------+
|From: Marco Trotta <matro@hotpop.com> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: |
|X-Processed: matro@hotpop.com test123 showdist |
|Date: Thu, 10 Jun 1999 11:30:11 +0200 |
|--------------------------------------------------------------------------|
| |
|--- Current subscribers: |
|(Only addresses below this line can be automatically removed) |
|[...] |
|--- End of subscriber list |
+--------------------------------------------------------------------------+
Gli altri comandi potete provarli voi !!! :-)
Il server, inoltre, periodicamente puo` avvertire l'owner dell'andamento
tecnico della lista inviando le email di nuovi sottoscrittori, quelle
rimbalzate per indirizzi non piu` validi, ecc.
Si tratta di semplici NOTIFICHE, ovvero il server avverte di un determinato
evento, abbozza una diagnosi e lascia all'arbitrio dell'owner il da farsi
prima di intervenire in maniera automatica (ma solo in alcuni casi).
Tutte le informazioni necessarie a capire che tipo di evento viene
notificato si trovano nell'header del messaggio. L'header e` una parte del
messaggio contentente informazioni tecniche, in genere di queste vengono
rese visibili all'utente solo i campi del mittente (From:), destinatario
(To, Cc:), la data (date:) ed il soggetto (subject:).
Il campo che interessa l'owner e` "X-Diagnostic"
Gli utenti Eudora possono renderlo visibile cliccando sul tasto "Blah,
Blah" della finestra del messaggio aperto in alto a sinistra.
Gli utenti Outlook hanno questa procedura:
- posizionarsi con il mouse sul messaggio
- cliccare sul tasto destro per attivare il menu` contestuale
- selezionare proprieta` (ultimo comando del menu` in basso)
- nella finestra visualizzata ci sono due schede, scegliere
la seconda: "Dettagli"
Ecco alcuni casi che si possono presentare
1) Bounced email (messaggio rimbalzato)
Puo` presentarsi cosi`:
+--------------------------------------------------------------------------+
|From: Mail Delivery Subsystem <MAILER-DAEMON@peacelink.it> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: Returned mail: Cannot send message within 2 days |
#X-Diagnostic: Mail to gamerro@comune.alpignano.to.it bounced 3 times #
#X-Diagnostic: Mail coming from a daemon, ignored #
#X-Diagnostic: Possible loopback problem #
|Date: Sun, 20 Jun 1999 15:22:27 +0200 |
|--------------------------------------------------------------------------|
| |
|The original message was received at Fri, 18 Jun 1999 15:18:36 +0200 |
|from list@localhost |
| |
| ----- The following addresses had permanent fatal errors ----- |
|gamerro@comune.alpignano.to.it |
| |
| ----- Transcript of session follows ----- |
|gamerro@comune.alpignano.to.it... Deferred: No route to host |
|Message could not be delivered for 2 days |
|Message will be deleted from queue |
| |
|[...] |
| |
+--------------------------------------------------------------------------+
I campi "X-Diagnostic", che evidenzio, indicano che quel messaggio e`
rimbalzato (tornato al mittente), tre volte. Viene evidenziato un possibile
"problema di loopback". Si tratta di una notifica. Ovvero il server avverte
l'owner di questo problema che decide cosa fare.
Dopo la quarta volta il server fa un unsubscribe automatico.
+--------------------------------------------------------------------------+
|From: Mail Delivery Subsystem <MAILER-DAEMON@peacelink.it> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: Returned mail: Cannot send message within 2 days |
#X-Diagnostic: Mail to gamerro@comune.alpignano.to.it bounced 5 times #
#X-Diagnostic: Bounces exceed threshold of 5 #
#X-Diagnostic: Removed: gamerro@comune.alpignano.to.it 32748 #
#X-Diagnostic: Mail coming from a daemon, ignored #
#X-Diagnostic: Possible loopback problem #
|Date: Mon, 21 Jun 1999 14:22:41 +0200 |
|--------------------------------------------------------------------------|
| |
|The original message was received at Sat, 19 Jun 1999 14:14:51 +0200 from |
|list@localhost |
| |
| ----- The following addresses had permanent fatal errors ----- |
|gamerro@comune.alpignano.to.it |
| |
| ----- Transcript of session follows ----- |
|gamerro@comune.alpignano.to.it... |
|Deferred: No route to host Message could not be delivered for 2 days |
|Message will be deleted from queue |
|Reporting-MTA: dns; peacelink.it Arrival-Date: Sat, 19 Jun 1999 14:14:51 +|
| |
|[...] |
| |
+--------------------------------------------------------------------------+
Questo margine e` utile perche' puo` capitare che il server di posta
elettronica
dell'utente non funzioni bene e se si tratta di un malfunzionamento momentaneo
quest'ultimo non ne subisce le immediate conseguenze (cancellazione
d'ufficio).
D'altra parte un margine di decisione importante delegato all'intelligenza
umana torna utile per considerazioni d'altro tipo. Se aveste avuto in lista
degli indirizzi "@ecn.org" quando il server di Isole Nella Rete fu
sequestrato, ovviamente questi indirizzi sarebbero risultati inesistenti ed
il server ve l'avrebbe notificato. Ma conoscendo la motivazione (non solo
tecnica) avreste potuto agire soprattutto col senno di poi (metterli da
parte, per poi "subscriverli" quando la situazione fosse tornata normale
!!). Ma lo smarlist non e` infallibile. Puo` capitare che per qualche motivo
attribuisca il malfunzionamento all'indirizzo sbagliato (che sceglie con
una certa probabilita` confrontando tutta la lista, ma non con assoluta
certezza)
e quindi cancellare uno perfettamente funzionante.
Un monitoraggio costante delle notifiche dello smartlist aiuta a capire se
tutto procede correttamente. Se da un giorno all'altro viene cancellato
l'indirizzo di un utente attivo in lista, o l'indirizzo "rimbalzato" non
coincide con le indicazioni dell'intestazione del messaggio deve intervenire
l'owner manualmente. Per esempio, in questo caso, l'indirizzo
"gavci@iperbole.bologna.it" si vede recapitare questa notifica di un
"unsubscribe" dovuto ad un indirizzo "@bnl.it" che smarlist, pero`, non riesce
ad individuare
Your mail address gavci@iperbole.bologna.it has been removed
from the pck-pace@peacelink.it mailinglist.
It generated an excessive amount of bounced mails.
Before sending in a subscription request to
pck-pace-request@peacelink.it again, please ensure that
this problem has been resolved. When in doubt, ask your system
administrator or send mail to "postmaster".
[...]
>Your message cannot be delivered to the following recipients:
>
> Recipient address: bf002775@w5.customer.bnl.it
> Original address: paolo.mora@w5.customer.bnl.it
> Reason: recipient reached disk quota
>
>
>--Boundary_(ID_E4tt8MDJJDvfYiuzIZd1ZA)
>Content-type: message/DELIVERY-STATUS
>
>Original-envelope-id: 0FHS00DCVH04NK@w5.customer.bnl.it
>Reporting-MTA: dns; w5.customer.bnl.it
>
>Action: failed
>Status: 5.0.0 (recipient reached disk quota)
>Original-recipient: rfc822;paolo.mora@w5.customer.bnl.it
>Final-recipient: rfc822;bf002775@w5.customer.bnl.it
In questi casi, un rapido sguardo con showdist (o un checkdist per tentativi,
in questo caso, su "paolo.mora@w5.customer.bnl.it"), fara` in modo che l'owner
si possa accertare di persona qual'e` l'indirizzo incriminato e agire
manualmente.
2) Qualcuno si e` cancellato dalla lista o l'ha sottoscritta
+--------------------------------------------------------------------------+
|From: "stefano e sabina" <stesabi@ulisse.it> |
|To: <pck-yugoslavia-request@peacelink.it> |
|Subject: |
|Date: Thu, 17 Jun 1999 10:43:30 +0200 |
|X-Diagnostic: Sent confirmation instructions |
|--------------^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^------------------------------|
|unsubscribe |
| |
+--------------------------------------------------------------------------+
Che e` lo stesso X-Diagnostic di quando qualcuno la sottoscrive (perche' in
entrambi i casi viene richiesto un messaggio di conferma)
+--------------------------------------------------------------------------+
|From: "Monica " <ka@login.it> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: subscribe |
|Date: Tue, 8 Jun 1999 21:11:08 +0200 |
|X-Diagnostic: Sent confirmation instructions |
|--------------^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^------------------------------|
| |
| |
+--------------------------------------------------------------------------+
Nel caso la sottoscrizione vada a buon fine, riceverete quest'altra notifica
+--------------------------------------------------------------------------+
|From: "Monica " <ka@login.it> |
|To: pck-yugoslavia-request@peacelink.it |
|Subject: subscribe ka@login.it |
|Date: Wed, 9 Jun 1999 09:03:46 +0200 |
|X-Diagnostic: Tried to confirm subscription |
|Subject: subscribe ka@login.it |
|X-Diagnostic: Added to the subscriber list |
|--------------^^^^^^^^^^^^^^^^^^^^^^^^^^^^--------------------------------|
| |
|---------- |
|>From: pck-yugoslavia-request@peacelink.it |
|>To: ka@login.it |
|>Subject: CONFIRM s060821110629799 |
|>Date: Mar, 8 giu 1999 19:11 |
|> |
| |
|> CONFIRM s060821110629799 |
| |
| |
| |
+--------------------------------------------------------------------------+
Ma puo` anche accadere che l'utente abbia sbagliato i tempi per il CONFIRM
o le
modalita`. In questo caso verra` inviato un messaggio di questo genere
all'owner
+--------------------------------------------------------------------------+
|From: "alberto" <alcoo@iol.it> |
|To: <pck-disagio-request@lists.peacelink.it> |
|Subject: CONFIRM s01720595723792 |
|Date: Mon, 21 Jun 1999 14:19:05 +0200 |
|X-Diagnostic: unsuccessful confirm, help sent |
|--------------^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^-----------------------------|
| |
+--------------------------------------------------------------------------+
In sostanza il gestore di lista avverte l'owner della mancata sottoscrizione o
disiscrizione e del fatto che ha mandato un aiuto. Puo` tornare utile
quando, in
caso di reiterato errore da parte dello stesso utente, l'owner puo` entrare in
contatto offrendo ulteriore assistenza.
3) Messaggi inviati senza essere iscritti
In questo caso verra` inviato all'owner un messaggio del tipo:
+--------------------------------------------------------------------------+
|From: Marco Trotta <mrta@bigfoot.com> |
|To: pck-yugoslavia@peacelink.it |
|Subject: |
|Date: Sun, 20 Jun 1999 21:19:01 +0200 |
|X-Diagnostic: Not on the accept list |
|--------------^^^^^^^^^^^^^^^^^^^^^^--------------------------------------|
|Prova senza sottoscrizione |
| |
+--------------------------------------------------------------------------+
All'utente verra` notificato l'errore con la procedura per iscriversi alla
lista.
--------------------------------------------------------------------
Informazioni a cura di PEACELINK
E' incoraggiata la libera diffusione (citando la fonte)
web: http://www.peacelink.it
e-mail: a.marescotti@peacelink.it
--------------------------------------------------------------------
Indirizzo di posta convenzionale:
PeaceLink, c.p.2009, 74100 Taranto (Italy)
--------------------------------------------------------------------
Per sostenere PeaceLink: ccp 13403746
intestato ad Associazione PeaceLink, via Galuppi 15, 74010 Statte
--------------------------------------------------------------------