@Database DLGftp.guide
@$VER: 1.0
@Author Piergiorgio Ghezzo
@(C) 1995 by UNIVISION
@wordwrap

@node "Main" "DLGftp v1.0"

                    @{b}DLGftp@{ub} v1.0 by @{i}Piergiorgio Ghezzo@{ui}

           Consente l'accesso ai CD simulando una sessione FTP

                         @{u}@{fg shine} Manuale per il Sysop @{uu}@{fg text}



                          @{" + " link "Descrizione" 0}  Descrizione
                          @{" + " link "Requisiti" 0}  Requisiti
                          @{" + " link "Installazione" 0}  Installazione
                          @{" + " link "Configurazione" 0}  Configurazione
                          @{" + " link "Uso" 0}  Uso del programma
                          @{" + " link "Ringraziamenti" 0}  Ringraziamenti
                          @{" + " link "Registrazione" 0}  Registrazione
                          @{" + " link "Autore" 0}  L'autore
                          @{" + " link "Futuro" 0}  Il futuro del programma
                          @{" + " link "History" 0}  History
@endnode

@node "Descrizione" "Descrizione"

  @{b}DLGftp@{ub}  un modulo per Dialog che consente un accesso ai devices (CD o Hard Disk) simulando una sessione di FTP. I files verranno copiati nella directory dell'utente pronti per essere ricevuti.

  Il programma sfrutta appieno la @{b}dlg.library@{ub} e quindi risulta molto compatto e veloce; non pu per essere lanciato da CLI come programma normale.


  @{b}Questa  una breve lista delle caratteristiche che offre il programma:@{ub}

 o  Possibilit di specificare un @{b}livello di accesso minimo al programma@{ub}.
    La cosa pu essere gestita anche da Dialog, ma in questo modo risulta
    pi   simpatico   (non  viene  accettata  alcuna  password  da  parte
    dell'utente al momento del login).

 o  Visualizzazione prima e dopo il login di due @{b}files di testo@{ub} preparati
    precedentemente dal Sysop.

 o  @{b}Interfaccia comando molto semplice@{ub} ma efficace con tutti i principali
    comandi  utili per lavorare sui volumi. @{b}Aiuto in linea@{ub} disponibile su
    tutti i comandi.

 o  Gestione  di  un  aiuto dettagliato con la visualizzazione di un file
    esterno.

 o  @{b}Possibilit di visualizzare@{ub} (tramite programmi esterni non forniti ma
    facilmente reperibili) @{b}ipertesti in formato AmigaGuide e contenuto di@{ub}
    @{b}archivi@{ub}.

 o  Gestione  di variabili d'ambiente (compatibili con i programmi ConDir
    Blitz-CD)  @{b}per  garantire  un  accesso  esclusivo  al  CD-ROM@{ub},  utile
    sopprattutto in caso di BBS multi-linea dotati di lettore multiplo di
    CD-ROM.

 o  Possibilit  di specificare per @{b}ogni@{ub} volume un livello di accesso, un
    livello minimo per il trasferimento dei files nell'area privata e una
    directory base a cui far accedere l'utente.

 o  Possibilit  di  specificare  per @{b}ogni@{ub} volume un file da visualizzare
    all'accesso e il nome di un file da cercare all'interno di ogni nuova
    directory in cui l'utente entra.

 o  @{b}Verifica dell'effettiva presenza del CD@{ub} al momento della richiesta di
    accesso, per consentire la rotazione periodica dei CD in linea.

 o  @{b}Possibilit  di  gestire  una  serie di account@{ub} in grado di alzare il
    livello  di accesso dell'utente al momento del login, per garantirgli
    l'accesso   a  determinati  volumi  solitamente  non  accessibili,  o
    accessibili solamente a livelli pi alti.

 o  @{b}Notifica su file@{ub} di tutte le azioni compiute dell'utente.

 o  I  files  che  vengono  spostati  dall'utente nella propria directory
    privata @{b}possono avere attivo il flag FREE@{ub}.

 o  @{b}Controllo  facoltativo  della  dimensione della directory dell'utente@{ub}
    prima di trasferire un file.

    e @{b}molte altre cose@{ub} che scoprirete provandolo...
