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 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 ho tramite un simbolo, nel modo seguente '.' l'utente e` idle da piu' di un minuto '+' l'utente sta editando un testo '&' l'utente sta comunicando (Xmsg, Chat o Broadcast) '^' l'utente sta compilando/modificando la configurazione '_' l'utente sta compilando/modificando la registrazione '#' l'utente sta editando un file (profile o info) '$' l'utente e' entrato nella subshell (nome) Il nome dell'utente e' tra parentesi se ha lockato il terminale Per il significato della maggior parte di queste parole vai a leggere il file corrispondente. (e quindi servirebbe un piccolo file per $ e per %). Modi di lettura =============== (QUESTA PARTE INIZIALE MI FA SCHIFO... VA CAMBIATA!). In Cittadella puoi essere in diversi Modi. Ovviamente c'e` il Modo editor, quando stai usando il tuo editor (o l'editor di linea della BBS), il modo scelta, che ti si presenta quando hai davanti una scelta limitata a tre o quattro opzioni tra cui devi decidere, ad esempio dopo aver scritto un messaggio o quando devi scegliere quale parte della cofigurazione vuoi modificare. E` necessario distinugere i modi perche' in Cittadella ad ogni comando e` associata una lettera, ma ad ogni lettera e` pero` associato piu` di un comando, a seconda del modo in cui ci si trova. Puoi facilmente distinguere i modi dal prompt che Cittadella ti presenta (se non hai disabilitato i prompt, ovviamente). Mettiamo qui i 3 modi principali; per gli altri la scelta tra le possibilita` si ottiene premendo . [[ Ci vorrebbe anche una parte qui sull'editor di linea per gli x-mgs e chat]] -----Modo comandi------ Il modo comandi e` quello in cui ti trovi se sei in una stanza ma non stai scorrendo i messaggi. E` il modo in cui ti trovi appena sei entrato in Cittadella. (Per i pedanti, appena hai premuto un tasto al prompt ) In questo caso Cittadella mostra il nome della stanza in cui ti trovi seguito immediatamente da ">", ad esempio Cinema> -----modo Messaggi----- Mentre scorri i messaggi di una stanza ti trovi nel modo messaggi, il prompt di Cittadella indica, oltre al nome della stanza, anche il numero del messaggio che stai leggendo e quanti messaggi mancano alla fine, ad esempio: Chiacchiere> msg #852 (Da leggere: 3)] -> -----modo Lettura----- Sei nel modo lettura se il messaggio che stai leggendo eccede il numero di righe dello schermo Cittadella mostra una riga simile a: -- more (, , top, help) linea 23/41 56% -- In questo caso hai a dispozione alcuni comandi per muoverti all'interno del testo: < >pagina avanti pagina indietro riga avanti riga indietro finisci di leggere help rivisualizza tutto. Inoltre puo` capitare che ti si presenti un prompt che ti chiede che azione vuoi fare dopo aver scritto un messaggio, ad esempio appena hai finito di editare un testo. In ciascuno di questi modi premendo il tasto o si ottiene una lista dei comandi disponibili seguiti da una breve descrizione. Oltre allo stato dell'utente ci sono gli stati in cui si puo` trovare il Vedremo piu` avanti che ai vari comandi della bbs e` associato uno (o piu`) lettere. Prima pero` di vedere quali sono i comandi di Cittadella, bisogna imparare a distinguere i diversi modi(?) in cui ci si trova. Ovviamente tutti sanno dire se in quel momento stanno scrivendo un messaggio (modo editing), o un X-message (modo X). Quando pero` non si stanno facendo queste cose si puo` essere: 1) Modo Stanza:al prompt di una stanza: non si stanno leggendo messaggi e Cittadella scrive Stanza) (es Cinema>) 2) Modo Messaggi:al prompt dei messaggi: si stanno leggendo i messaggi di una stanza, e si e` letto tutto un messaggio; Cittadella scrive il nome della stanza, il numero del messaggio e quanti messaggi mancano alla fine [Chiacchiere> msg #852 (Da leggere: 3)] -> 3) Modo Lettura:Si sta leggendo un messaggio che e` troppo lungo per stare sullo schermo. Compare in fondo la scritta ( ) In ciascuno di questi modi premendo il tasto o si ottiene una lista dei comandi disponibili seguiti da una breve descrizione. Qui di seguito vengono elencati tutti i comandi disponibili, divisi per modo e per tipo. Profile: ======== Il 'profile' e` una breve descrizione degli utenti. Per avere informazioni su un utente, e` sufficiente digitare

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: o <.fe> in modo comandi Ti viene presentata una lista di amici e una serie di comandi disponibili: ggiungere un amico imuoverlo dall'elenco cambiare di posto due amici scire e salvare la nuova configurazione asciare tutto come era prima ed uscire Inoltre puoi vedere la lista dei tuoi amici con il comando <.fe> in modo comandi. Gestione dell'idle: =================== L'idle e` il periodo di tempo in cui l'utente e` rimasto inattivo (e il server non ha ricevuto segnali da parte del client). Cittadella/UX contabilizza il tempo di idle di ogni utente e se questo supera un minuto, lo rende noto mettendo un punto accanto al nick dell'utente nella lista degli utenti connessi , e scrivendo il tempo di idle nel profile dell'utente ozioso. Inoltre, per minimizzare il carico della rete e del server, se l'utente e` idle per un lungo tempo (attualmente 15 minuti) viene avvertito due volte e successivamente viene chiusa la sua connessione se non risponde agli avvertimenti. Configurazione dell'utente: =========================== L'utente puo` configurare il comportamento di Cittadella; durante la registrazione si introduce la propria configurazione, successivamente la si puo` modificare con il dot command (in modo comandi): <.ec> Ci sono 5 sezioni differenti: 1. Variabili generiche 2. Apparenza 3. Comunicazione (Xmsg e Notifiche) 4. Scansione room e lettura messaggi 5. Dati personali visibili a tutti Cittadella presenta anche l'opzione 0 per modificare tutte le sezioni. In ogni caso alla fine viene chiesto se si vogliono confermare od abbandonare le modifiche fatte. 1) Variabili generiche si chiede - Utente esperto: (modificabile anche con , modo Comandi). Se si risponde no, ad ogni comando eseguito viene presentata una schermata che riporta il significato dei comandi principali - Uso dell'editor esterno: e` possibile solo col client. Se si risponde si` si usa il proprio editor preferito in maniera locale, altrimenti si usa l'editor di linea della bbs (vedi Editor di linea) - Uso dell'editor esterno per X: discorso uguale al precedente. E` l'editor da usare nel caso si sia sotto X. 2) Apparenza - Niente prompt dopo i messaggi: non so - Usa prompt che spariscono:idem - Pausa ad ogni schermata: chiede se la visualizzazione del messaggio debba fare una pausa se la lunghezza supera le linee dello schermo - Beep abilitato: l'altra opzione anti-boss. Se rispondi no Cittadellla non fara` mai rumori molesti. 3) Comunicazione - Accetto X-mgs: be'... si spiega da sola. L'unica cosa di cui tener conto e` il seguente - Accetto X-msg da amici: Se il precedente Accetto X-msgf e` stato disabilitato, permette di ricevere messaggi (solo) dagli amici (Vedi Amici) - Accetto X mentre leggo post: Se non vuoi essere disturbato mentre leggi i messaggi rispondi no. Cittadella terra` da parte il messaggio (o i messaggi) per quando avrai finito (??? non so cosa vuol dire. Mentre leggi un messaggio o mentre sei in modo Messaggi??) - Follow-up automatico: Se rispondi si`, appena ricevi un messaggio entri nello speditore di messaggi-x, ovviamente il destinatario sara` chi ti ha mandato il messaggio (vedi anche il comando )> - Notifica l'arrivo dei mail: Ti avvisa appena ti arrivano mail. - Notifica i login/logout: Ti avvisa quando entra o esce un utente. 4) Scansione Room e lettura messaggi - Ultimo letto prima dei nuovi messaggi: Ti permette di vedere "dove eravamo arrivati". Se rispondi no parti subito dai nuovi messaggi. - Ristampa un messaggio dopo un Reply (boh devo provarlo) - Notifica un nuovo post nella Room: se sei in una stanza e vi arriva un nuovo messaggio ti avvisa (e` cosi`?) 5) Dati personali visibili a tutti: Ti chiede, di ciascuno dei seguenti campi, se deve essere visibile o meno agli altri utenti -Nome e Cognome -Indirizzo -Telefono -Email -Home page -Sesso -Profilo personalizzato Tab Completion: =============== Visto che siamo tutti dei pigroni e che c'e` gente che si sceglie dei nomi complicatissimi di cui azzeccheremmo la corretta ortografia solo all'undicesimo tentativo, e` stata implementata la 'tab completion', che permette mediante una semplice pressione del tasto (quello un po' piu` lungo a sinistra del tasto ) di completare il nome di un utente o di una room. Ad esempio, per vedere il profile dell'utente DasKleinchen dopo aver premuto

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 completa il nome e appare sullo schermo il nome 'DasKleinchen'. Se piu' di un utente ha il nome che inizia con le lettere 'Da', successive pressioni del tasto permettono di scorrerli tutti nell'ordine. I comandi che prevedono la presenza dell'utente per essere eseguiti, come per mandare un Xmsg ad esempio, eseguono il completamento considerando solo i nomi degli utenti collegati in quel momento. Il puo` essere usato per completare il nome di una room, esattamente nello stesso modo. Il completamento viene effettuato in questo caso solo con le room alle quali abbiamo l'accesso e che non sono state zappate. La 'tab completion' non distingue tra maiuscole e minuscole: ad esempio completare 'DAS' o 'dAs' porta allo stesso risultato. Comandi di comunicazione ========================= Permettono di comunicare con gli altri utenti in modo rapido ma volatile. I messaggi espressi vengono mandati ad un singolo utente, la chat premette agli utenti collegati alla chat di chiacchierare. In entrambe i casi i messaggi che si ricevono, che possono essere lunghi al piu` 4 righe vengono visualizzati sullo schermo. [[ma non sono memorizzati da nessuna parte (---modifica per il client!?---).]] Per inviare un messaggio si usa il comando per gli x-message e per la chat, negli x-msg viene anche chiesto il nome del destinatario, e poi deve essere inserito il testo, che termina con una riga vuota o con il massimo di righe disponibile. Se non si vuole piu` mandare il messaggio e` sufficiente scrivere all'inizio di una riga la scritta ABORT (da sola) e premere invio. Se per caso non si vuole piu` mandare il messaggio =Chat --- questi comandi funzionano solo in modo COMANDI Ci sono piu` canali di chat, ciascuno indipendente (per ora 2 canali pubblici piu` uno riservato ai Sysop). Quando si e` collegati ad un canale si ricevono, accompagnati da un beep, i messaggi degli altri utenti e si e` avvisati quando un utente si collega o esce dalla chat. Il beep puo` essere disabilitato, leggi la sezione sulla configurazione. I comandi sono (Solo modo COMANDI): Ascolta un canale di chat. Viene richiesto il numero del canale. Se sei gia` collegato ad un'altro canale ti chiede conferma prima di cambiarlo. Cittadella avverte gli utenti gia` collegati che ti sei connesso. Abbandona la chat a cui sei collegato. Avvisa gli altri utenti collegati al canale che sei uscito. Elenca gli utenti nelle chat (anche in Syschat????). Puoi anche non essere collegato ad alcuna chat. E ovviamente Manda un breve messaggio agli altri utenti collegati al tuo stesso canale. Ti ricordo che puoi mandare fino a 4 linee, per cancellare un messaggio basta scrivere ABORT (maiuscolo!) da solo all'inizio di una linea e andare a capo. =X-messages ---Tutti i comandi funzionano sia in modo Comandi che in modo Messaggi manda un x-msg ad un utente. Ti chiede il nome dell'utente destinatario del Xmsg, poi aspetta un breve testo (4 righe max.) da inviare all'utente. Premendo in una riga vuota si termina il messaggio, altrimenti il messaggio finisce quando viene conclusa la quarta riga del testo. Il messaggio viene poi immediatamente inviato al destinatario, che lo riceve con un *beep*. Se quest'ultimo e' occupato, il messaggio viene mantenuto in memoria, e viene poi mostrato al destinatario appena e' in grado di leggerlo. In questo caso, l'utente che ha inviato l'Xmsg viene avvertito che il destinatario leggera il messaggio appena possibile. Se il messaggio e' vuoto, l'Xmsg viene abortito. Se vuoi interrompere l'invio di un messaggio scrivi ABORT all'inizio di i una linea vuota e premi invio risponde all'x-message: e` come , ma il destinatario e` automaticamente l'ultimo utente che ti ha mandato un x-msg. Inoltre ci sono i seguenti comandi (solo in modo COMANDI) <.tu> toggle follow-up. Inverte l'opzione follow-up. Se attivata entra nel sender di X-msg appena se ne riceve uno. <.ec> Nella configurazione, 3^ sezione (Comunicazione) si puo` decidere se ricevere X-msg, e se solo da amici o da tutti. STANZE ====== Le stanze, o Room, solo il cuore della BBS. Nelle stanze si leggono i messaggi e si risponde. La maggior parte dei comandi della BBS serve a muoversi all'interno d'una stanza o tra stanze diverse. Ricordiamo qui solo quelli indispensabili < > o : legge il messaggio successivo, se i messaggi sono finiti prima entri in modo comandi, e poi passa alla stanza successiva conosciuta che ha ancora messaggi da leggere.(Se non ce ne sono va in Lobby). <-> Torna indietro di n (un numero che Cittadella ti chiede) messaggi smette di leggere i messaggi e va in modo comandi In modo comandi, salta in un altra stanza Elenca le stanze conosciute Se l'argomento di una stanza non ti interessa, puoi toglierla dall'elenco delle stanze che conosci. Questo vuol dire che non ci capiterai dentro per caso se ci sono messaggi nuovi. In gergo questa operazione si chiama zappare, e si ottiene semplicemente con il comando in modo COMANDI. Se improvvisamente decidi che la stanza ti interessa di nuovo, basta un con il nome completo e torna tra le stanze conosciute (questo non e` vero per le stanze ad invito). Se invece pensi che debba esserci una stanza che invece non e` presente, metti la tua proposta in (come si chiama?). Se c'e` un interesse comune degli utenti (o quando?) la stanza verra` creata, e magari puoi diventarne Room Aide. Le stanze ad invito sono stanze non conosciute dall'utente che si e` appena registrato, a differenza delle stanze zappate pero` non ci si puo` (???potrebbe???BUG) entrare con un ump. I motivi della loro esistenza sono vari, principalmente si tratta di stanze in cui si discutono argomenti che potrebbero urtare la sensibilita` di un nuovo utente. Per accedervi (---servirebbe un elenco?????--) manda un mail al Room Aide. Se non ti accetta deve spiegarti il perche' (----o no?-- stiamo diventando una BBS seria?). Se per caso appi una room ad invito devi chiedere di nuovo all'RA di invitarti. Un discorso a parte meritano le stanze dell'ELASTIC GAME (vedi). Ci sono infine alcune stanze riservate a chi gestisce la BBS: ci sono stanze per i Sysop, per gli Aide, per i Room Aide. Un utente normale (livello 4) non puo` accedervi. PIANI ===== (in futuro) Le stanze della BBS sono organizzate per piani. Ci sono vari piani (quando mi colleghero` a Pisa mettero` un elenco sensato). Descrizione generale dei comandi di Cittadella ============================================== Ad ogni comando di cittaclient e` associato un tasto della tastiera (attenzione, l'interprete e` sensibile alle maiuscole). Premendo il tasto si esegue il comando, che in seguito puo' richiedere altre informazioni (ad esempio, se premo

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 e` associato il comando REPLY, ovvero rispondi al messaggio che stai leggendo; se invece sei in modo "stanza", premendo leggerai i messaggi al contrario, dall'ultimo al primo. Inoltre, sia per raggruppare alcuni comandi simili nello stesso gruppo, sia a causa del limitato numero di tasti e` possibile eseguire alcuni comandi mediante i 'dot commands'; questi sono comandi composti dalla pressione di due o piu' tasti, il primo dei quali e` sempre un punto: <.>. ---Notazione usata--- Per indicare un comando useremo la seguente notazione: Se il comando e` formato da una sola lettera, lo metteremo tra <>, ad esempio per il comando password indicato prima useremoi

. Per chiarire il motivo della scelta della lettera, alle volte verra` indicata anche una parola mnemonica associata al comando, ad esempio uovi il messaggio; o anche, ma piu` raramente epress-message. Siccome la scelta e` frequentemente dettata dall'uso che si fa nelle BBS di lingua inglese, capitera` che il mnemonico venga indicato tra parentesi, ad esempio salta (ump). Nei comandi dot (.) verra` sempre indicata l'intera sequenza da premere; se quindi si parla dei comandi dei referendum, verra` detto che vi si accede con <.u>rna, e che per vedere la lista dei referendum si usa <.ul>ista; questo ovviamente non vuol dire che i tasti da premere dopo <.> non sono ancora <.>, ma solo . Questo perche' cosi` sai subito a quale sequenza e` associato il comando dato, senza dover tornare indietro nel testo per capire quali sono i caratteri precedenti. I comandi verranno prima elencati raggruppandoli per uso, alla fine ci sara` un elenco alfabetico di tutti i comandi di Cittadella. LETTURA E MODIFICA DELLE CONFIGURAZIONI ======================================= Questi comandi vengono usati soprattutto dai Sysop, dagli Aide e dai Room Aide. Qualcuno puo` essere usato dagli utenti normali. Si usano tutti in modo Comando Modifica la configurazione del sistema. Solo se sei Sysop e gli altri Sysop non ti stanno guardando. Modifica le variabili di configurazione dell'utente. Permette di modificare le variabili di configurazione rispondendo 'si' o 'no' mediante i tasti s/n alle domande fatte dal client. Vedi anche la sezione =Configurazione dell'utente= Modify Friend-list: Modifica la lista di amici. Permette di aggiungere, rimuovere un amico, scambiare di posto due amici, uscire e salvare i nuovi amici o lasciar perdere le modifiche. <.f> Mostra o modifica la friend list. (vedi e dot-commands)

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 proseguono la lettura dei messaggi nella direzione scelta. opia Copia il messaggio appena letto in un'altra stanza. BUG? non chiede dove copiarlo cancella Cancella il messaggio che stai leggendo, sempre che sia tuo. (elete) I room aide possono cancellare nelle stanze che gestiscono un qualunque messaggio. Gli Aide e i Sysop possono cancellare tutti i messaggi. samina Esamina il buffer delle citazioni.(Leggi la sezione sul Buffer). riinizia Va al primo messaggio nella stanza. (irst) uove Sposta un messaggio da questa stanza ad un altra. Puoi farlo solo se hai scritto tu il messaggio o se sei Room-Aide della stanza, Aide o Sysop. uovo sinonimo di < >: legge il messaggio successivo.(?????) Se non ce ne sono piu` entra in modo "Comandi". Leggi il significato anche nel Modo Comandi. cita Copia nel buffer il messaggio che stai leggendo. Leggi la sezione sui Buffer. isponde Risponde al messaggio precedente; si entra nell'editor e il subject e` il subject del messaggio a cui si risponde preceduto da Reply:. Se i messaggi non possono avere subject e` un modo comodo per inserire un messaggio mentre si e` in modo Messaggi. metti Smette di leggere i messaggi, rimane nella stessa stanza ma in modo Comandi. prosegue con la lettura dei messaggi non letti (?e < >). <-> Per leggere gli ultimi n messaggi. Cittadella presto indovinera` quanti messaggi vuoi leggere. Per ora devi scriverlo. Come salva Salva il messaggio che stai leggendo sul file ~/cittadump. Se questo esiste gia` il messaggio viene aggiunto alla sua fine. Se sei Sysop, Aide, Room Aide o Room Helper oltre a poter cancellare o spostare messaggi non tuoi come e` scritto sopra, puoi lasciare messaggi nella tua funzione di S/A/RA/RH. Devi pero` andare in modo comandi. Leggi la parte in Modo Comandi, la parte sulle Stanze o sui dot-commands. Buffer dei messaggi =================== Cittadella ti da` la possibilita` di citare il messaggio che stai leggendo con il comando (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 (old). La volta successiva che entri nell'editor esterno continuerai a scrivere il messaggio. Infine c'e` un'altra possibilita`: (ump) in modo messaggi salva nel file locale ~/cittadump il messaggio appena letto. Se il file cittadump non era vuoto il messaggio viene aggiunto in coda. Bisogna fare alcune osservazioni: -Il comando cancella il messaggio uotato precedentemente, invece -se hai sia un old che un uote attivi, alla prossima scrittura di un post con editor esterno, apparira` nell'editor prima il testo memorizzato con old, seguito dal testo quotato. Ripetendo alternativamente i due comandi, e' possibile quotare piu' di un messaggio alla volta. NB: L'hold e il quote funzionano solo se si scrive il nuovo messaggio con l'editor esterno. Inoltre se esci dalla BBS perdi sia i messaggi uotati sia quelli in . Al comando uote sono associati anche i due comandi: (ree), in modo messaggi, che libera completamente il buffer del samina, in modo messaggi, che esamina il buffer del quote. Pager Messaggi ============== Se il messaggio che si sta leggendo e` troppo lungo, Cittadella (o il client locale di Cittadella) mostra solo le prime righe del messaggio e mette in fondo la scritta -- more (, , top, help) linea 23/37 62% -- (Ovviamente i numeri varieranno). Al prompt si hanno questi comandi a disposizione: - < > vai avanti di una pagina - vai avanti di una riga - ack vai indietro di una riga - p vai indietro di una pagina - efresh ristampa la 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: ================================================ <.> : inserisce un post in qualita`di Room Aide o di Room Helper a seconda del ruolo ricoperto dall'utente. <.>: inserisce un post in qualita` di Aide. <.> : inserisce un post in qualita` di System Operator. 4. Comandi di Help, informazione sul sistema e di bug report ------------------------------------------------------------ Questi comandi ti permettono di accedere a dei files che descrivono il funzionamento di Cittadella/UX e ti aiutano ad usarla. E` in progetto inoltre un comando ell per chiedere aiuto a qualcuno disponibile a spiegare il funzionamento della BBS. I comandi implementati attualmente, da eseguire in modo Comandi, sono: o l'equivalente Help: Lista dei comandi disponibili, si puo` usare anche in modo Messaggi e in modo Lettura. Leggi un file di Help Digitando appare una lista di files di aiuto, di informazioni sul sistema, sul comportamento da adottare, etc. Se ne puo` scegliere uno mediante un prompt e il testo viene visualizzato. Bug Report Questo comando serve a semplificare lo sviluppo di Cittadella/UX. Se un utente riscontra un errore del programma o comunque un comportamento strano, puo' segnalarlo ai sysop premendo . In questo modo puo` scrivere una descrizione del problema, che verra' poi spedita automaticamente ai sysop. La descrizione dovrebbe essere il piu` completa possibile; bisogna riportare il tipo di client usato (client locale oppure telnet alla BBS), il tipo di terminale che si e` usato, se il client e' locale tutte le informazioni sul hardware e sistema operativo utilizzato, e una descrizione dettagliata delle operazioni compiute nella BBS prima di riscontrare il baco. Il messaggio verra` anche messo nella stanza Bug Cittadella>, leggi le sue info info per maggiori informazioni. Se premi per sbaglio non scrivere "scusate, mi sono sbagliato, non volevo, perdonatemi" o messaggi di insulti come "Bisogna essere dei babbei per associare il comando di bug Report a una sola lettera"; invece non scrivete nulla, premi due volte invio a vuoto e il messaggio non verra` spedito. Se hai gia` scritto qualcosa e vuoi interrompere il Bug report scrivi su una riga a se' ABORT e premi invio. ALTRI COMANDI ============= Qui sono elencati i comandi che non rientrano in nessuna delle precedenti categorie. <%> Lock del terminale- Sia modo Comandi che Messaggi. Ti permette di bloccare l'accesso al client per un breve periodo, se ti deve assentare, senza interrompere la connessione al server. Per sbloccare il terminale devi digitare correttamente la password. <$> Subshelli- Solo modo Comandi Funziona solo sei collegato col client locale. Apre una subshell (/bin/sh di default) e sospende cittaclient. La sessione viene ripresa appena si esce dalla subshell con 'exit'. (ime) Ora&Data- Sia in modo Comandi che Messaggi da` la data e l'ora della BBS. 5. Comandi di gestione delle room --------------------------------- Questi comandi servono a spostarsi tra le varie stanze. Si eseguono tutti in MODO COMANDI Sono elencati anche altri comandi che hanno a che vedere con le stanze. --- non sono sicuro---- < > Se ci sono ancora messaggi nuovi in questa stanza va al primo messaggio non letto, altrimenti va alla prima stanza con messaggi non letti. ----- Abbandona. Abbandona la stanza. (devo leggere la discussione) Forward. Entra in modo messaggi e va al messaggio piu` vecchio (il primo) presente nella stanza. Va alla stanza successiva. I messaggi nuovi restano non letti (e quindi con < > ci si ricapitera` dentro). Info Room. Da` informazioni sulla stanza: su chi e` il Room Aide e sui Room helper ed altre amenita` del genere. Se il Room Aide non e` troppo pigro da` anche una breve descrizione della stanza, sul genere di messaggi presenti e sulle regole da rispettare. come , ma chiede il nome della stanza in cui si vuole andare. I messaggi non letti rimangono segnati come non letti. Si puo` usare la TAB COMPLETION. Inoltre e` sufficiente scrivere le prime lettere della stanza in cui si vuole andare. Se ce n'e` piu` d'una ti manda nella stanza che per CITTADELLA viene prima. Elenca le stanze in cui hai accesso e che non hai zappato; le stanze sono divise tra quelle in ci sono messaggi non letti e le altre. Non c'entra nulla qui, ma per ricordarti: ti chiede conferma e poi esce dalla bbs. come < > entra in modo messaggi e inizia a leggere dall'ultimo messaggio della stanza (o che hai letto???) E` come , esce dalla stanza e va alla successiva. Pero` segna tutti i messaggi come letti. Zappa la room (vedi la sezione ROOM) Va alla stanza mail. I messaggi non letti restano non letti <@> Ti dice se hai nuovi messaggi in Mail> (Vedi anche nella sezione della configurazione la parte sulla notifica di nuove mail). <-> Legge gli ultimi n (Cittadella ti chiede quanti) messaggi. PARAMETRI DI UNA STANZA ======================= Il room aide d'una stanza, puo` modificare, con il comando <.aer> i suoi parametri. Dando invio mantiene il parametro gia` inserito. Il comando <.aer> chiede i parametri: Nome della Room [ ]: Il nome della stanza puo` essere quello che vuoi. La lunghezza massima e` 16 caratteri. Di solito il nome della stanza e` stabile. L'eccezione piu` importante riguarda il nome delle stanze dell'ELASTIC GAME Livello minimo per lettura: e il successivo Livello minimo per scrittura: Sono i livelli minimi che devono avere gli utenti per leggere e rispettivamente scrivere nella stanza. Tipicamente sono i livelli 1 e 4 Subject (s/n): Abilita il Subject. Ci sono stanze (Chiacchiere>) in cui il Subject non ha molto senso. Reply (s/n): Abilita il Reply. Se e` anche abilitato il Subject il nuovo Subject e` Reply: Subject del post precedente. Se il Subject non e` abilitato e` solo un modo comodo per inserire un messaggio senza fare e poi . Si noti che un Reply ad un reply lascia il Subject invariato e non accumula Reply: all'inizio. Invito (s/n): Se la room e` a invito ci possono entrare solo gli utenti invitati (vedi i DOT COMMANDS <.aiu>). Guess Room (s/n): La stanza e` sconosciuta a tutti gli utenti (tranne che agli Aide). Pero` se l'utente indovina il nome completo della stanza e ci fa un la stanza diventa conosciuta. Messaggi anonimi: Tutti i messaggi sono anonimi. Post anonimo facoltativo: Chiede all'utente se vuole lasciare un messaggio anonimo. Attivata (s/n): Attiva la stanza. Alla fine viene chiesto se si vogliono rendere effettive le modifiche fatte con la domanda: Vuoi mantenere le modifiche (s/n)? Si Il room Aide dovrebbe anche inserire una breve descrizione della stanza, per indicare qual e` l'argomento di discussione e quali le regole da rispettare. Questo si ottiene con il comando (modo comandi) <.aei>. Il room aide puo` anche inserire dei messaggi in qualita` di room Aide, per distinguerli da messaggi messi da utente normale. I messaggi vanno inseriti con il comando <.aem>. Se un utente si e` rivelato particolarmente fastidioso o inopportuno il Room Aide puo` cacciarlo dalla stanza cosi` da impedirgli di mettere messaggi (? come funziona?). Messaggi di Amministrazione: ============================ Per amministrare meglio la BBS e moderare le room, Room Helper, Room Aide, Aide e Sysop possono lasciare dei post 'ufficiali' di amministrazione. In questo caso il loro nome viene preceduto dalla loro qualifica, che puo` variare a seconda del contesto: Room Helper: Possono postare in qualita` di Room Helper nelle room di loro competenza, il comando e` (in modo comandi) <.ae> Room Aide : Possono postare in qualita` di Room Aide nelle loro room. Il comando e` <.ae> Aide : Possono postare in qualita` di Room Helper in tutte le room e in qualita` di Aide se il post riguarda la gestione della BBS. Comando <.aem> Sysop : Possono postare in qualita` di Room Helper in tutte le room, in qualita` di Aide se il post riguarda la gestione della BBS e in qualita` di System Operator se il post riguarda il software o la gestione del sistema. Comando NB: In Cittadella BBS i Sysop non si considerano Aide e si tengono fuori dalla gestione della BBS e delle room in cui non hanno ricevuto un incarico di Room Aide o Room Helper. 3. Comandi riservati agli Aide e Sysop per la gestione del sistema ------------------------------------------------------------------ Broadcast: Invia un messaggio a tutti gli utenti (aide only) Permette di inviare un messaggio tipo eXpress-message che viene visto da tutti gli utenti connessi. Visualizza la configurazione del sistema (aide only) Permette di esaminare le variabili di configurazione del sistema editabili direttamente dal client. Questi si dividono nelle seguenti sezioni: 1) Configurazione generale del sistema 2) Informazioni sul server 3) Path dei files 4) Gestione dell'idle 5) Nomi delle principali room Modifica la configurazione del sistema (sysop only) Permette di modificare le variabili di configurazione del sistema descritte sopra direttamente dal client. Caccia un utente dalla BBS (aide only) Permette di cacciare (kick out) un particolare utente dalla BBS, digitando il suo nome. Se al posto del nome si fornisce 'Ospite', vengono cacciati tutti gli ospiti. L'operazione viene loggata. Kill user: Elimina definitivamente un utente (sysop only) Permette di eliminare tutti i dati di un utente dal file degli utenti. L'operazione viene loggata. Cambia la passwOrd di un utente (aide only) Permette agli aide e sysop di modificare la password di un utente, generalmente perche' quest'ultimo l'ha dimenticata. Per eseguire il comando, l'aide deve prima inserire la propria password, poi immettere il nome dell'utente al quale va cambiata la password. La nuova password viene generata in modo casuale dal server di Cittadella/UX e inviata all'indirizzo Email dell'utente. 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. sYslog: Visualizza il file di log del sistema (sysop only) Permette di visualizzare i log di sistema effettuati dall'ultimo reboot. (Vedi sezione `Log di sistema') ELASTIC GAME ============ Elastic Games (EG) e` il piu` bel gioco dopo Civilization, Diplomacy e tressette. In elastic game un utente della BBS, il ??gestore??, sceglie un opera famosa, libro, film, quadro, spettacolo teatrale, disco e un oggetto che vi compare. Lo scopo degli altri utenti (non gli AIDE, vedremo perche') e` quello di indovinare il titolo dell'opera e successivamente il nome dell'oggetto. Il gioco sfrutta l'esistenza di stanze nella BBS a cui si puo` accedere solo se si indovina il loro nome per intero: vengono infatti create due stanze i cui nomi sono il titolo dell'opera e il nome dell'oggetto da indovinare. I giocatori fanno domande, nella stanza Elastic Game>, all'utente che ha proposto il gioco. Le risposte alle domande possono essere solo si`/no (eventualmente non so). Il gestore puo`, a sua scelta, mettere indizi vari per aiutare gli utenti. E` costume metterne uno all'inizio, oltre ad indicare di che tipo di opera si tratta. Se pensi d'aver indovinato, fai un e dai come nome della stanza il titolo dell'opera. (Regole su come comportarsi con articoli, congiunzioni, preposizioni e vari segni ortografici sono nelle info della room). Se hai azzeccato il titolo entri nella stanza Titolo> e qui devi il nome dell'oggetto che compare nell'opera, nello stesso modo in cui hai indovinato il titolo dell'opera. Fai attenzione che a questo punto non tutti i giocatori conoscono il nome della stanza, e quindi evita di parlarne in Elastic Game>. Se indovini anche l'oggetto entri nello stesso modo nella stanza Oggetto>, a questo punto hai vinto l'EG, una bambolina e diventi tu il nuovo gestore dell'EG. Vantati pure in tutta la BBS, ma ricordati di mettere un messaggio qualunque (sbruffoneggia pure) nella stanza Oggetto>, cosi` come nella stanza Titolo> se non l'hai ancora fatto, in modo da lasciare una traccia del tuo passaggio. L'attuale gestore dell'EG, che e` anche RA delle due stanze Titolo> ed Oggetto> te le cedera`, cosi` che puoi iniziare tu un nuovo Elastic Game. Quando sei gestore dell'EG vai nella stanza Titolo> e usa i comandi <.aer> (aide enter room) per modificare il titolo della stanza. Ricordati di dire che la stanza e` una (Guess Room) Fai lo stesso con la stanza Oggetto>. Poi vai in Elastic Game> e annuncia il nuovo EG. Quando qualcuno indovina il nome modifica il Room Aide (non si puo` fare da RA....). GUARDARSI INTORNO ================- CI sono un po' di comandi che ti permettono di guardarti intorno: Sono tutti disponibili sia in modo Messaggi che in modo Comandi, tranne e .

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>) Ora e data di Cittadella. Lista di tutti gli utenti, solo in modo Comandi. Questo comando permette di vedere la lista di tutti gli utenti della BBS (connessi o meno) con qualche informazione. Appaiono nell'ordine: a) Nome dell'utente b) Livello di accesso c) data dell'ultimo collegamento d) Numero di chiamate totali effettuate e) Numero di messaggi lasciati nelle room Who. Mostra l'elenco degli utenti connessi in quel momento alla BBS Who in chat. Solo modo Comandi. Elenca gli utenti collegati nei i vari canali di Chat. Non serve essere collegati a qualche canale per usare il comando. Referendum e sondaggi ===================== In Cittadella ci sono due forme di @@sondaggio@@: I Referendum vanno proposti dagli Aides e dovrebbero aiutare a gestire la bbs, e dovrebbero aiutarli a capire l'opinione degli utenti sui problemi che si pongono. E' uno strumento che hanno a disposizione nella bbs, sta poi a loro decidere se usarlo o meno. Quando il tempo per votare scade, Cittadella posta automaticamente i risultati nella Lobby (quindi niente brogli elettorali ;). (Ma leggi il significato di <.uc>). I Sondaggi hanno uno scopo piu' ludico, e permettono agli utenti di proporre un quesiti in una particolare room dove hanno accesso di scrittura. Il funzionamento e' lo stesso, al termine del periodo concesso per votare i risultati vengono postati nella room stessa. Per ora c'e' un limite di 20 sondaggi contemporanei. I comandi sono: <.un> Per proporre un nuovo referendum o sondaggio. <.uc> Per completare una consultazione in corso prima dello scadere. <.ud> Per annullare una consultazione in corso. <.ur> Per leggere il testo del referendum o sondagio. <.uv> Per esprimere il proprio voto. <.ul> Per vedere la lista delle consultazioni in corso. Per ora sono attivi solo i referendum. 7. Dot Commands -------------- Questi comandi, possibili solo in modo Comandi, ripetono in gran parte i comandi visti in predecenza e in parte servono ad ampliare il numero di comandi disponibili; ma soprattutto riuniscono le funzioni simili sotto lo stesso nome. Il primo livello e` diviso in: <.a>ide, comandi riservati ai SysOp, agli Aide e in parte ai RA <.c>hat, comandi per la chat, <.e>nter, per inserire messaggi "speciali" o per modificare la registrazione o la configurazione <.f>riend, per modificare la friend list <.h>elp, i file di help <.k>nown rooms, per vedere le stanze della BBS <.s>ysop, comandi per il sysop <.t>oggle, per modificare alcuni parametri <.u>rna, per i sondaggi e i referendum (vedi). 1) <.a>ide Solo per Aide/Sysop. (e Room Aide se indicato) Dove si dice che il comando e` per Room Aide (RA), si intende che la persona che se ne occupa e` il room aide della stanza; all'occorrenza anche i Sysop e gli Aide possono usare quel comando. <.aa> new room aide Assegna un Room Aide alla stanza corrente <.ab> broadcast Comando di Broadcast: manda un messaggio tipo x-mgs a tutti gli utenti. <.ae>dit commands Si divide in altri sottocomandi (vedi dopo). Serve a modificare la configurazione di Cittadella, delle stanze e degli utenti. Alcuni comandi sono anche per RA <.ah> crea un RH Crea un room helper, per RA nvite user Per invitare un utente nella stanza, per RA ill commands Cancella utenti e stanze. Si divide in sottocomandi. La descrizione completa e` piu` avanti. create ew room Crea una nuova stanza. (*mai visto* qualche Aide completi). ead commands Per leggere i dati di Cittadella (Solo Sysop??) 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 ead legge (solo Aide e Sysop): <.arc> Configurazione La configurazione del sistema <.arr> Room L'elenco di tutte le stanze della BBS 2) <.c>hat Sono comandi per la chat. Per ora sono implementati ?nonva??<.ca> Ascolta Ascolta un canale di chat (come ) <.ce> Esci Esci dalla chat. (come ) <.cw> Who Elenca gli utenti nei canali di chat 3) <.e> enter 4) <.f>riends list: Permette di modificare o di leggere la lista degli amici: <.fm> modifica Modifica la lista degli amici. Come (per l'elenco delle opzioni, vedi la sezione AMICI. <.fr> leggi (read) Mostra la lista degli amici. 5) <.h>elp e` come : presenta una lista di file di help, si puo` scegliere il file per leggerlo. 6) <.k>nown rooms. Si divide in <.ka> all elenc tutte le stanze <.kf> floor elenca le stanze a questo piano (vedi Piani) <.kn> nuove elenca solo quelle con nuovi messaggi <.ko> old elenca quelle con solo vecchi messaggi ?? <.kz> zappate Quelle zappate (vedi Stanze). Le stanze accessibili su invito che sono state zappate NON compaiono nella lista. 7) <.e> enter Serve a scrivere vari tipi di messaggi <.ea> aide Mette un messaggio come Room Aide o Room Helper nella stanza. Ovviamente si deve essere RA o RH. <.eb> bug Bug report. Manda un bug report. Leggi la parte sui Bug Report nella sezione di Help, prima di mandarne uno. <.ec> config Cambia la tua configurazione. Fa scegliere tra il seguente elenco 1. Variabili generiche 2. Apparenza 3. Comunicazione (Xmsg e Notifiche) 4. Scansione room e lettura messaggi 5. Dati personali visibili a tutti 0. Tutto Per una descrizione piu` accurata leggi la sezione sulla Configurazione. <.ee> editor Posta un messaggio scritto con l'editor esterno. come . Vedi anche la sezione sui messaggi <.em> message Posta un messaggio scritto con l'editor di Cittadella. Per finire lascia una linea bianca. <.ep> profile Modifica il tuo profilo (Vedi la sezione profile). <.er> registrazione Modifica i dati della tua registrazione. Alla fine ti chiede se vuoi confermare i cambiamenti. Leggi la parte sulla registazione. 8) <.t>oggle. Permette di alternare la scelta (vedi anche Configurazione) tra alcune opzioni. <.tb> bell: Sono le 16:45, il capo se n'e` andato e finalmente puoi farti avvertire dalla i campanella quando arrivano x-mesg, messaggi da chat e cosi` via. <.tf>riends: boh...(non va) credo sia il toggle x-msg da amici. <.th>hyperterm: Se vuoi i messaggi pieni di colori e fuochi artificiali (vedi sezione Hyperterminal) <.tn> notifiche login/logout Se sei un po' autistico e non te ne frega nulla di sapere chi arriva o di chi se ne va. <.tx> expert Se sei in modo esperto, compare solo il prompt delle stanze. Altrimenti ad ogni schermata Cittadella ti ricorda quali sono i comandi piu` importanti. <.tu> follow-up Se il modo follow-up e` abilitato, quando ti arriva un x-msg entri immediatamente nell'editor degli x-msg, con destinatario chi ti ha mandato l'x-msg. Associato a questo c'e` il comando Leggi anche la sezione Comunicazione. 8) <.u>rna Per creare, leggere e votare sondaggi e referendum (vedi Sondaggi e referedum). Alcuni di questi comandi sono riservati agli Aide e Sysyop, altri solo ai Room Aide e altri a tutti. Tutti i comandi, a parte <.un> e <.ul> chiedono a quale consultazione deve essere applicato il comando. (? ci sara` differenza nei comandi tra sondaggi e referendum? boh... per ora lascio cosi`?) <.uc> chiude: Chiude la consultazione che viene indicata. (solo Aide/RA) <.ud> cancella: Cancella la consultazione indicata. (Solo Aide/RA) <.ul> lista: Mostra un elenco delle consultazioni in corso (col numero di consultazione a cui ci si deve riferire negli altri comandi). Per tutti gli utenti. <.un> nuova Crea una nuova consultazione. Solo Aide/RA. <.ur> leggi Leggi il testo d'una consultazione. Per gli utenti che hanno diritto a votare la consultazione (?o per tutti?) <.uv> vota Vota per una consultazione +--------------+ | DOT COMMANDS | +--------------+ -------------+---------------------------------------------------------+-----+ Sequenza | Descrizione | Key | -------------+---------------------------------------------------------+-----+ <.> | <.> ide new room ide | | <.> | <.> ide roadcast | | <.> | <.> ide dit onfigurazione del sistema | | <.> | <.> ide dit room nfo | | <.> | <.> ide nter essage | | <.>

