Descrizione: ============ Cittadella/UX e` una BBS scritta per sistemi Un*x. Il progetto e` nato dopo diversi anni di gestione da parte degli autori della Emperor's BBS, che era basata su software Citadel/UX e si era evoluta con il tempo. L'esigenza di riscrivere il codice da zero e` emersa per avere una maggiore flessibilita` nella gestione delle sessioni e per incrementarne le possibilita` di sviluppo e la sua affidabilita`. Caratteristiche di Cittadella/UX: ================================= Quello che caratterizza maggiormente Cittadella/UX e` la simpatia dei suoi utenti. Provaci! Opzioni di linea di comando del client locale: ============================================== cittaclient [-hHlnpuv] [--host HOST] [--port PORT] [--username NICK] [--localhost] [--help] [--version] Opzioni -h, --host HOST Si collega al host HOST invece che a quello predefinito -l, --localhost Si collega al localhost invece che a quello predefinito -n, --no-banner Chiede a Cittadella/UX di non mostrare le schermate di login e logout. Utile come opzione anti-capo :-) -p, --port PORT Usa la porta PORT invece che quella predefinita -u, --username NICK Si collega come utente NICK e salta il login (Non la password) -H, --help Stampa un breve messaggio d'aiuto e esce. -v, --version Stampa la versione e esce File di configurazione ====================== Per chi usa il client presto verra` implementato un file di configurazione. Sistema di validazione automatica per gli utenti: ================================================= Ai nuovi utenti che si collegano per la prima volta viene richiesto di compilare una scheda di dati personali ('registration'). I dati non sono visibili agli altri utenti a meno che l'utente in questione non voglia pubblicarli. Di particolare importanza e` l'indirizzo di Email fornito, l'unico che viene verificato attraverso la procedura di convalidazione. Il server di Cittadella genera infatti automaticamente una chiave di convalidazione che viene poi inviata all'indirizzo di Email fornito durante la registrazione. La volta successiva che si collega, l'utente puo` procedere alla convalidazione inserendo la chiave, e accedere cosi` istantaneamente a tutti i servizi forniti dalla BBS (gli utenti non convalidati non possono lasciare messaggi nelle bacheche ne' usare gli eXpress message e la chat). La convalidazione deve avvenire nelle 48 ore successive al primo collegamento, altrimenti l'account viene cancellato. Nickname sgradevoli =================== Gli operatori di questo sistema si riservano il diritto di rifiutare l'accesso al sistema agli utenti che abbiano scelto uno pseudonimo che per un qualunque motivo possa risultare offensivo o inopportuno. Password: ========= La password e` una parola chiave nota solo all'utente necessaria per accedere al proprio account. Questo permette di difendere la privacy dell'utente, impedendo a persone estranee di accedere alle informazioni contenute nell'account. La password ti viene richiesta la prima volta che ti colleghi, subito dopo aver digitato il tuo nome. Viene richiesta due volte di seguito per assicurarsi che non hai fatto errori digitandola, in quanto non appare sullo schermo quando la immetti. E` buona regola scegliere una password che nessuno possa indovinare, formata da carattere alfanumerici (a..z,A..Z,0..9) e speciali (come !,@,#, etc.). Inoltre, se dovessi sospettare che qualcuno sia a conoscenza della tua password, cambiala immediatamente utilizzando il comando
. L'unica limitazione
nella scelta della password e` l'impossibilita` di utilizzare il carattere
'|'.
Se smarrisci la tua password, devi semplicemente inviare una Email ai
sysop, che chiederanno a Cittadella/UX di generare una nuova password
casuale per il tuo account. La nuova password ti verra` immediatamente
recapitata all'indirizzo Email che hai fornito al momento della
registrazione. La volta successiva che ti colleghi, abbi cura di cambiare
nuovamente la tua password.
Per gli Aide o i Sysop: il comando per creare una nuova passwd e`
<.aep>
GALATEO E REGOLE
================
Galateo
Quello che segue rappresenta alcuni punti generali di BBS etiquette.
Allo scopo di essere sempre il benvenuto su qualsiasi sistema vi capiti
di chiamare sarebbe conveniente che seguiste queste semplici regole.
1. Non lasciate in giro messaggi con scritto qualcosa tipo "Giusto per
testare se funziona". Da dove credete che arrivino tutti gli altri
messaggi se le cose non funzionano? Inoltre, non lasciate cose lamentose
del tipo "Perfavore lasciatemi un messaggio". Se mai c'e' una persona da
ignorare e` quella che prega qualcuno di lasciargli un messaggio. Se
volete ricevere messaggi cominciate leggendo quelli lasciati dagli altri
e partecipando alla conversazione che gia` esiste.
2. Non scrivete messaggi del tipo: "Questa room e` morta. Qualcuno scriva
qualcosa". Non portano nessun contributo e non rappresentano nulla di
costruttivo. Scrivete voi qualcosa di interessante, invece.
3. Non scrivete messaggi del tipo: "Nessuno usa questa room. Perche' non
la cancellate?". La regola che si segue e` questa: dal momento che lo
spazio non manca una room inutilizzata non comporta alcun fastidio. Al
contrario una room di cui si avverte la mancanza e` una room da installare
subito. Ci sono rooms che vengono utilizzate solo periodicamente, ma che
sarebbe sbagliato togliere perche' altrimenti certi argomenti non avrebbero
altro posto in cui essere discussi.
4. Non postate comenti ironici sulle opinioni o sui messaggi altrui. Non
contribuiscono al dibattito e sono piuttosto sgradevoli da leggere.
5. Infine, ma non per questo meno importante, ricordate sempre che siete
degli OSPITI su qualsiasi BBS decidiate di chiamare. Non pensate che
collegarvi sia uno dei vostri diritti fondamentali. Chiunque abbia messo in
piedi una BBS perche' fosse disponibile per tutti ha speso una grossa
quantita` di tempo (e talvolta soldi) per farlo. Mentre nessuno si aspetta
dei ringraziamenti resta comunque ragionevole aspettarsi un comportamento
corretto da parte degli utenti. Questo include seguire eventuali regole gli
operatori abbiano deciso di applicare senza discuterle. Ogni Sysop ha
un'idea propria di come vuole che il sistema funzioni. Non e` affar vostro
sapere perche' gli operatori vogliono gestire la BBS in quel modo. Quello
che potete fare e` scegliere di osservare le regole o scegliere un'altra BBS.
^boldRegole^stop
- Non e` consentito avere piu` di un'account a persona.
- Quando lasciate un messaggio in una room evitate di utilizzare nomi
e cognomi delle persone a cui vi riferite (a meno che non si tratti di
personaggi la cui identita` e` di dominio pubblico).
- Non fate al prompt del client, e poi
specificare il nome dell'utente che ci interessa.
CIttadella presenta come possibilita` di default il nome dell'utente
dell'ultimo messaggio che hai letto o dell'ultimo x-msg che hai ricevuto
(e che potrebbero averti incuriosito...).
Se il nome digitato corrisponde effettivamente a un utente di
Cittadella/UX, appaiono nell'ordine le seguenti informazioni:
1. Generali: Nome, livello di accesso, se e` collegato o meno.
2. Dati personali: sono i dati della registrazione: Nome reale, indirizzo,
numero di telefono, Email, URL della Home Page. Questi dati sono privati
e di default non appaiono. Sta all'utente decidere quali di questi vuole
rendere pubblici, attraverso la propria "configurazione dell'utente".
3. Numero di matricola dell'utente.
4. Dati riguardanti le connessioni: numero di chiamate, di Xmsg inviati,
di messaggi lasciati nei forum di discussione, data del primo
collegamento, tempo trascorso in collegamento e percentuale della vita
dal primo collegamento; data, ora e provenienza della chiamata
dell'ultimo collegamento effettuato (o di quallo in corso se l'utente
e` presente).
5. Profile personalizzato: questo e` un breve testo di presentazione che
ogni utente puo' allegare al profile, utilizzando il comando <.ep>
in modo comandi.
Lista degli amici:
==================
Nella lista degli amici (o friend-list) puoi inserire 20 altri utenti
di Cittadella/UX, con i quali comunichi piu` frequentemente, per
semplificare le operazioni. La lista degli amici e` personale e non e`
accessibile agli altri utenti. Essa viene utilizzata per le seguenti
operazioni:
1. Per riferirsi agli utenti nella lista, puoi abbreviare i loro nomi
digitando '&n' al posto del nome completo, dove 'n' sta per il numero
dell'utente come appare nella lista.
2. Comunicazione tramite X-msg: puoi rifiutare automaticamente gli
eXpress-message tranne quelli provenienti dai tuoi amici nella lista;
3. Notifiche di LogIn/LogOut: allo stesso modo, oltre alla possibilita` di
disabilitare le notifiche di tutti gli utenti che entrano ed escono dalla
BBS, e` possibile chiedere a Cittadella/UX di avvertirti solamente quando
e` un utente in lista che si collega o si sconnette dalla BBS.
Queste due ultime opzioni si modificano con i comandi <.tf> <.ec>, vedi
anche le sezioni sulla =Configurazione= e sui =Comandi di comunicazione=.
Per modificare la lista degli amici hai i comandi:
per vedere il profile, alla richiesta del nome dell'utente,
invece di digitarlo per esteso ne digiteremo le prime lettere, ad esempio
'Da'. Una successiva pressione del tasto per vedere il profile di un utente, il client
mi chiede il nome dell'utente che ci interessa).
Come viene detto in =Modi dei comandi=, ad ogni lettera e` associato piu`
di un comando, ad esempio se stai leggendo un messaggio (modo messaggi)
alla lettera .
Per chiarire il motivo della scelta della lettera,
alle volte verra` indicata anche una parola mnemonica associata al comando,
ad esempio
Modifica la Password
Questo comando permette all'utente di modificare la propria password.
Per farlo deve prima digitare la sua vecchia password, poi inserire due
volte la nuova password che vuole usare.
Lettura e Immissione di Messaggi - Movimenti in una singola Stanza
==================================================================
L'occupazione principale nella BBS e` la lettura e la ?scrittura?
dei messaggi, la maggior parte dei comandi e` dedicata a queste due
attivita`.
Questi comandi sono tutti in ==MODO MESSAGGI==
Alcuni di essi hanno dei sinonimi tra i dot commands.
< > successivo: Lo spazio legge il messaggio successivo. Se non ce ne sono
piu` entra in modo "Comandi".
BUG?: se stai leggendo al contrario e arrivi al primo messaggio
della stanza, continui a leggere lo stesso messaggio.
Leggi anche il suo significato in modo Comandi.
ncora Rilegge il messaggio appena letto (gain)
inverte Inverte la direzione di lettura; sia < > che Profile utente. Chiede il nome di un utente e mostra i suoi dati.
Di default mostra dati dell'autore dell'ultimo post letto
o dell'ultimo X-msg ricevuto. Altrimenti devi scrivere il nick
dell'utente che ti interessa (Vedi Tab Completion).
In un primo blocco appaiono i dati personali dell'utente se questo
li ha resi pubblici.
Un secondo blocco si trovano le informazioni sull'uso del sistema
(#chiamate, #post, #Xmg, data e ora del primo collegamento, etc.).
Infine c'e' la parte personalizzata del profile, che consiste in un
piccolo testo di presentazione fornito dall'utente. (vedi Profile,
e il comando <.ep>)
| <.> ide assword di un utente | uote di messaggi provenienti da rooms su invito quando
postate in una room pubblica.
(Tutto qui. E` pochino, no?)
Livelli di accesso degli utenti:
================================
Ad ogni utente viene associato un 'livello di accesso' che decide le
operazioni che puo' eseguire l'utente. I livelli di accesso sono i
seguenti:
Livello 0: Utente da buttare
Gli account di livello 0 vengono automaticamente eliminati dal
server quando fa le operazioni di crash_save_perfavore().
Non e` possibile connettersi alla BBS utilizzando questi account.
Livello 1: Utente Ospite
Sono gli utenti che si collegano come 'Ospite' o 'Guest'. Gli
utenti di questo livello non hanno a disposizione un vero e
proprio account, e` solo un modo per visitare la BBS senza
doversi registrare ufficialmente. Chiaramente le possibilita`
sono molto ridotte, in quanto l'Ospite non puo` comunicare
mediante Xmsg o chat, ma solamente leggere le room.
Livello 2: Utente non convalidato
Questo e` il livello dei nuovi utenti. Hanno un account ma non
possono usare Xmsg, chat o lasciare messaggi nelle room finche'
non passano la convalidazione (Vedi sezione 'Sistema di
convalidazione automatica'). Se non vengono convalidati entro 48
ore il loro account viene eliminato.
Livello 3: Utente rompiballe
Sono utenti convalidati, ma che si sono dimostrati particolarmente
indisciplinati dando fastidio ad altri utenti. A questi utenti
sono state temporaneamente disabilitati Xmgs, Chat e la
possibilita` di lasciare messaggi nelle room.
Livello 4: Utente convalidato
Questo e` il livello 'normale' degli utenti, al quale si accede
appena viene eseguita la convalidazione. Gli utenti di livello 4
possono usufruire di tutti i servizi offerti dalla BBS.
Alcuni di questi utenti possono aiutare i Room Aide a gestire
la propria room, e vengono definiti Room Helper.
Livello 5: Helping Hand (Da implementare)
Gli 'Helping Hand' sono utenti normali, disponibili pero` ad
aiutare gli utenti novizi ad usare la BBS. Gli utenti inesperti
possono chiedere un aiuto, che viene mandato automaticamente
da Cittadella a un Helping Hand, il quale risponde alle domande
dell'utente. Anche utenti di livello superiore al 5 possono
offrire questo servizio se lo desiderano.
Livello 6: Room Aide
Sono utenti che oltre ad accedere normalmente ai servizi della
BBS si impegnano a curare una o piu` room, moderandone le
discussioni. Possono modificare la configurazione di queste
room e hanno comandi particolari per gestire i messaggi presenti.
Livello 7: Floor Aide (da implementare)
Si occupano della gestione dei floor (quando verranno
implementati).
Livello 8: Aide
Sono degli utenti che hanno il compito di gestire il
funzionamento della BBS. Hanno privilegi di Room Aide su tutte
le room della BBS e possono inoltre gestire gli account degli
utenti.
Livello 10: System Operator (sysop)
Sono gli Aide che si occupano inoltre del funzionamento del
sistema. Hanno accesso ai sorgenti della BBS per correggere i
bachi, intervengono in caso di crash e si occupano della sicurezza.
Il livello 9 attualmente non e` definito.
Stato dell'utente:
==================
Il server associa agli utenti collegati uno stato, che descrive il tipo di
azione che stanno svolgendo. Lo stato viene visualizzato quando si digita il
comando
top, > help) linea 23/41 56% --
In questo caso hai a dispozione alcuni comandi per muoverti all'interno del
testo: < >pagina avanti
pagina indietro
finisci di leggere
>help
cambiare di posto due amici
scire e salvare la nuova configurazione
) di completare il nome di un utente o di una
room.
Ad esempio, per vedere il profile dell'utente DasKleinchen dopo aver
premuto
smette di leggere i messaggi e va in modo comandi
cita Copia nel buffer il messaggio che stai leggendo.
Leggi la sezione sui Buffer.
metti Smette di leggere i messaggi, rimane nella stessa stanza
ma in modo Comandi. (
uote). (Ovviamente in modo messaggi).
e tenuto in un buffer. Quando entrerai nell'editor esterno apparira` il
messaggio citato. (Ogni riga sara` preceduta da il segno di citazione
">").
In maniera simile, se stai usando l'editor esterno e vuoi postare (???) il
messaggio in un momento successivo, Cittadella ti permette di tenerlo in
memoria: esci dall'editor e invece di premere
alva, premi cancella il messaggio
uotato precedentemente, invece
-se hai sia un
uote attivi, alla prossima scrittura
di un post con editor esterno, apparira` nell'editor prima il testo
memorizzato con
uotati sia quelli in
uote sono associati anche i due comandi:
top, > help) linea 23/37 62% --
(Ovviamente i numeri varieranno).
Al prompt si hanno questi comandi a disposizione:
- < > vai avanti di una pagina
- top interrompi la lettura
- > sommario dei comandi disponibili
Il pager funziona anche per i profile e per le room info.
Comandi per postare messaggi di amministrazione:
================================================
<.> E` come e poi Statistiche sul server (sysop only)
Visualizza delle statistiche sull'uso del server che servono alla gestione
della BBS. Attualmente visualizza il numero di run del server, l'ultima
matricola assegnata a un utente, il numero totale di connessioni, numero
di login effettuati da ospiti, nuovi utenti e utenti gia' registrati,
numero di validazioni effettuate e numero di connessioni effettuate con
il client locale e con quello remoto, numero totale di X inviati e di
messaggi postati.
Shutdown del server (sysop only)
Permette di eseguire uno shutdown del server direttamente dal client.
Chiede quanti minuti deve attendere prima dello shutdown e notifica
agli utenti ogni minuto il tempo rimanente. Subito prima dello shutdown
tutti gli utenti vengono cacciati. Si consiglia di lasciare almeno 10
minuti di tempo agli utenti, per permettergli di terminare quello che
stanno facendo. Il server viene poi automaticamente riavviato dallo
script ./autorun .
Edit User (aide only)
Permette di modificare la registrazione e il livello di accesso di un
utente. Non e' possibile fornire a un utente un livello di accesso
superiore al proprio. L'operazione viene loggata.
wap rooms Per scambiare due stanze. (*?*)
------------------
Il comando <.ae> aide enter (ricordo: per Aide e Sysop/Room Aide) si divide
in:
<.aec>configurazione: Configurazione del sistema (*?*)
<.aei> room info: Inserisce le info della stanza, per RA.
(Vedi anche la sezione sulle Stanze)
<.aem>message: Inserisce un messaggio come Aide
(o Sysop)?????
<.aep>password: Se un utente si e` dimenticato
la password, questo comando ne
crea una nuova e gliela spedisce
per e-mail
<.aer> room: edita la configurazione di una room,
per RA. Per i dettagli, leggi la
sezione sui parametri delle stanze.
<.aeu>usr registration Modifica la registrazione di un utente
(Vedi??)
------------------------
Il comando <.ak> aide kill, solo per Aide e Sysop ha le seguenti funzioni:
<.akc> disconetti Disconnette un utente connesso.
<.ake> elimina Elimina definitivamente un utente dalla BBS
<.akr> room la stanza in cui si e` (e si finisce nel limbo?)
--------------------------
Il comando ide