@endnode

@node "Requisiti" "Requisiti"

   @{b}DLGftp@{ub} lavora su Amiga con qualunque processore; nell'archivio  comunque presente una versione dell'eseguibile compilata ottimizzando il codice per il 68030. Per l'uso  richiesto il programma @{b}Dialog@{ub} correttamente installato (anche perch altrimenti il programma non avrebbe senso di esistere).

  @{b}MoreText@{ub}        o un qualsiasi altro programma in grado di visualizzare
                  files amigaguide direttamente su console.

  @{b}ArcMaster@{ub}       o un qualsiasi altro programma in grado di gestire gli
                  archivi utilizzando l'output standard.

   @{b}DLGftp@{ub}  consigliato soprattutto per l'accesso a CD-ROM, ma pu essere utilizzato anche su Hard Disk. Il consumo di memoria  esiguo.
@endnode

@node "Installazione" "Installazione"

  L'installazione di @{b}DLGftp@{ub} risulta molto semplice, in quanto basta aggiungere una voce nel men desiderato che chiama il programma in overlay senza parametri e come modulo Dialog (non quindi in modalit CLI).

  Il file di configurazione deve essere copiato nella directory @{b}DLGCONFIG:Misc@{ub} e modificato secondo le proprie esigenze.
@endnode

@node "Configurazione" "Configurazione"

  @{b}DLGftp@{ub} non  particolarmente difficile da configurare:  sufficiente modificare il file @{b}DLGCONFIG:Misc/DLGftp.CFG@{ub} secondo le proprie esigenze;  dispobibile comunque un @{"esempio" link "Esempio" 0}.

  Segue ora una lista commentata di tutti i parametri presenti nel suddetto file. E' possibile commentare i parametri non interessati con un punto e virgola.


@{b}LOGNAME@{ub} <file>

Indica il file su cui salvare un log di tutte le azioni svolte dagli utenti. Deve venir specificato il path completo.


@{b}INTROFILE@{ub} <file>

Indica il file di testo che verr visualizzato appena viene chiamato il programma; se non viene specificato, nessun testo sar visualizzato. Il file pu contenere qualsiasi switch gestito da Dialog. Deve venir specificato il path completo.


@{b}INFOFILE@{ub} <file>

Indica il file di testo che verr visualizzato appena viene completata la sequenza di login; se non viene specificato, nessun testo sar visualizzato. Il file pu contenere qualsiasi switch gestito da Dialog. Deve venir specificato il path completo.


@{b}HELPFILE@{ub} <file>

Indica il file di testo che verr visualizzato alla richiesta dell'aiuto esteso.


@{b}ACCESSLEV@{ub} <livello>

Indica il livello minimo che l'utente deve avere per poter accedere al programma. Per default viene impostato il valore 1.


@{b}FREEFILES@{ub}

Se tale parametro  specificato tutti i files copiati nella directory dell'utente avranno il flag FREE attivato.


@{b}LOCKSESSION@{ub}

Se viene specificato questo parametro il programma non permette l'accesso a pi di un utente alla volta. Deve venir utilizzato nel caso di BBS multilinea dotate di lettore multiplo di CD.


@{b}NOCHECKDIR@{ub}

Se tale parametro  specificato il programma non controlla lo spazio libero nella directory dell'utente prima di copiare il file.


@{b}GUIDEVIEWER@{ub} <stringa>

Indica il programma (completo di parametri) utilizzato per visualizzare i files amigaguide. Pu essere inserito qualsiasi switch di Dialog; la sequenza di caratteri %s verr sostituita dal nome del file da visualizzare. Nel caso non venga specificato tale parametro, verr visualizzato un messaggio all'utente avvisandolo che tale opzione non  disponibile.


@{b}ARCVIEWER@{ub} <stringa>

Indica il programma (completo di parametri) utilizzato per visualizzare il contenuto degli archivi. Pu essere inserito qualsiasi switch di Dialog; la sequenza di caratteri %s verr sostituita dal nome del file da visualizzare. Nel caso non venga specificato tale parametro, verr visualizzato un messaggio all'utente avvisandolo che tale opzione non  disponibile.


@{b}VOLUME@{ub} <nome>

