SF COMANDI UTENTE Versione 2.0 NOME  SF - Search File: un flessibile programma di ricerca file  SINTASSI  SF P=PAT/a pattern DP=DIRPAT/k TO/k S=SINCE/k U=UPTO/k A=ARCHIVES/s B=BLOCKS/s D=DIRS/s F=FILES/s SHORT/s NA=NOARC/s NB=NOBANNER/s NC=NOCOLOR/s NI=NOINFO/s NR=NOROOT/s NS=NOSORT/s NT=NOTOTAL/s L=LFORMAT/k  DESCRIZIONE  SF cerca file o directory in un qualsiasi device AmigaDOS. La ricerca e' effettuata partendo dalla directory radice (root directory) del device e scendendo attraverso tutte le sotto-directory. La ricerca viene inoltre effettuata negli archivi generati dai vari programmi di compressione di file: attualmente sono supportati gli archivi il cui nome ha un'estensione .ARC, .LZH, .ZIP o .ZOO. Per l'utilizzo di questo programma e' necessario avere la libreria shared ARP.library versione 1.3 (revisione 39.1) o successiva nella directory LIBS:.  IL FORMATO DELL'OUTPUT  SF, se usato con le opzioni di default, visualizza i file e le directory adottando il seguente schema: [nome] [dimensione/tipo] [giorno] [data] [ora] Sono previste un certo numero di opzioni (spiegate piu' avanti) per selezionare un particolare insieme di file (o directory) e per modificare il formato di output. E' possibile utilizzare gli operatori standard di AmigaDOS '>' e '>>' per ridirezionare l'output del programma. Segue ora una descrizione di ognuno degli elementi precedentemente citati.  nome  Il nome del file o della directory.  dimensione/tipo  Questo campo rappresenta la dimensione del file in byte (o in blocchi, se viene utilizzata l'opzione BLOCKS). La stringa _(_d_i_r_) verra' visualizzata se il campo nome rappresenta una directory.  giorno  Il giorno della settimana della creazione (o dell'ultima modifica) di una directory o di un file.  data  La data della creazione (o dell'ultima modifica) di una directory o di un file. Il formato della data e' specificato dal valore della variabile di environment di ARP _d_a_t_e_f_o_r_m_a_t : vedere il manuale utente di ARP (ARP User's Manual) per il significato della ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 1 SF COMANDI UTENTE Versione 2.0 variabile e i suoi possibili valori.  ora  L'ora della creazione (o dell'ultima modifica) di una directory o di un file. La prima volta che viene trovato un file o una directory tra quelli specificati, SF visualizza un'intestazione che specifica se il file (o directory) e' contenuto in una directory o in un archivio. Alla fine del processo di ricerca verra' visualizzata una riga di totali specificante il numero di directory trovate, il numero di file trovati, la loro dimensione in byte e in blocchi. In qualsiasi istante, e' possibile interrompere il programma tramite le sequenze di tastiera Control-C oppure Control-D: in questo caso, la stringa _S_F_:__*_*_*__B_R_E_A_K verra' visualizzata e non verra' mostrata la riga dei totali. Da notare che tutti gli altri messaggi (incluso il messaggio di copyright) verranno sempre visualizzati sullo schermo, indipendentemente dal fatto che l'output sia stato ridiretto o meno.  SELEZIONE DELLE DIRECTORY E DEI FILE  Ci sono diversi modi per selezionare un insieme di directory o file (o tutti e due). Quasi tutte le opzioni possono essere usate contemporaneamente, con alcune eccezioni. Come detto in precedenza, per default SF inizia la ricerca dalla directory radice del device corrente, a meno che non sia specificato diversamente.  P=PAT pattern  Questo e' l'unico parametro obbligatorio. Per mezzo di esso, e' possibile specificare quale insieme di directory e file si desidera cercare. Sono supportate tutti i caratteri jolly (wildcard) permessi dalla versione 1.3 di ARP, cosi' come e' possibile utilizzare i caratteri jolly standard dell'AmigaDOS. La parola chiave PAT e' opzionale ed e' richiesta solamente se si utilizza la sintassi per parametri posizionali (vedere il manuale AmigaDOS per maggiori dettagli in proposito). Se non viene specificato un device o una directory, la ricerca iniziera' dalla directory radice.  DP=DIRPAT  Questa opzione e' utile quando si vuole cercare un insieme di directory o file limitatamente ad un insieme ristretto di directory o archivi. Come per il parametro PAT, possono essere utilizzati sia i caratteri jolly di ARP 1.3 sia quelli dell'AmigaDOS, ma non e' ammessa la specifica di un device.  S=SINCE data  Questa opzione seleziona solo le directory o i file ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 2 SF COMANDI UTENTE Versione 2.0 che sono stati creati o modificati a partire dalla data specificata. Il formato della data e' quello stabilito dalla variabile ARP di environment _d_a_t_e_f_o_r_m_a_t ; in alternativa, e' possibile specificare un giorno della settimana (in inglese) o le parole TODAY (oggi), YESTERDAY (ieri) o TOMORROW (domani). Questo filtro viene applicato solo alle directory e ai file gia' selezionati dal parametro PAT ed, eventualmente, dall'opzione DIRPAT.  U=UPTO data  Questa opzione e' l'inverso dell'opzione SINCE. Le directory e i file saranno selezionati solo se la loro data di creazione o modifica e' antecedente o uguale a quella specificata. Come per l'opzione SINCE, questo filtro viene applicato solo alle directory e ai file gia' selezionati dal parametro PAT ed, eventualmente, dall'opzione DIRPAT.  A=ARCHIVES  Informa SF di cercare gli insiemi specificati solo all'interno degli archivi. Questa opzione e' incompatibile con le opzioni DIRS e FILES.  D=DIRS  Informa SF di selezionare solo le directory specificate dal parametro PAT. Non verra' cercato alcun file. Questa opzione e' incompatibile con le opzioni ARCHIVES e FILES.  F=FILES  Informa SF di selezionare solo i file specificati dal parametro PAT. Non verra' cercata alcuna directory. Questa opzione e' incompatibile con le opzioni ARCHIVES e DIRS.  NA=NOARC  Informa SF di non cercare all'interno degli archivi.  NI=NOINFO  Informa SF di non selezionare i file che hanno il nome terminante con l'estensione _._i_n_f_o , indipendentemente dal parametro PAT.  NR=NOROOT  Informa SF di non iniziare la ricerca dalla directory radice del device corrente. Se viene specificato un device o una directory nel parametro PAT, questa opzione non avra' alcun effetto.  MODIFICA DEL FORMATO DI OUTPUT  Le opzioni che seguono permettono di modificare il formato di output. Anche queste opzioni possono essere combinate, con alcune eccezioni. ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 3  SF COMANDI UTENTE Versione 2.0 B=BLOCKS  Visualizza le dimensioni dei files in blocchi anziche' in byte. SF calcola le dimensioni dei file contenuti negli archivi nello stesso modo del FFS (Fast File System), addizionando alla dimensione reale dei file i blocchi richiesti per il file header e gli eventuali blocchi di estensione. Questa opzione e' utile nel caso si voglia sapere se un file, una volta estratto da un archivio, potra' essere contenuto in un disco. Attenzione che i device montati con l'OFS (Old File System) richiedono piu' blocchi per la memorizzazione dei file di quanto non facciano quelli montati con il FFS.  L=LFORMAT stringa  Questa opzione permette di specificare il formato di output con maggiore flessibilita'. _s_t_r_i_n_g_a e' una stringa ASCII nella quale il carattere '%' ha un significato speciale quando e' associato ad un altro carattere. Ecco una lista delle possibili sequenze, con l'avvertenza che vengono differenziati i caratteri minuscoli dai maiuscoli.  %b  Visualizza la dimensione di un file espressa in blocchi.  %D  Visualizza il giorno della settimana della creazione o modifica di una directory o di un file.  %d  Visualizza la data della creazione o modifica di una directory o di un file.  %f  Visualizza il nome di una directory o di un file.  %P  Visualizza il nome di una directory o di un file anteponendo il suo pathname completo.  %p  Visualizza il pathname a cui una directory o file appartiene.  %s  Visualizza la dimensione di un file espressa in byte.  %t  Visualizza l'ora della creazione o modifica di ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 4 SF COMANDI UTENTE Versione 2.0 una directory o di un file.  %%  Visualizza il carattere '%'. Inoltre, sono disponibili le sequenze standard dell'AmigaDOS _*_N e _*_E per visualizzare i caratteri ASCII di newline ed escape. Da notare che, nell'ambito dell'environment ARP 1.3, e' possibile sostituire il carattere di escape di AmigaDOS '*' con un altro carattere (per esempio, con il carattere '\'). Qualsiasi altro carattere verra' visualizzato senza subire alterazioni. Specificando una sequenza '%' illegale, verra' visualizzato un messaggio di avviso (warning) e verra' selezionato il formato di output di default. Questa opzione e' incompatibile con l'opzione SHORT.  NB=NOBANNER  Non visualizza il messaggio di copyright. Utile per gli script file.  NC=NOCOLOR  Non utilizza le sequenze ANSI per la visualizzazione dei dati.  NS=NOSORT  Non esegue l'ordinamento (sort) delle directory e dei file. Il default e' di ordinare alfabeticamente le directory e i file, visualizzando prima le directory e poi i file.  NT=NOTOTAL  Non visualizza la riga dei totali al termine della ricerca.  SHORT  Visualizza le directory e i file anteponendogli i loro rispettivi pathname completi. Questa opzione e' incompatibile con l'opzione LFORMAT.  TO pathname  Permette la ridirezione dell'output del programma su un qualsiasi device AmigaDOS. Utile in quei casi in cui, per qualche motivo, non e' possibile utilizzare gli operatori standard dell'AmigaDOS '>' e '>>'. Questa opzione inibisce qualsiasi altro tipo di ridirezione eventualmente specificata.  ESEMPI  SF *  Cerca qualsiasi directory e file contenuti nelle sotto-directory o nei file archivio, iniziando dalla directory radice del device corrente. Utile per ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 5 SF COMANDI UTENTE Versione 2.0 ottenere una lista ordinata di un disco o di un device logico.  SF df0:mydir/*  Cerca qualsiasi directory o file contenuti nella directory _d_f_0_:_m_y_d_i_r o nelle sue sotto-directory o negli archivi in esse contenuti.  SF [abc]* DIRPAT [def]*  Cerca tutte le directory e i file i cui nomi iniziano con i caratteri _a , _b o _c (o _A , _B o _C ) contenuti nelle sotto-directory o negli archivi i cui nomi iniziano con i caratteri _d , _e o _f (o _D , _E o _F ).  SF myfile SINCE Monday UPTO Yesterday  Cerca il file (o la directory) _m_y_f_i_l_e in tutte le sotoo-directory e gli archivi solo se la sua data di creazione o modifica e' compresa tra lunedi' e ieri.  SF /a#? DIRPAT *.zoo FILES NOINFO LFORMAT "File %f  Cerca qualsiasi file (non le directory!) il cui nome inizia il carattere _A o _a e contenuto in qualsiasi directory(!) o archivio i cui nomi sono individuati dal pattern _*_._z_o_o . Qualsiasi file con l'estensione _._i_n_f_o non verra' selezionato e il formato di output sara', per esempio: File avail in DH0:Archive/Commands.zoo Il processo di ricerca iniziera' dalla directory padre della directory corrente. Se la directory padre non esiste (per esempio perche' la directory corrente e' la directory radice) verra' visualizzato un messaggio di errore. L'opzione NOROOT, nel precedente esempio, non avrebbe avuto alcun effetto.  NOTE ADDIZIONALI  SF e' stato sviluppato con il compilatore C della Lattice versione 5.04 utilizzando il codice di startup standard per programmi residenti. Per questo motivo, SF dovrebbe poter essere inserito in una lista di programmi residenti nell'ambito di un discreto numero di shell. Sono stati effettuati con successo test con la WShell di Bill Hawes utilizzando il comando RESI. Attenzione, inoltre, che alcuni programmi di compressione file sono capaci di comprimere directory nei file archivio: SF non e' in grado di visualizzare il nome di queste directory, sebbene mantenga la capacita' di cercare i file in esse contenuti. SF e' un programma _S_H_A_R_E_W_A_R_E_,__N_O_N__D_I__P_U_B_B_L_I_C_O__D_O_M_I_N_I_O . Leggere il file _M_i__D_e_v_i__L_e_g_g_e_r_e per la politica di distribuzione. ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 6  SF COMANDI UTENTE Versione 2.0 RINGRAZIAMENTI  Desidero ringraziare diverse persone che mi hanno aiutato durante lo sviluppo di SF. Prima di tutto, un grazie particolare a: Marco Ciuchini Andrea de Prisco Roberto Pratesi per i loro consigli e suggerimenti. Grazie inoltre a tutti quelli che hanno utilizzato la versione 1.0 per avermi convinto nel continuare lo sviluppo di questa nuova versione. In ultimo, vorrei ringraziare i seguenti autori per i loro magnifici prodotti: ARP authors per la loro ARP.library Bill Hawes per la sua WShell e ARexx Lattice Inc. per il loro compilatore C ©1989 Andrea Suatoni 25 Novembre 1989 Pagina 7