
 SPLIT 1.2beta (c)copyright Giovanni Iacobelli (10.MAR.97)
			    via Viole nr.1
			    82032 Cerreto Sannita (BN)


 Introduzione
 ============
 Se si ha un file di grosse dimensioni e lo si vuole trasportare da
 un computer ad un altro mediante dei floppy disk ma esso non entra
 in un solo disco, bisogna ricorrere a SPLIT.
 SPLIT divider il file in diversi  pezzi pi piccoli. Questi pezzi
 potranno essere copiati su diversi floppy  e una volta trasportati
 sull'hard disk dell'altro computer potranno essere riuniti in modo
 da ricreare il file originale.
 SPLIT, poich lavora in modo binario, pu operare su file di qual-
 siasi tipo (file dati, file eseguibili, ecc.).
 La ricostruzione del  file originale avviene mediante il programma
 BUILD presente nell'archivio.


 Distribuzione
 =============
 SPLIT appartiene alla categoria 'Freeware' e ci significa che pu
 essere  distribuito   liberamente   ma  l'autore  ne  conserva  il
 copyright.
 SPLIT non pu	essere venduto tranne un piccolo costo per le spese
 di copia e di distribuzione.
 Pu essere inserito in raccolte di programmi di Public Domain e di
 Shareware e distribuito via rete (Internet).
 Non  pu essere inserito  in pacchetti commerciali senza una auto-
 rizzazione scritta dell'autore (a tal proposito contattare l'auto-
 re all'indirizzo postale citato a capo di questa documentazione).
 Il  programma dovr essere  distribuito  "cos com'" senza alcuna
 modifica, tuttavia potr essere compresso in un archivio (Lha, Zip
 ecc.).  Invece, non potr essere compresso con compressori che non
 richiedono una successiva decompressione (tipo PowerPacker, ecc.).
 In  ogni caso	SPLIT  dovr  essere  distribuito  assieme a questa
 documentazione.

 L'autore non si assume nessuna responsabilit  sui danni diretti o
 indiretti  che  il  programma	o  il suo  uso potrebbe  recare sul
 software o sull'hardware:

	 OGNUNO USI QUESTO SOFTWARE A PROPRIO RISCHIO E PERICOLO!!!
	 ----------------------------------------------------------
 L'autore, inoltre,  non  garantisce il perfetto  funzionamento del
 programma.

 N.B.
 Tutte le  norme  relative  alla distribuzione di SPLIT valgono per
 chiunque tranne per l'autore che pu fare del programma quello che
 vuole.


 Dati tecnici
 ============
 SPLIT  stato scritto e compilato in C. Funziona in ambiente DOS e
 non  richiede	grandi	risorse  hardware:  dovrebbe  funzionare su
 qualsiasi computer dotato di hard disk. La presenza dell'hard disk
 non   strettamente necessaria ma in tal caso non si potr operare
 su file di grossa taglia e l'utilit di SPLIT verr meno.
 La versione Ms-Dos  stata provata su un PC 286 mentre la versione
 AMIGA  stata provata su un A1200.


 Contatti
 ========
 Chiunque voglia mettersi in contatto con l'autore per chiarimenti,
 suggerimenti, o segnalazione di bug lo pu fare solo via posta al-
 l'indirizzo citato a capo di questa documentazione.
 Nella lettera,  in caso  di segnalazione  di bug,  dovranno essere
 specificate le configurazioni software e hardware usate.
 Per ricevere risposta	 necessario allegare nella busta i franco-
 bolli necessari: anche  se non lo garantisco, prometto che tenter
 di rispondere a tutti.
 ***NON SONO GRADITE CRITICHE.


 USO
 ===
 SPLIT funziona in ambiente DOS. La sintassi  la seguente:

	SPLIT buf=<buffer> <sorgente> frame1 frame2 ...

 <buffer> dovr essere un valore  compreso tra 1.024 e 56.000. Esso
 rappresenta il buffer che il programma dovr utilizzare nella fase
 di lettura e di scrittura  dei files.	Maggiore sar il valore del
 buffer maggiore sar la velocit del programma (valore consigliato
 50.000);

 <sorgente>  il pathname del file che si vuole dividere;

 frame1 frame2 ...   sono i pathnames dei vari pezzi in cui il file
 sorgente dovr essere diviso. Il numero min. dei frame   2 mentre
 il numero massimo  dovuto alla lunghezza  della linea di comando:
 Ms-Dos accetta  una linea  di comando max. di 128 caratteri mentre
 Amiga accetta una linea di comando max. di 255 caratteri.

 esempio Ms-Dos:

    C:\>Split buf=50000 testi\gen1.txt gen1.01 gen1.02 gen1.03

 Il file  'gen1.txt'  posto  nella sub-directory  'testi' del drive
 'C:' verr  diviso in tre pezzi  uguali  (l'ultimo potr essere di
 qualche bytes	pi lungo  nel caso che  il file non sia divisibile
 esattamente  per  tre)  chiamati  'gen1.01', 'gen1.02' e 'gen1.03'
 memorizzati in 'C:'.

 esempio Amiga:

   5.Work:> Split buf= 50000 testi/gen1.txt gen1.01 gen1.02 gen1.03

 Il file  'gen1.txt'  posto  nella sub-directory  'testi' del drive
 'Work:' verr diviso in tre pezzi uguali (l'ultimo potr essere di
 qualche bytes	pi lungo  nel caso che  il file non sia divisibile
 esattamente  per  tre)  chiamati  'gen1.01', 'gen1.02' e 'gen1.03'
 memorizzati in 'Work:'.


 Nel caso che  si verifichi qualche errore il programma fallir co-
 municando l'errore. Il messaggio d'errore sar seguito da un nume-
 ro (E1, E2, ecc.)  il quale  dovr essere ignorato  dall'utente ma
 potr	essere	utile all'autore  per  capire  in  quale  punto  il
 programma si  fermato.

 Nel caso  che sul supporto magnetico  siano gi presenti dei files
 con dei nomi uguali  a quelli specificati come frame, il programma
 prima di soprascriveli chieder conferma:

     gen1.02: gi esistente! Vuoi continuare? (S/N)?

 premendo  il tasto  della tastiera 's' il file  sar  soprascritto
 mentre  premendo  il tasto  'n' il programma terminer. Ogni altro
 tasto sar inteso come la pressione di 'n'.

 Nella versione Ms-Dos basta premere il tasto corrispondente mentre
 in Amiga si dovr premere il tasto e battere return.


 BUILD
 =====
 Per ricostruire il file originale bisogner ricorrere al programma
 BUILD posto nell'archivio.

 In MS-Dos:

    C:\>Build gen1.01 gen1.02 gen1.03  gennaio1.txt

 In Amiga:

    5.Work:>Build gen1.01 gen1.02 gen1.03  gennaio1.txt

 I frame 'gen1.01', 'gen1.02' e 'gen1.03'  saranno uniti creando il
 file 'gennaio1.txt'.

 Si ricorda che SPLIT lavora con tutti i tipi di file.	Quindi sar
 possibile  divide  un	eseguibile  (in MS-Dos .exe)  con  SPLIT  
 riunirlo in seguito con BUILD.

 E' importante che i frames  siano disposti nello stesso  ordine in
 cui sono stati generati.  A questo  proposito	si  ci	pu aiutare
 mediante suffissi progressivi come ho fatto io nell'esempio oppure
 mediante un promemoria in un file testo.

 BUILD lavora con un buffer di 25.000 bytes in lettura e di altret-
 tanti in scrittura.


 Alternative
 ===========
 In alternativa, sul MS-Dos  possibile usare il comando 'COPY':

    C:\> Copy /b gen1.01 + gen1.02 + gen2.03  gennaio1.txt

 mentre in Amiga:

    5.Work:> Join gen1.01 gen1.02 gen1.03 to gennaio1.txt

 Il comando AmigaDOS 'Join'  velocissimo. In tale sistema converr
 usarlo definitivamente al posto di BUILD.



 Implementazione versione 1.3beta
 ================================
 Adesso SPLIT,	dopo aver  creato  i vari pezzi,  memorizza un file
 testo	chiamato  'REMEMBER.TXT'  avente  lo stesso  path del primo
 frame dove sar annotata la linea comando di BUILD per ricostruire
 il file sorgente.  Questo  file    molto  utile per ricordarsi la
 giusta sequenza dei frames.