Questo parametro serve per descrivere le caratteristiche di tutti i volumi utilizzati dal programma, gestendo una serie di sottoparametri pi o meno opzionali da inserire nelle linee seguenti. Ogni parametro VOLUME deve essere seguito dal parametro END per indicare al programma che si  terminata la lista dei sotto parametri relativi al volume in questione.

La prima riga del gruppo di definizione  appunto quella con il parametro VOLUME e il nome logico che vogliamo dare al volume (quello cio che verr utilizzato dai comandi open, close, connect e disconnect). A questo punto abbiamo a disposizione tutta una serie di sottoparametri:

     @{b}DESC@{ub} <stringa>

     Indica  una  breve  descrizione  del  volume. Tale descrizione viene
     visualizzata  nella  lista  generata  dal  comando  @{b}volumes@{ub}  e nelle
     informazioni visualizzate con il comando @{b}info@{ub}.

     @{b}PATH@{ub} <path>

     Questo  sottoparametro  specifica la directory a cui si avr accesso
     entrando  nel volume. Questa verr considerata dal programma la root
     directory  e non sar possibile raggiungere le precedenti tramite il
     comando @{b}parent@{ub}.

     @{b}FILETEST@{ub} <filename>

     DLGftp  permette  la  possibilit  di  lavorare su pi CD rispetto a
     quelli  che  possono  essere  utilizzati simultaneamente dal lettore
     CD-ROM.  La  lista  visualizzata con il comando @{b}volumes@{ub}  quella dei
     volumi che vengono gestiti dal programma. Al momento dell'accesso ad
     un  volume,  il  programma si incarica di controllare se il volume 
     effettivamente  presente  nel  lettore  controllando  se  possibile
     accedere  al  file  specificato da questo sottoparametro (che quindi
     dovr essere un file presente nel CD).

     @{u}ATTENZIONE:@{uu}  visto  lo scopo del comando non ha alcun senso indicare
                  nel  path  il  nome dell'unit (es. CD1:); ha pi senso
                  invece indicare il nome fisico del CD (es. AMINET6:).

     @{b}ACCESSLEVEL@{ub} <level>

     Indica  il  livello  minimo  di  accesso  necessario per accedere al
     volume. Per default viene impostato il valore 1.

     @{b}MOVELEVEL@{ub} <level>

     Indica  il  livello minimo di accesso necessario per copiare i files
     nella propria directory privata utilizzando il comando @{b}get@{ub}.
     Per default viene impostato il valore 1.

     @{b}BANNER@{ub} <filename>

     Questo  sottoparametro  opzionale e identifica il file (specificato
     completo  di  path)  che verr visualizzato ogni volta che un utente
     acceder al volume.

     @{b}DIRBANNER@{ub} <filename>

     Questo  sottoparametro    opzionale  e identifica il file che verr
     cercato  ogni  volta  che  l'utente  cambier  la directory corrente
     all'interno del volume usando i comandi @{b}cd@{ub}, @{b}changedir@{ub} oppure @{b}parent@{ub}.
     Il nome di questo file deve essere indicato privo di path, in quanto
     verr cercato nella directory corrente.


@{b}USER@{ub} <nome> <password> <livello>

Permette di specificare una serie di nomi speciali da utilizzare al login per modificare il livello di accesso; in questo modo  possibile gestire in un modo molto semplice ma potente l'accesso ad ogni singolo volume. Quando l'utente accede al programma utilizzando uno di questi nominativi, il suo livello di accesso viene portato a quello specificato nella linea di configurazione.

@endnode

