/*************************************************************************/
/*                                                                       */
/*                    USO DELLA CONSOLE JACOP V. 0.5                     */
/*                                                                       */
/*************************************************************************/

1 INFORMAZIONI GENERALI

La console supporta due tipi di comandi:

   - comandi locali
   - comandi remoti

Questi ultimi divisi in:

   - comandi jaCop
   - comandi a3

I comandi locali hanno esito immediato, quelli remoti attivano uno dei sot-
to protocolli JaCop o A3 che, entro tempo non ben determinato, causano uno
o piu eventi. La notifica di un evento è riconoscibile perchè sempre prece-
duta dalla sequenza di caratteri "::".

NOTA: la versione attuale di jaCop NON supporta completamente le comunita'
multiple

2. COMANDI LOCALI

2.1 ECHO

uso: echo <stringa>

La stringa viene stampata; serve per il verificare che il parsing dei comandi
sia corretto

2.2 LIST

uso: list (communities | nodes <community> [-d])

Permette di conoscere di quai comunita' fa parte il nodo corrente e i suoi
vicini all'interno di ogni comunita'. Se utilizato per conoscere i nodi la
opzione "-d" permette di conosce anche la struttura dei nodi vicini
Sono disponibili anche i comandi abbreviati:

"lc" per "list communities"

e

"ln <community> [-d]" per "list neighbors <community> [-d]"

3 COMANDI REMOTI

3.1 COMANDI JaCOP

3.1.1 OPEN

uso: open <community> <capacita'> <grado di coesione>

Apre una nuova comunita', con il nome ed il grado di coesione indicati. Pur
essendo un comando remoto ha esito immediato in quanto coinvolge solo il
nodo corrente

3.1.2 LEAVE

uso: leave <community>

Causa l'abbandono della comunita' indicata da parte del nodo corrente. In
pratica il nodo smette di rispondere agli heartbeat provenienti da nodi di
quella comunita'

3.1.3 JOIN

uso: join <communty> <host> <porta> <capacita'> [<massimo numero di deleghe>]

Causa una operazione di join verso il nodo indicato. Se il massimo numero di
deleghe è diverso da 0 la richiesta puo' essere delegata. Il valore predefi-
nito per l'opzione e' 0 (richiesta con flag force attivo).
Al momento del joi un nodo indica anche la sua capacita'

3.2 COMANDI A3

3.2.1 PROBE

uso: probe <community>

Sonda della comunità indicata utilizzando l'algoritmo A3. Il nodo invia una
richiesta di probe e si mette in attesa per un certo tempo: puo' essere 
sbloccato con il comando "stop"

3.2.2 STOP

uso: stop

Interrompe l'operazione di "probe" correntemente in esecuzione