The Java Planet
presents
File Split v1.2
===============

This document contains following information.

1) Introduction

2) How to start the program?

3) How to split a file?

4) How to merge the partitions?

5) Further Help

6) Other products

7) About author

 

Introduction
============
You can use this program for splitting a large file into
smaller parts according your choice, so as to conveniently
transfer it across a network or using floppy disks or 
thro' email. You can specify the size of each partition 
to be created or the no. of partitions to be created. 

You don't need this program to merge the partitions created 
by it. A DOS batch file as well as a UNIX shell script file 
are created while partitioning whose execution will 
automatically merge the partitions. So you can pass the 
partitions to your friends who don't have this program (and 
for that matter, not even Java) installed on their machine.

However, an option to merge the partitions using FileSplit 
itself is also provided. And its use is advised as it makes 
checks regarding size and checksums of the partition files 
being transferred. So if any partition is missing or is 
corrupted, then the method will notify you.

The program is in the form of executable jar file. You 
need to have Java Runtime Environment installed on your 
machine. If you don't have it, you can install it from 
java.sun.com.

The source code of the program is available. The source 
code is fully documented, with all major steps 
explained. It's worth taking a look at the source code.




How to start the program?
=========================
Unzip the downloaded file and do following. You need to have
classpath properly set to run FileSplit.

Method 1:
Double-click on FileSplit.jar

Method 2:
Double-click on FileSplit.bat

Method 3:
Double-click on FileSplit.exe

Method 4:
On the DOS window, type 
		FileSplit
OR
		java -jar FileSplit.jar
 

How to split a file?
====================

Step I :  
Specify the name of the file to be split i.e.enter the 
entire path OR use the browse button to choose the file.

Step II :  
Select one of the two options for splitting criteria - 
"Split by Size", where you would enter the size of the 
partitions, or "Partition by Number of Parts", where you 
would specify the number of partitions to be formed, size of 
each partition will be calculated automatically.

Step III :  
Enter the size of partitions OR the number of partitions 
depending on your choice in step II

Step IV :  
Press the GO! button.

The partitions along with the dos batch file, unix shell 
script file, and FileSplit project file for merging will be 
created in the same directory as that of the original file. 
Names of the partitions would be the original filename with 
extension, if any, followed by the partition number as 
extension. If some error in input occurs, you will be 
prompted by the program.

Now you will have to transfer all the files generated to the 
destination machine to obtain the original file back.
 


Merging the partitions into the original file
=============================================
How to merge the partitions?

There are three ways to merge the partitions, one for 
DOS/Windows, one for unix and one for all the operating 
systems with FileSplit installed.

****For DOS/Windows****

Step I :  
Put all the partitions & the DOS batch file formed during 
the partitioning in the same directory.

Step II :  
Run the DOS Batch file. The original file will be created in 
the same directory.

Note that if some partitions are missing, no warning will be 
given. However corresponding portion in the file will be 
missing and hence the file may be corrupted.

****For Unix/Linux****

Step I : 
Put all the partitions & the Unix script file formed during 
the partitioning in the same directory.

Step II : 
Change the permissions of the script to make it executable. 
For example, run chmod 500 scriptname

Step III : 
Run the script using ./scriptname

****For any operating system with FileSplit installed.***

Step I : 
Put all the partitions & the FileSplit project file formed 
during the partitioning in the same directory.

Step II : 
Run FileSplit and go to merge tab at the top

Step III : 
Select the project file using the browse button

Step IV : 
Press G0! The original file will be created in the same 
directory. If any of the file was corrupted or missing, 
FileSplit would inform you.
 

A word of caution while merging!!
=================================
If you do not place all the partitions in the same folder 
while merging, you may still get a file with original 
file name, but it will not be a complete file.

 

Still Facing Problems??
=======================
If you still have any sort of problem, you can seek my 
help by mailing me at vishalm@iitb.ac.in
 

Other Products
==============
You can download a lots of java stuff from 
http://www.geocities.com/thejavaplanet which includes 
java applications like EncryptDecrypt, Calculator, 
java games like JSnake, Need More Speed?, 
visual effects like rain, lake, explosion, tunnel and 
java applets like navigation, search, newsticker & firetext.


You can also download wallpapers, screensavers, windows 
utilities, windows games, fun programs & books from 
http://www.geocities.com/vishalmamania

 

About Author
============
The author, Vishal Mamania, is postgraduate student in 
Computer Science & Engineering department of Indian 
Institute of Technology.You can contact me at 
vishalm@iitb.ac.in or 
http://www.geocities.com/vishalmamania or 
http://www.geocities.com/thejavaplanet. 

Keep checking for newer versions at 
http://www.geocities.com/thejavaplanet/javaapps/filesplit/index.html 
and for more programs. You can obtain the fully documented 
source code from http://www.geocities.com/thejavaplanet/javaapps/filesplit/source.html. 
Please feel free to distribute this software to as many 
people you want. Bug reports and suggestions are very 
welcome.