@node "Esempio" "Esempio di file di configurazione"
 ;
 ; DLGftp configuration file
 ;
 ;
 ; The log filename
 ;
 LOGNAME SC:Sources/DLGftp/DLGftp.LOG
 ;
 ; Text files showed at start
 ;
 INTROFILE      DLGCONFIG:Misc/DLGftp.TXT
 INFOFILE       DLGCONFIG:Misc/DLGftp2.TXT
 ;
 ; File for verbose help
 ;
 HELPFILE       DLGCONFIG:Misc/DLGftp.Help
 ;
 ; Access level
 ;
 ACCESSLEV      10
 ;
 ; Files copied in the user directory will be free
 ;
 ;
 FREEFILES
 ;
 ; Allow only one access at time
 ;
 LOCKSESSION
 ;
 ; Don't check the user directory size
 ;
 NOCHECKDIR
 ;
 ; Program for amigaguide files display
 ; %s is the filename place
 ;
 GUIDEVIEWER    UTILITIES:MoreText %s LINES %SCLENGTH
 ;
 ; Program for archives display
 ; %s is the filename place
 ;
 ARCVIEWER      DOORS:MagicFile/ArcMaster %s T:AM_Temp "%UNAME" MASK=%PORT L=%SCLENGTH
 ;
 ;
 ; Volumes availables

 VOLUME       Aminet1
 DESC         The first Aminet CD
 PATH         SET1A:Aminet
 FILETEST     SET1A:Aminet/TREE
 ACCESSLEVEL  1
 MOVELEVEL    1
 END
 
 VOLUME       Aminet2
 DESC         The second Aminet CD
 PATH         SET1B:Aminet
 FILETEST     SET1B:Aminet/TREE
 ACCESSLEVEL  1
 MOVELEVEL    1
 END
 
 VOLUME       Aminet3
 DESC         The third Aminet CD
 PATH         SET1C:Aminet
 FILETEST     SET1C:Aminet/TREE
 ACCESSLEVEL  1
 MOVELEVEL    1
 END
 
 VOLUME       Aminet4
 DESC         The fourth Aminet CD
 PATH         SET1D:Aminet
 FILETEST     SET1D:Aminet/TREE
 ACCESSLEVEL  1
 MOVELEVEL    1
 END
 
 VOLUME       Aminet5
 DESC         The fifth Aminet CD
 PATH         AMINET5:Aminet
 FILETEST     AMINET5:Aminet/TREE
 ACCESSLEVEL  1
 MOVELEVEL    1
 END
 
 VOLUME       Aminet6
 DESC         The sixth Aminet CD
 PATH         AMINET6:Aminet
 FILETEST     AMINET6:Aminet/TREE
 ACCESSLEVEL  1
 MOVELEVEL    1
 DIRBANNER    INDEX
 END
 
 VOLUME       Cica1
 DESC         CICA - Disk one
 PATH         CICA1_0195:disc1
 FILETEST     CICA1_0195:disc1/CDROM.CFG
 ACCESSLEVEL  1
 MOVELEVEL    1
 END
 
 VOLUME       Cica2
 DESC         CICA - Disk two
 PATH         CICA2_0195:disc2
 FILETEST     CICA2_0195:disc2/CDROM.CFG
 ACCESSLEVEL  1
 MOVELEVEL    1
 END 

 VOLUME       HardDisk
 DESC         Il mio Hard Disk
 PATH         DH0:
 FILETEST     DH0:Disk.info
 ACCESSLEVEL  200
 MOVELEVEL    255
 BANNER       DH0:UNIVISION.Logo
 END
 
 ;
 ; Users availables with special userlevel
 ;
 ;        UserName   Password       Level
 ;------------------------------------------------
 USER      Aminet     Amiga          1000
 USER      Cica       Windog          50
@endnode

@node "Uso" "Uso del programma"

  Una volta effettuato il login e visualizzate le informazioni sul sistema si accede al prompt della shell di DLGftp. Da qui  possibile impartire ognuno dei comandi supportati dal programma, con la corretta sintassi. Voglio ricordare che prima di poter lavorare su un volume  necessario aprirlo, proprio come se si trattasse di un sito FTP.

  I comandi attualmente disponibili sono i seguenti:

         @{" amigaguide " link "amigaguide" 0}        @{" inside     " link "archive" 0}
         @{" archive    " link "archive" 0}        @{" list       " link "list" 0}
         @{" bye        " link "exit" 0}        @{" more       " link "more" 0}
         @{" cd         " link "chdir" 0}        @{" open       " link "open" 0}
         @{" chdir      " link "chdir" 0}        @{" parent     " link "up" 0}
         @{" close      " link "close" 0}        @{" pwd        " link "pwd" 0}
         @{" connect    " link "open" 0}        @{" quit       " link "exit" 0}
         @{" dir        " link "dir" 0}        @{" status     " link "info" 0}
         @{" disconnect " link "close" 0}        @{" system     " link "system" 0}
         @{" exit       " link "exit" 0}        @{" type       " link "type" 0}
         @{" get        " link "get" 0}        @{" up         " link "up" 0}
         @{" getfile    " link "get" 0}        @{" version    " link "version" 0}
         @{" guide      " link "amigaguide" 0}        @{" view       " link "more" 0}
         @{" help       " link "help" 0}        @{" volumes    " link "volumes" 0}
         @{" info       " link "info" 0}