| <.> ide dit

assword di un utente | | <.> | <.> ide dit oom | | <.> | <.> ide dit tente | | <.> | <.> ide new room elper | | <.> | <.> ide nvita utente in questa room | | <.> | <.> ide ill accia utente connesso | | <.> | <.> ide ill limina definitivamente un utente | | <.> | <.> ide ill spiti * DA FARE * | | <.> | <.> ide ill oom corrente | | <.> | <.> ide ew room | | <.> | <.> ide ead onfigurazione del sistema | | <.> | <.> ide ead oom list | | <.> | <.> ide ead configurazione tente * DA FARE * | | -------------+---------------------------------------------------------+-----+ <.><#> | <.> hat scolta canale <#> * DA FARE * | | <.> | <.> sci | | <.> | <.> hat ho | | -------------+---------------------------------------------------------+-----+ <.> | <.> nter message as room ide or helper | | <.> | <.> nter ug report | | <.> | <.> nter onfiguration | | <.> | <.> nter message with xternal editor | | <.> | <.> essage | | <.>

| <.> nter

rofile | | <.> | <.> nter egistration | | -------------+---------------------------------------------------------+-----+ <.> | <.> riend List odify | | <.> | <.> riend List ead | | -------------+---------------------------------------------------------+-----+ <.> | <.> nown rooms ll | | <.> | <.> nown rooms in loor | | <.> | <.> nown rooms with ew messages | | <.> | <.> nown rooms with ld messages only | | <.> | <.> nown rooms apped | | -------------+---------------------------------------------------------+-----+ <.>

