 - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o -

 README della distribuzione bbs2pop
 I files presenti in questa distribuzione costituiscono gli script
 necessari alla realizzazione di un Point of Presence InterNet
 mediante una macchina Linux, come descritto nell'articolo
 A.Falaschi, "Da BBS a POP Internet: l'evoluzione possibile"
 presentato al LIME '98

 L'autore non assume alcuna responsabilita' per l'uso del codice allegato.

 Alcune soluzioni adottate possono senz'altro essere migliorate,
 e le procedure sono tuttora in fase di sperimentazione.

 Qualora il codice e gli esempi presentati risultino di qualche utilita',
 chiunque e' libero di distribuirlo nella presente forma di file compresso
 non modificato, oppure di inviare i miglioramenti effettuati
 all'autore, all'indirizzo alef@iperaudio.ddsn.org

 - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o - o -

I files presenti, sono distribuiti su diverse directories, in accordo
alla loro funzione. Qui di seguito una breve discussione sul loro
utilizzo.

Directory /home/httpd/account: Contiene i files con gli utenti
 abilitati e relative password, i crediti ed i gruppi di utenti.
 Ai files da utilizzare va tolto il suffisso .dist
 Le password di tutti gli esempi sono sempre pippo

users:		I nomi e le password degli utenti
credits:	I crediti residui
groups:		I gruppi a cui appartengono gli utenti

Directory /home/httpd/cgi-bin: qui sono presenti gli script tcl e bash
 che vengono invocati dall'utente per le seguenti funzioni:

accessdb.tcl:	Provvede ad aggiornare i crediti residui degli utenti
dialgo:		Invocato in bg da dial. Attende il collegamento internet e fa accounting.
mkwho:		Crea Il file che intesta il collegamento in atto all'utente
route:		Invocato dall'utente per conoscere lo stato del routing
waitmail:	Attende un periodo di tempo sufficiente a completare lo scambio di posta
dialoff:	Invocato dall'utente per scollegare il nostro host da internet
mq:		Invocato dall'utente per conoscere lo stato della coda di posta
dial:		Invocato dall'utente per collegare il nostro host ad internet 
join.tcl:	Gestisce una form di adesione e richiesta password
test-get:	Script generico che verifica le variabili di ambiente viste da un CGI 

Directory /home/httpd/html: Pagine offerte alla lettura degli utenti
join.html:	Form di richiesta account, che viene poi interpretata da join.tcl

Directory /usr/local/bin/: files eseguibili che puo' essere utile invocare anche
 in altre circostanze. E' richiesta la presenza della directory nel search PATH

dialout:	Richiama la procedura che si collega ad InterNet
getmail.exp:	Script Expect che invoca il comando ETRN presso l'MX remoto
iroff:		Client DDNS che notifica l'uscita da InterNet. Vedi www.ddns.org
irquery:	Script DDNS
nigth:          Script eseguito da Cron per scaricare la posta
dialstop:	Richiama la procedura che si scollega da InterNet
irfind:		Script DDNS
iron:		Script DDNS che notifica l'IP dinamico ricevuto dal provider
mail2news.pl:	Script Perl per inviare una email ad un newsgroup
startddns:	Eseguito in bg per mantenere attivo iron

Directory /etc/ppp: files di configurazione del protocollo PPP. Script che gestiscono
 le azioni conseguenti al collegamento ed alla disconnessione dal provider

options.pap:	Opzioni PPP valide con Mgetty ed autenticazione PAP
ip-up.local:	Svolge le azioni conseguenti al collegamento ad InterNet
ip-down:	Esegue le operazioni conseguenti alla sconnessione
pap-secrets:	Le password per autenticare le richieste di uso degli IP locali

Directory /etc/rc.d: Opzioni di configurazione al bootstrap

rc.local:	Configura le porte modem, attiva il masquerading ed il Proxy.
                Cose utili anche al sysop !

Directory /etc/httpd/conf: Contiene i files di configurazione di Apache

access.conf.dist: Sono presenti i comandi per far comparire la finestra
		di autentificazione in corrispondenza ai link dei CGI che 
		possono essere invocati solo da utenti abilitati

Directory /etc: Files di configurazione generale

hosts.allow:	Specifica i diritti di accesso ai servizi da parte degli utenti PPP
inittab:	Determina quale programma risppnde alla chiamate entranti
gettydefs:	Contiene i parametri per la posta di accesso e indica il progr. di login
conf.uugetty.ttyS2	Parametri per il funzionamento di uugetty
named.boot.sa:	Configura Named se eseguito off-line (o standalone)
named.boot.on:	Configura named se eseguito on-line (dopo il collegamento al provider)
resolv.conf:	Determina quale DNS utilizzare

Directory /var/named: Files di configurazione per named

named.ca:	Elenca i Root Server per il processo di risoluzione dei nomi
named.noca:	File vuoto per evitare l'attesa di timeouts quando off-line
named.ddns:	Risolve gli indirizzi del DDNS mentre si e' off-line
named.hosts:	Assegna i nomi validi nella nostra intranet
named.local:	Risolve il lookup inverso per l'indirizzo di loopback
named.rev:	Risolve il lookup inverso per gli indirizzi della intranet