@endnode

@node "Ringraziamenti" "Ringraziamenti"

@{b}I miei pi sentiti ringraziamenti vanno a:@{ub}

  @{b}Erno Tuomainen@{ub}              Per una serie di suggerimenti tecnici
                              fondamentali nell'interfacciamento del
                              programma con Dialog.

  @{b}Maurizio  Fabiani@{ub}           Per il beta-testing del programma, i
                              suggerimenti e il supporto.

  @{b}Gaetano Bl@{ub}                 Il primo utente che si  registrato!

  @{b}Paolo Carotenuto@{ub}            Per alcuni suggerimenti e per la
                              registrazione.

  @{b}Simone Marascalchi@{ub}          Per la traduzione della documentazione
                              in inglese.
@endnode

@node "Registrazione" "Registrazione"

  Il programma viene distribuito sotto il concetto di @{b}shareware@{ub}. Se il programma  di tuo gradimento, sei moralmente obbligato a ripagare le fatiche dell'autore e a contribuire allo sviluppo del programma.

  La quota per la registrazione del programma in Italia  fissata a @{b}15.000 lire@{ub}, che possono venir spedite in busta chiusa o tramite vaglia postale all'autore. Per la creazione della chiave  necessario compilare un @{"modulo di registrazione" link "Modulo" 0} che fornir all'autore tutti i dati necessari.

  @{b}Nella versione non registrata@{ub} non  possibile utilizzare i comandi per la visualizzazione dei files amigaguide e del contenuto degli archivi; non verr visualizzato il file all'accesso al volume n all'accesso alle directory. L'utente potr poi prelevare solo un file per ogni sessione.

  La versione registrata garantisce un pieno accesso a tutti i comandi del programma, senza la visualizzazione di ulteriori messaggi o pause. La chiave, che va posta nella directory @{b}L:@{ub} dell'hard disk, funzioner anche con le future versioni di DLGftp: non saranno quindi richiesti ulteriori soldi per la registrazione di successivi upgrades.

@endnode

@node "Autore" "L'autore"

  Qualsiasi critica, bug report o consiglio pu venir spedito all'autore:

     @{b}Piergiorgio Ghezzo@{ub}
     Via L. Loredan n.6
     30126 Lido-Venezia
           ITALIA


@{b}E-Mail:@{ub}

  - pghezzo@dsi.unive.it
  - 2:333/707.0@fidonet.org
  - 39:101/1.0@amiganet.ftn
@endnode

@node "Modulo" "Modulo di registrazione"

  Per consentire all'autore di creare una chiave personalizzata per il completo utilizzo del programma, compila il seguente modulo di registrazione e spediscilo all'@{"autore" link "Autore" 0} allegandolo ai soldi in una busta oppure inviandolo in matrix.

--- cut --- cut --- cut --- cut --- cut --- cut --- cut --- cut --- cut ---

                         MODULO DI REGISTRAZIONE

Nome e cognome ______________________________________________________
     Indirizzo ______________________________________________________
         Citt ______________________________________________________
        C.A.P. ______________ Prov. ______ Stato ____________________
      Telefono ______________________________________________________

              Indirizzo FidoNet  ________________________
              Indirizzo AmigaNet ________________________
              Indirizzo InterNet ________________________

      UserName utilizzato in BBS ________________________

Nome del programma cui voglio registrarmi  __________________________
       Quota spedita per la registrazione  __________________________
           Metodo di pagamento utilizzato  __________________________
     Su che modello di Amiga gira Dialog?  __________________________

Nell'output di alcuni comandi il programma utilizza un falso indirizzo InterNet (nella versione non registrata corrisponde a bbs.univision.it). Tale indirizzo pu venir personalizzato dall'utente registrato e memorizzato nella sua chiave.

