<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <HTML> <HEAD> <TITLE>SLRN+SLRNPULL Mini-Howto</TITLE> </HEAD> <BODY> <H1>SLRN+SLRNPULL Mini-Howto</H1> <H2>Alessandro Airaghi, <CODE>airaghi@gpa.it</CODE></H2>v0.5, 15 Dicembre 1998 <P><HR> <EM>Questo documento descrive come leggere off-line le news utilizzando i programmi SLRN e SLRNPULL con la distribuzione RedHat. Le informazioni qui contenute, comunque, sono probabilmente applicabili a qualsiasi distribuzione Linux. La lettura di questo documento presuppone una conoscenza *minima* della shell di Linux (il prompt dei comandi).</EM> <HR> <H2><A NAME="s1">1. Introduzione</A></H2> <P> <P>La tilde (~) indica la directory home di un utente (con tale termine si indica la directory in cui l'utente si trova subito dopo il login). Esempio: la frase "bisogna editare il file ~/.bash_profile", per l'utente alex diventa "bisogna editare il file /home/alex/.bash_profile". In pratica: "entra come utente alex ed edita il file .bash_profile".<BR> Tutti i comandi da scrivere nella shell di Linux sono indicati con un "#" o "$" prefisso al comando. <P>"#" è il simbolo che appare quando usate la shell come utente root. <P>"$" è il simbolo che appare quando usate la shell come utente normale. <P>Per esempio, "$ slrn" oppure "# slrn" indicano che dovete scrivere "slrn" al prompt dei comandi e poi premere [INVIO].<BR> Vediamo brevemente il funzionamento dei due programmi.<BR> SLRNPULL: si collega ad un news-server e scarica, da uno o più newsgroups, tutti gli articoli non ancora letti.<BR> SLRN: da solo, si collega ad un news-server e consente di poter leggere, uno alla volta, gli articoli di un dato newsgroup. Può anche essere utilizzato per leggere off-line gli articoli scaricati in precedenza da SLRNPULL. <P> <P> <H2><A NAME="s2">2. Dove procurarsi i programmi</A></H2> <P> <P>Sono necessari i seguenti tre pacchetti .rpm:<BR> <P>slang-1.2.2-3.i386.rpm<BR> slrn-0.9.5.4-2.i386.rpm<BR> slrn-pull-0.9.5.4-2.i386.rpm<BR> <P>Li potete trovare (per esempio) qui: <A HREF="ftp://sunsite.doc.ic.ac.uk/Mirrors/rawhide.redhat.com/i386/RedHat/RPMS">ftp://sunsite.doc.ic.ac.uk/Mirrors/rawhide.redhat.com/i386/RedHat/RPMS</A><P>Nel caso non siano più presenti su tale sito al momento della lettura di questo documento, potete effettuare una ricerca in rete usando uno dei tanti motori di ricerca. Per esempio, potete collegarvi tramite Netscape al seguente sito: <A HREF="http://ftpsearch.lycos.com">http://ftpsearch.lycos.com</A><P> <H2><A NAME="s3">3. Installazione dei programmi</A></H2> <P> <P>Effettuate il login come utente root.<BR> Installate i tre pacchetti .rpm dando i seguenti comandi:<BR> <P># rpm -ivh slang-1.2.2-2.i386.rpm<BR> # rpm -ivh slrn-0.9.5.3-2.i386.rpm<BR> # rpm -ivh slrn-pull-0.9.5.3-2.i386.rpm<BR> <P>Uscite come utente root e rientrate come utente normale. <P> <H2><A NAME="s4">4. Configurazione</A></H2> <P> <P>Prima di tutto, bisogna definire due variabili di ambiente, NNTPSERVER e SLRNPULL_ROOT. Basta editare il file ~/.bash_profile ed aggiungere le seguenti 3 linee: <P>NNTPSERVER=[news server]<BR> SLRNPULL_ROOT=~/slrnpull<BR> export NNTPSERVER SLRNPULL_ROOT<BR> <P>[news server]=news.tin.it oppure il server al quale potete accedere per leggere/scrivere le news. Per maggiori informazioni chiedete al vostro fornitore di accesso ad internet. <P>Per rendere effettive le modifiche, bisogna effettuare nuovamente il login:<BR> -premete [CTRL]+[d] per tornare al prompt di login<BR> -effettuate, ancora una volta, il login come utente normale. <P><B>NOTA</B>: se volete che le variabili NNTPSERVER e SLRNPULL_ROOT vengano definite a livello globale, valide per tutti gli utenti, le tre linee sopra riportate dovranno essere aggiunte al file /etc/profile. <P>Copiate il file /usr/lib/slrn/slrn.rc come ~/.slrnrc: <P>$ cp /usr/lib/slrn/slrn.rc .slrnrc <P>Editate quest'ultimo file, inserite i vostri dati ed assicuratevi che compaiano <B>TUTTE</B> le righe sotto riportate: <P> <BLOCKQUOTE><CODE> <HR> <PRE> % File ~/.slrnrc % Si fa riferimento ad un ipotetico abbonato di Tin, % Mario Rossi, avente il seguente indirizzo e-mail: mr@tin.it % Inserendo tutti i dati CORRETTAMENTE si è però soggetti al % fastidioso fenomeno dello spamming. Si legga a tal proposito % il paragrafo intitolato "Protezione dallo spamming". % Il campo "From:" viene generato dal programma SLRN così: % username@hostname (realname) hostname "tin.it" set username "mr" set realname "Mario Rossi" set replyto "mr@tin.it" set signature ".signature.slrn" % Filename where articles you have posted are archived. % Traduzione: nomi dei files dove vengono archiviati gli articoli % che sono stati inviati. % Sostituite ad [utente] il nome col quale effettuate il login. set save_posts "/home/[utente]/slrnpull/My_Posts" set save_replies "/home/[utente]/slrnpull/My_Replies" scorefile "slrnpull/Score" % Name of directory where decoded files are placed (relative to HOME) % Traduzione: nome della directory dove vengono posti i files binari % decodificati (relativamente alla directory home) set decode_directory "slrnpull/decoded" % Directory where all other files are saved. % Traduzione: directory dove vengono salvati tutti gli altri files. set save_directory "slrnpull/misc" % Directory where postponed articles are placed. (Make sure it exists) % Traduzione: directory dove vengono posti gli articoli scritti, ma che % si vogliono inviare al newsgroup in un secondo tempo. % Quando siete all' elenco dei newsgroups, premete [ESC]+[p] per % scegliere quali di questi articoli archiviati inviare. set postpone_directory "slrnpull/postponed" %--------------------------- % Local spool configuration %--------------------------- % Sostituite ad [utente] il nome col quale effettuate il login. set spool_inn_root "/home/[utente]/slrnpull" set spool_root "/home/[utente]/slrnpull/news" set spool_nov_root "/home/[utente]/slrnpull/news" set read_active 1 set use_slrnpull 1 set server_object "spool" </PRE> <HR> </CODE></BLOCKQUOTE> <P>Un consiglio: nel file <CODE>~</CODE>/.slrnrc modificate la variabile followup_string eliminando <%f> e/o %d di modo che la stringa risultante sia la più corta possibile. In caso contrario, il programma SLRN potrebbe chiedervi di ri-editare il vostro messaggio per "sistemare" una riga che è lunga più di 80 caratteri. Esempi (usando l'italiano): <P>set followup_string "In data %d, %r scriveva:" <P>set followup_string "%r scriveva:" <P>Oppure, fate in modo che compaia la seguente linea: <P>set reject_long_lines 0 <P><B>NOTA</B>: non è possibile sostituire /home/[utente] con ~ oppure con /home/$USER. Il programma non funzionerà. <P><B>NOTA</B>: il file .slrnrc in realtà contiene molte altre istruzioni che consentono una maggiore personalizzazione del programma. Quelle da me elencate sopra sono le minime indispensabili, affinchè tutto funzioni correttamente. <P>In questo modo il programma SLRN non si collega al server delle news "news.tin.it" (o quello da voi scelto) per leggere le news bensì utilizza quelle scaricate in precedenza dal programma SLRNPULL. <P>Create le seguenti directory:<BR> <P>$ mkdir slrnpull<BR> $ mkdir slrnpull/postponed<BR> $ mkdir slrnpull/decoded<BR> $ mkdir slrnpull/misc<BR> <P>Copiate il file /var/spool/slrnpull/slrnpull.conf in ~/slrnpull: <P>$ cp /var/spool/slrnpull/slrnpull.conf slrnpull <P>Editate quest' ultimo file: mettete un cancelletto (#) all' inizio di ogni linea ed aggiungete la seguente linea:<BR> <P>it.comp.linux 0 14<BR> <P> <P>0 = scarica tutti gli articoli<BR> 14 = gli articoli "durano" 14 giorni sull' HD prima di essere rimossi.<BR> <P>Scrivete questo script della shell, ~/slrnpull.sh: <BLOCKQUOTE><CODE> <HR> <PRE> #!/bin/sh # Questo semplicissimo script è da utilizzarsi giornalmente # per collegarsi al news server e scaricare gli articoli per una # successiva lettura off-line. # Ovviamente dev'essere attiva la connessione ad internet prima che # venga lanciato questo script. umask 022 # Prima di scaricare dal news server degli articoli, cancelliamo # tra gli articoli gia' scaricati, quelli divenuti ormai vecchi. # Per quest' operazione non è necessario essere collegati ad # internet. slrnpull --expire # Colleghiamoci al news server e scarichiamo i nuovi articoli slrnpull </PRE> <HR> </CODE></BLOCKQUOTE> Rendetelo eseguibile tramite il seguente comando:<BR> <P>$ chmod 744 slrnpull.sh<BR> <P> <H2><A NAME="s5">5. Download delle news</A></H2> <P> <P>Dopo tanto editare e configurare potete finalmente collegarvi ad ad internet. Beh...prima o poi era da fare :) <P>Eseguite lo script "slrnpull.sh": <P>$ slrnpull.sh <P>Verranno scaricati sia i titoli dei messaggi sia i relativi articoli in essi contenuti. <P><B>NOTA</B>: la prima volta sarà necessario scaricare migliaia di articoli. La cosa potrebbe richiedere una quantità di tempo non trascurabile (a me è occorsa 1h con un modem da 28.800). Se possibile, non effettuate tale operazione durante le ore di punta. Ora e giorno consigliati: le 04.00 del 30 Febbraio :) <P>Una volta che il programma SLRNPULL ha terminato il suo compito, potete scollegarvi da internet e procedere alla lettura delle news usando il programma SLRN. <P> <P> <H2><A NAME="s6">6. Lettura delle news</A></H2> <P> <P>E' un'operazione semplicissima, basta digitare il seguente comando: <P>$ slrn -create <P><B>NOTA</B>: dovete usare l'opzione -create SOLAMENTE LA PRIMA VOLTA che lanciate il programma SLRN. Le volte successive il comando sarà semplicemente: $ slrn <P><B>NOTA</B>: come per la shell di Linux, anche il programma SLRN fa distinzione tra lettere maiuscole e minuscole. IL COMANDO OTTENUTO PREMENDO IL TASTO [L] E' DIVERSO DA QUELLO OTTENUTO PREMENDO IL TASTO [l]. <P>Per vedere gli articoli così faticosamente scaricati: <UL> <LI>premete [s] per sottoscrivere (subscribe) it.comp.linux, il vostro newsgroup preferito.In tal modo il newsgroup it.comp.linux apparirà tutte le volte che usate SLRN. In caso contrario dovete premere [L] e scrivere "it.comp.linux" tutte le volte che usate SLRN. Quest'ultima operazione è da eseguirsi anche quando eseguite lo script slrnpull.sh dopo aver modificato il file ~/slrnpull/slrnpull.conf aggiungendo nuovi newsgroups da scaricare. </LI> <LI>premete [INVIO] per vedere elencati SOLAMENTE gli articoli NON LETTI </LI> <LI>premete [ESC], [1], [INVIO] per vedere elencati TUTTI gli articoli</LI> </UL> <P>Per avere un elenco dei comandi, premete [?]. I più utili sono i seguenti: <P><B>Ovunque vi troviate</B> <P>[CTRL]+[G] : annulla un' operazione <P><B>Elenco dei newsgroups</B> <P>[l] : elenca i newsgroups sottoscritti ma che contengono solamente articoli già letti (tali newsgroups hanno uno 0 a sinistra del nome) <P><B>Elenco degli articoli</B> <P>[ESC]+[s] : per ordinare (to sort) gli articoli secondo diversi criteri<BR> [ESC]+[t] : espande/collassa un thread<BR> [h] : dopo che è stato letto un articolo, serve per tornare all' elenco degli articoli a pieno schermo<BR> [ESC]+[<] : salta al primo articolo<BR> [ESC]+[>] : salta all' ultimo articolo<BR> [a] : ricerca (in avanti) una data stringa nel campo "Author"<BR> [A] : ricerca (all' indietro) una data stringa nel campo "Author"<BR> [s] : ricerca (in avanti) una data stringa nel campo "Subject"<BR> [S] : ricerca (all' indietro) una data stringa nel campo "Subject"<BR> [o] : salva un articolo su HD nel file specificato dall' utente. Se il file esiste, l'articolo viene aggiunto alla fine del file (operazione nota come "append").<BR> [.] : ripete l'ultimo comando dato <P><B>Lettura degli articoli</B> <P>[t] : mostra/nasconde gli headers meno importanti<BR> [T] : mostra/nasconde le linee che costituiscono citazioni di altri articoli (in inglese: quoted lines)<BR> [TAB] : scavalca le "quoted lines"<BR> [b] : indietro di una pagina<BR> [SPAZIO] : avanti di una pagina<BR> [INVIO] : avanti di una riga<BR> [ESC]+[FRECCIA SU] : indietro di una riga<BR> [ESC]+[FRECCIA GIU'] : avanti di una riga<BR> <P><B>NOTA</B>: Per default vengono mostrati solo i seguenti headers: "From:" "Newsgroups:" e "Subject:". Se volete modificare tale situazione editate la variabile "visible_headers" in ~/.slrnrc.<BR> Esempi: <P>visible_headers "X-,From:" per visualizzare, di default, tutti gli headers che iniziano con "X-" più l' header "From:"<BR> <P>visible_headers "" per non visualizzare, di default, nessun header <P> <P> <H2><A NAME="s7">7. Invio delle news</A></H2> <P> <P>Per inviare un nuovo articolo fate partire il programma SLRN <P>$ slrn <P>Vi comparirà l'elenco dei newsgroups. Ricordo che se non vedete nessun newsgroup ma solo il puntatore "->" : <P>- non avete sottoscritto (subscribe) nessun newsgroup. Premete [L] e scrivete il nome da sottoscrivere.<BR> - tutti i newsgroups sottoscritti contengono articoli letti. Premete [l]. <P>Premete [p] e [y] poi scrivete il nome del newsgroup al quale volete inviare il vostro articolo. Per default si dovrà scriverlo usando l'editor vi. <P><B>NOTA</B>: se volete utilizzare un editor diverso, modificate nel file ~/.slrnrc la linea "set editor_command". <P>Uscite dall' editor, vi verrà posta la seguente domanda:<BR> <B>Post the message? Yes, No, Edit, poStpone</B> <P>Si possono presentare i seguenti 3 casi:<BR> <B>A)</B> nel file ~/.slrnrc è presente la linea "set use_slrnpull 1". Premete [y] oppure [Y]. SLRN non invia al news server l'articolo bensì lo copia nella directory ~/slrnpull/out.going con un nome simile a questo: X913482683-607-1.[utente]<BR> TUTTI i files che si trovano in questa directory verranno automaticamente inviati al news server dal programma SLRNPULL (contenuto in slrnpull.sh) prima di scaricare i nuovi articoli.<BR> E' il metodo consigliato. <P><B>B)</B> nel file ~/.slrnrc NON è presente la linea "set use_slrnpull 1". Se premete [y] o [Y] l'articolo verrà inviato al news server. E' NECESSARIO, pertanto, avere attiva la connessione ad internet. <P><B>C)</B> Indipendentemente dal contenuto del file ~/.slrnrc, premete [s] o [S]. L'articolo verrà salvato in un file, dovete fornire un nome. Successivamente, tale articolo potrà essere inviato (al news server o alla directory ~/slrnpull/out.going) premendo i tasti [ESC]+[p] al menù dei newsgroups. <P>Se volete rispondere ad un articolo che state leggendo, premete [f]. Le regole per l'invio del vostro messaggio sono identiche ai 3 casi sopra elencati. <P> <P> <H2><A NAME="s8">8. Scoring</A></H2> <P> <P>Il programma SLRN consente di assegnare un punteggio (score) ad ogni articolo che è stato scaricato, in base alle regole presenti nel file ~/slrnpull/Score. Una volta entrati in un newsgroup, SLRN automaticamente ordinerà gli articoli a partire da quello con punteggio più alto verso quello con punteggio più basso.<BR> Il formato del file ~/slrnpull/Score non è complicato. Tale file consiste di sezioni, ognuna delle quali contiene le regole che devono essere applicate ad uno o più newsgroups per calcolare i punteggi da attribuire a ciascun articolo. Ogni sezione è identificata dalle parentesi quadre []. Per esempio, [it.comp.linux.*] indica l'inizio della sezione che definirà le regole per tutti i newsgroups che iniziano con i caratteri "it.comp.linux". Cioè per i seguenti gruppi :<BR> <P>it.comp.linux<BR> it.comp.linux.setup<BR> it.comp.linux.annunci<BR> <P>ecc ecc <P>Seguono ora alcuni esempi.<BR> <UL> <LI>Volete assegnare un punteggio pari a 10 a tutti gli articoli del newsgroup it.comp.linux i cui titoli (Subject) contengono la parola "redhat", questo è ciò che dovete scrivere nel file ~/slrnpull/Score : <BLOCKQUOTE><CODE> <PRE> [it.comp.linux] Score: 10 Subject: redhat </PRE> </CODE></BLOCKQUOTE> </LI> <LI>Volete assegnare un punteggio pari a 20 a tutti gli articoli del newsgroup it.comp.linux.annunci i cui titoli (Subject) contengono la parola "aiuto" E l'autore è Mario Rossi : <BLOCKQUOTE><CODE> <PRE> [it.comp.linux.annunci] Score: 20 Subject: aiuto From: Mario Rossi </PRE> </CODE></BLOCKQUOTE> </LI> <LI>Volete assegnare un punteggio pari a 20 a tutti gli articoli del newsgroup it.comp.linux.annunci i cui titoli (Subject) contengono la parola "aiuto" OPPURE l'autore è Mario Rossi (notare Score::) : <BLOCKQUOTE><CODE> <PRE> [it.comp.linux.annunci] Score:: 20 Subject: aiuto From: Mario Rossi </PRE> </CODE></BLOCKQUOTE> </LI> <LI>Volete assegnare un punteggio pari a 30 a tutti gli articoli dei newsgroups it.comp.linux.* che hanno un campo From: contenente la stringa "mr@tin.it" (notare la trasformazione di "." in "\.") : <BLOCKQUOTE><CODE> <PRE> [it.comp.linux.*] Score: 30 From: mr@tin\.it </PRE> </CODE></BLOCKQUOTE> </LI> <LI>Volete assegnare un punteggio di 40 a tutti gli articoli del newsgroup it.comp.linux, da voi scritti, appartenenti ad un qualsiasi thread: <BLOCKQUOTE><CODE> <PRE> [it.comp.linux] Score: 40 From: ( mettete ciò che compare nel VOSTRO campo From: )<newline> References: . </PRE> </CODE></BLOCKQUOTE> </LI> </UL> <P>Con quest'ultima regola di assegnazione dei punteggi vi sarà senz'altro più semplice poter seguire le risposte ai vostri messaggi: compariranno per primi tutti i thread che contengono risposte a vostri articoli.<BR> Per maggiori informazioni si veda il file /usr/doc/slrn-0.9.5.4/SCORE_FAQ <P> <P> <H2><A NAME="s9">9. Protezione dallo "spamming"</A></H2> <P> <P>Inserendo correttamente i vostri dati nel file ~/.slrnrc tutti coloro che leggeranno il vostro messaggio sapranno qual è il vostro indirizzo e-mail. Potrete così ricevere, in privato, le risposte ai vostri articoli da parte di altri frequentatori del newsgroup. Esistono però programmi appositi che vengono fatti entrare in un newsgroup per ricavare, dagli articoli inviati, gli indirizzi e-mail. Noto il vostro indirizzo e-mail è possibile inviarvi (in automatico) di tutto un po': proposte di vacanze in Papuasia, vendite di PC, consulenze informatiche, numeri del lotto, ... Questa poco civile pratica è nota come "spamming" (ho una mia versione in italiano ma è improponibile). Se volete evitare di trovare la vostra casella di posta intasata da messaggi non desiderati, potete alterare i vostri dati ed usare il file ~/.signature.slrn<BR> Sempre facendo riferimento all' ipotetico abbonato di Tin Mario Rossi, potete editare il file ~/.slrnrc così: <P>hostname "tin.it"<BR> set username "NOSPAM"<BR> set realname "Mario Rossi"<BR> set replyto "NOSPAM@tin.it"<BR> set signature ".signature.slrn"<BR> <P>ed editare il file ~/.signature.slrn (per esempio) in modo che compaia la seguente frase: Per ottenere il mio effettivo indirizzo e-mail, sostituisci a NOSPAM il mio cognome. <P>In tal modo, solo chi avrà <B>realmente</B> necessità o voglia, vi contatterà tramite e-mail. <P> <P> <H2><A NAME="s10">10. Autore dei programmi</A></H2> <P> <P>L'autore dei programmi SLRN e SLRNPULL è: <BR> John E. Davis <A HREF="mailto:davis@space.mit.edu">davis@space.mit.edu</A> <BR> URL: <A HREF="http://space.mit.edu/~davis">http://space.mit.edu/~davis</A> <BR> <P>L'ultima versione del programma SLRN è disponibile, tramite anonymous ftp, presso: <BR> <A HREF="ftp://space.mit.edu/pub/davis/slrn/">ftp://space.mit.edu/pub/davis/slrn/</A><P>oppure, presso i seguenti mirror: <BR> <A HREF="ftp://ftp.uni-stuttgart.de:/pub/unix/misc/slang/">ftp://ftp.uni-stuttgart.de:/pub/unix/misc/slang/</A> <BR> <A HREF="ftp://ftp.fu-berlin.de/pub/unix/news/slrn/">ftp://ftp.fu-berlin.de/pub/unix/news/slrn/</A> <BR> <A HREF="ftp://ftp.ntua.gr/pub/lang/slang/">ftp://ftp.ntua.gr/pub/lang/slang/</A> <BR> <P> </BODY> </HTML>