| <.> odifica

assword |

| <.> | <.> odifica egistrazione | | -------------+---------------------------------------------------------+-----+ <.> | <.> ead rief | | <.> | <.> ead onfigurazione | | <.> | <.> ead orward | | <.> | <.> ead nfo dettagliate room corrente | | <.> | <.> ead ew | | <.>

| <.> ead

rofile |

| <.> | <.> ead everse | | <.> | <.> ead ser list | | <.> | <.> ead ho is online | | -------------+---------------------------------------------------------+-----+ <.> | <.> oggle ell | | <.> | <.> oggle riends | | <.> | <.> oggle yperterminal | | <.> | <.> oggle otifiche | | <.> | <.> oggle epert mode | | <.> | <.> oggle follow-p automatico per Xmsg | | -------------+---------------------------------------------------------+-----+ <.> | <.> ysop nter message | | <.> | <.> ysop ile Message reate | | <.> | <.> ysop ile Message elete Post | | <.> | <.> ysop ile Message xpand | | <.> | <.> ysop ile Message eaders | | <.> | <.> ysop ile Message nfo | | <.> | <.> ysop ile Message ill | | <.> | <.> ysop ile Message ead post | | <.> | <.> ysop ile Message tatistics | | <.> | <.> ysop ead System ogs | | <.> | <.> ysop ead erver statistics | | <.> | <.> ysop hutdown | | <.> | <.> ysop hutdown with illscript | | <.> | <.> ysop hutdown ow | | <.> | <.> ysop hutdown top | | -------------+---------------------------------------------------------+-----+ <.> | <.> rna ompleta | | <.> | <.> rna elete | | <.> | <.> rna uovo ondaggio | | <.> | <.> rna ead | | <.> | <.> rna ota | | -------------+---------------------------------------------------------+-----+ E da Mac? Si ringrazia Sir Action per la consulenza (vuol dire che ========= l'ha scritto lui). Per quanto riguarda i collegamenti via telnet da un mac, in attesa di OS X, con le sue belle shell unix da voi tanto richieste ed amate, potete usare il programma "BetterTelnet", attualmente scaricabile dall'indirizzo http://www.versiontracker.com/redir.fcgi/kind=1&id=640/bettertelnet-2.0fc1.sit. bin [dalla pagina web dell'autore http://www.cstone.net/~rbraun/mac/telnet/] What is BetterTelnet? BetterTelnet for Mac OS is a significantly enhanced version of NCSA Telnet 2.7b5. It is just as flexible to configure, but adds more features, tons of bug fixes for true stability, and many new options. Best of all, BetterTelnet is free software, and the source code is reusable under the GNU General Public License (GPL)! Collegamento telnet a Cittadella da Windows: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Ebbene si, alla microzot non sono stati capaci neanche di creare una cosa semplice come un telnet. Infatti, se ti colleghi a Cittadella con un Windows pre-2000, non sarai in grado di usare il comodo editor esterno. Ti consigliamo percio' di collegarti mediante PuTTY, un programma OpenSource che puoi scaricare da: http://www.chiark.greenend.org.uk/~sgtatham/putty/ Client locale o server Remoto? ============================== Potresti chiederti: Cosa mi conviene usare, il client locale o il telnet per collegarmi a Cittadella BBS? La risposta semplice e` di usare il client locale. Collegandosi con telnet, parte un client sulla macchina remota, che fa da interfaccia tra il terminale e il server della BBS. Ogni volta che viene eseguito un comando, questo viene mandato al client remoto, trattato, e la risposta viene mandata indietro sul terminale. Inoltre, quando si edita un testo (post, Xmsg, etc.), l'editor gira sulla macchina remota. Se si verifica una situazione di lag, la risposta sul terminale a quello che richiedi puo` subire del ritardo, che puo` rivelarsi molto fastidioso (in particolare se stai editando un post e le lettere appaiono sullo schermo qualche secondo dopo che hai premuto il tasto...) Il client locale, al contrario, gira direttamente sulla tua macchina, e quando 'parli' con il client non hai la rete di mezzo. Ovviamente questo non elimina il lag; quando fai una richiesta al server devi comunque aspettare la risposta del server. In compenso, quando editi dei testi, lo fai usando un programma che gira sulla tua macchina; in questo modo non vedi il lag, la scrittura e` piu` piacevole e perdi meno tempo. Puo` perfino sembrare che stai scrivendo quella relazione che il capo aspetta da due settimane! Il lag si verifica solo quando hai finito di scrivere e spedisci il testo al server. Inoltre, usando il client locale, puoi usare come editor esterno il tuo editor preferito (vi? emacs? pico?...) inserendo il suo path nella variabile di ambiente EDITOR. Questo ti permette ad esempio di inserire nel post che stai scrivendo dei testi che tieni nella tua home directory, etc. Il client locale ti permette inoltre di fare un dump del messaggio che stai leggendo sul file ./cittadella.dump del tuo computer, mediante la semplice pressione del tasto dal prompt dei messaggi. Bisogna osservare pero` che in un caso la connessione via telnet e` migliore di quella con client locale: quando si interrompe la lettura di un post lungo digitando al pager. Questo perche` il client deve ricevere tutto il testo prima di poter proseguire; se c'e` lag e interrompo la lettura, devo aspettare la fine della trasmissione del testo prima di poter fare altro. Al contrario, il client remoto gira sulla stessa macchina del server della BBS, e percio` riceve il testo in modo quasi istantaneo; il lag e` solo dovuto al ritardo nella trasmissione delle sole righe che leggo al terminale. Se quindi interrompo la lettura di un post con , il client remoto e` subito pronto ad eseguire un nuovo comando. I sorgenti del client locale 'cittaclient' sono rilasciati sotto la licenza GPL, e si possono scaricare dalla pagina web http://ping.science.unitn.it/~impe/download/ Attualmente girano solamente in ambiente UNIX (e sono state testate su linux). Altri client locali sono in fase di sviluppo, ma non sono ancora disponibili. Infine ci sono i Proxy Cittaclient. Questi sono a tutti gli effetti dei client locali, che pero' girano su macchine diverse dalla macchina dove gira il server della BBS. Permettono a chi non puo' far girare un client locale sulla prossima macchina di collegarsi a un host con il quale ha una buona connessione per far girare il client, che mantiene parte dei suoi vantaggi rispetto al problema del lag. Attualmente non e` disponibile alcun proxy: Client locali (vedete voi se mettervi o no, per ora siete gli unici) ============== Per Un*x: Cittaclient-0.1.16, licenza GPL http://ping.science.unitn.it/~impe/download/ Sviluppatori Marco Caldarelli- Ping Riccardo Vianello Ric Log di sistema: =============== il server tiene un diario in ./syslog delle operazioni che esegue. Queste vengono poi smistate in diversi files in ./log a seconda del tipo di evento. Questo aggiornamento avviene ad ogni reboot del server. ./log/aide : log dei comandi per aide/sysop (AIDE). ./log/carico : carico di Cittadella/UX ./log/connessioni : log delle connessioni al server. ./log/kickout : log degli utenti cacciati (KO). ./log/kill : log degli utenti eliminati (KILL). ./log/login : log delle login. ./log/nuovi_utenti : connessioni da parte di nuovi utenti. ./log/rusage : log dell'uso di risorse di sistema. Appaiono nell'ordine: * User time used * System time used * Maximum resident set size * Integral shared memory size * Integral unshared data size * Integral unshared stack size ./log/secure : le righe SECURE del syslog, con tentativi di accesso a comandi non permessi al livello dell'utente. ./log/syserr : log degli errori di sistema. ./log/system : log degli eventi di sistema. ./log/validate: log delle valkeys e validazioni. Files: ====== COPYRIGHT Copyright di Cittadella/UX FILES Descrizione dei files in ./ INSTALL Istruzioni di Installazione Directories: ============ ./client files per il client ./server files per il server Portabilita': ============= Cittadella/UX e' scritto su Linux con glibc 2.1, compilato con gcc egcs-2.91 con architettura i386. Tuttavia il codice e` scritto cercando di aderire alle convenzioni ansi. La compilazione del client e` avvenuta con successo su: * Digital Server 2100 modello A500MP, CPU ALPHA DEC 21064a con sistema operativo OSF/1 versione 3.0 ma non dovrebbe creare problemi su altre piattaforme UNIX. Ringraziamenti ============== A tutti gli utenti della Emperor's BBS che hanno contribuito a migliorare e a eliminare i bachi della vecchia BBS di Linuz, e che ci hanno fatto capire l'esigenza di riscrivere da capo il codice. Il concetto che ci siamo formato di come essere costruita Cittadella/UX e' nato dal confronto con loro. A Sir Action per la parte sui Mac, a Ping e Ric per l'ossatura di questo e degli altri file della documentazione. Mantainer: LePetit (ex DasKleinchen) ========== Contributi di: Marco Caldarelli e Riccardo Vianello (per ora) ==============