Quale indirizzo hai intenzione di usare? ____________________________

--- cut --- cut --- cut --- cut --- cut --- cut --- cut --- cut --- cut ---
@endnode

@node "Futuro" "Il futuro del programma"

   Mi piacerebbe riuscire a implementare un comando di ricerca di un file all'interno  della  dir  corrente  (ricorsivamente)  per mi sa che viene fuori una cosa @{b}mooolto lenta@{ub}...

   Se avete qualche idea nuova da aggiungere al programma, scrivetemela e vedr di fare il possibile per realizzarla.
@endnode

@node "History" "History"

 @{b}- HISTORY -@{ub}

   23 nov 95  v1.0  Prima versione del programma.
@endnode

@node "Amigaguide" "I comandi 'guide' e 'amigaguide'"

  I comandi @{b}guide@{ub} e @{b}amigaguide@{ub} consentono di visualizzare direttamente sullo schermo un file ipertestuale in formato amigaguide. Viene chiamato un programma esterno (vi consiglio caldamente @{b}MoreText@{ub}), specificato nel file di configurazione.


@{b}Sintassi:@{ub}

 - guide <file>
 - amigaguide <file>
@endnode

@node "ChDir" "I comandi 'cd' e 'chdir'"

  I comandi @{b}cd@{ub} e @{b}chdir@{ub} permettono all'utente di cambiare la directory corrente all'interno del volume; tale directory deve esistere nel path corrente;  possibile concatenare una serie di directory separandole con il carattere @{b}/@{ub}. Specificando come parametro la sequenza di caratteri @{b}..@{ub} oppure il carattere @{b}/@{ub}  possibile accedere alla directory predecente a quella attuale.


@{b}Sintassi:@{ub}

 - cd <directory>
 - chdir <directory>
@endnode

@node "Exit" "I comandi 'bye', 'exit' e 'quit'"

  I comandi @{b}bye@{ub}, @{b}exit@{ub} e @{b}quit@{ub} permettono all'utente di uscire in qualsiasi momento dal programma. I volumi eventualmente lasciati aperti saranno automaticamente chiusi prima del termine dell'esecuzione.


@{b}Sintassi:@{ub}

 - bye
 - exit
 - quit
@endnode

@node "Volumes" "Il comando 'volumes'"

  Il comando @{b}volumes@{ub} non richiede parametri e visualizza la lista dei volumi del sistema disponibili all'utente con una breve descrizione a fianco; la visualizzazione avviene rispettando i singoli livelli di accesso.

@{b}Sintassi:@{ub}

 - volumes
@endnode

@node "Version" "Il comando 'version'"

  Il comando @{b}version@{ub} non richiede parametri e visualizza la versione del programma in uso, comprensiva di numero di revisione e data di compilazione. Viene indicato pure a chi eventualmente e' registrato il programma e gli indirizzi dove contattare l'autore.


@{b}Sintassi:@{ub}

 - version
@endnode

@node "Dir" "Il comando 'dir'"

  Il comando @{b}dir@{ub} visualizza all'utente in forma succinta la lista dei files (in azzurro) e delle directory (in rosso) presenti nel path corrente. E' possibile inserire come parametro una stringa per visualizzare solo i files che ci interessano; in questa stringa possono essere presenti i caratteri speciali @{b}?@{ub} (sostituisce un carattere) oppure @{b}*@{ub} (sostituisce una sequenza di caratteri).


@{b}Sintassi:@{ub}

 - dir <match>
@endnode

@node "List" "Il comando 'list'"

  Il comando @{b}list@{ub} visualizza all'utente la lista dei files e delle directory presenti nel path corrente. Di ciascuna voce verra' indicato la lunghezza in bytes (o eventualmente se si tratta di una directory), i flags di protezione nonch data e ora di creazione. E' possibile inserire come parametro una stringa per visualizzare solo i files che ci interessano; in questa stringa possono essere presenti i caratteri speciali @{b}?@{ub} (sostituisce un carattere) oppure @{b}*@{ub} (sostituisce una sequenza di caratteri).


@{b}Sintassi:@{ub}

 - list <match>
@endnode

@node "archive" "I comandi 'archive' e 'inside'"

  Con i comandi @{b}archive@{ub} e @{b}inside@{ub} e con l'ausilio di un programma esterno (vi consiglio @{b}ArcMaster@{ub}) specificato nel file di configurazione  possibile visualizzare il contenuto di un archivio.


@{b}Sintassi:@{ub}

 - archive <file>
 - inside <file>
@endnode

@node "open" "I comandi 'connect' e 'open'"

  I comandi @{b}connect@{ub} e @{b}open@{ub} permettono di aprire un volume per la consultazione. La lista di tutti i volumi accessibili  disponibile utilizzando il comando @{"volumes" link "volumes" 0}. Poich  possibile lavorare su un solo volume per volta, il sistema prima di aprire un nuovo volume controlla se un altro dispositivo  rimasto aperto, ed eventualmente lo chiude. I comandi restituiscono un errore nel caso il dispositivo non sia presente (per esempio il CD non sia inserito nel lettore) oppure nel caso il volume richiesto non esista o il livello di accesso sia troppo basso; in questo caso l'utente viene avvisato dell'impossibilit di eseguire l'operazione di apertura.


@{b}Sintassi:@{ub}

 - connect <volume>
 - open <volume>
@endnode

@node "close" "I comandi 'close' e 'disconnect'"

  I comandi @{b}close@{ub} e @{b}disconnect@{ub} non richiedono parametri e chiudono un volume precedentemente aperto.


@{b}Sintassi:@{ub}

 - disconnect
 - close
@endnode

@node "get" "I comandi 'get' e 'getfile'"

  I comandi @{b}get@{ub} e @{b}getfile@{ub} permettono all'utente di copiare il file indicato nella propria directory privata e renderlo cos disponibile per l'upload. Durante questa fase viene controllato, se richiesto, lo spazio a disposizione dell'utente. Per poter utilizzare questo comando  necessario possedere un livello superiore o uguale a quello indicato nel parametro @{b}MOVELEVEL@{ub} nel file di configurazione.


@{b}Sintassi:@{ub}

 - get <file> [|more]
 - getfile <file> [|more]
@endnode

@node "more" "I comandi 'more' e 'view'"

  I comandi @{b}more@{ub} e @{b}view@{ub} permettono all'utente di visualizzare il file di testo indicato.


@{b}Sintassi:@{ub}

 - more <file>
 - view <file>
@endnode

@node "pwd" "Il comando 'pwd'"

  Il comando @{b}pwd@{ub} visualizza la directory corrente.


@{b}Sintassi:@{ub}

 - pwd
@endnode

@node "info" "I comandi 'info' e 'status'"

  I comandi @{b}info@{ub} e @{b}status@{ub} mostrano all'utente una serie di informazioni tra cui il nome del volume attualmente aperto.


@{b}Sintassi:@{ub}

 - info
 - status
@endnode


@node "type" "Il comando 'type'"

  Il comando @{b}type@{ub} visualizza all'utente il tipo di collegamento in corso.


@{b}Sintassi:@{ub}

 - type
@endnode

@node "up" "I comandi 'parent' e 'up'"

  I comandi @{b}parent@{ub} e @{b}up@{ub} permettono all'utente di ritornare alla directory precedente del volume attualmente aperto.


@{b}Sintassi:@{ub}

 - parent
 - up
@endnode

@node "system" "Il comando 'system'"

  Il comando @{b}system@{ub} mostra all'utente il tipo di filesystem disponibile nel sistema remoto.


@{b}Sintassi:@{ub}

 - system
@endnode

@node "help" "Il comando 'help'"

  Il comando @{b}help@{ub} utilizzato senza parametri mostra la lista di tutti i comandi disponibili; specificando invece il comando interessato, fornisce una rapida spiegazione del suo utilizzo. Specificando invece come parametro @{b}DLGftp@{ub} il sistema mostra un aiuto pi dettagliato di tutti i comandi disponibili, visualizzando il file specificato nel parametro @{b}HELPFILE@{ub} del file di configurazione.


@{b}Sintassi:@{ub}

 - help [comando] [DLGftp]
@endnode

