WipeFreeSpace Files

This is the README file for WipeFreeSpaceGUI, a Graphical User Interface
 for the wipefreespace program (http://wipefreespace.sf.net)

WipeFreeSpaceGUI IS JUST A GRAPHICAL USER INTERFACE FOR THE wipefreespace
PROGRAM, IT IS NOT A GUI PROGRAM THAT DOES THE WIPING, YOU NEED
wipefreespace TO DO THE ACTUAL WIPING.

========================= Running

Requirements:
- wipefreespace
- JRE, the Java Runtime Environment >= (1.)6.0

Using NetBeans: open the WipeFreeSpaceGUI directory as a NetBeans Project
 and click "Run" (or press F6).

By hand (after unpacking):
	double-click the WipeFreeSpaceGUI\dist\WipeFreeSpaceGUI.jar
	file (works on MS Windows)
		or
	run.bat	(on MS Windows)
		or
	run.sh	(on Un*x)
		or
	java -jar WipeFreeSpaceGUI/dist/WipeFreeSpaceGUI.jar	(on Un*x)
		or
	java -jar WipeFreeSpaceGUI\dist\WipeFreeSpaceGUI.jar	(on MS Windows)

Read the "INSTALL" file.

========================= Running in the default language (no translations)

Requirements:
- wipefreespace
- JRE, the Java Runtime Environment >= (1.)6.0

Using NetBeans: open the WipeFreeSpaceGUI directory as a NetBeans Project,
 right-click the project's root element in the project's tree on the
 left side of the window (the "Projects" sub-window), then click "Properties".
 Click "Run" in the tree and put
	-Duser.language=en -Duser.country=US
 in the "VM Options" field. Click OK and click "Run" (or press F6).

By hand (after unpacking):
	run-en.bat	(on MS Windows)
		or
	run-en.sh	(on Un*x)
		or	(on Un*x)
	java -jar -Duser.language=en -Duser.country=US WipeFreeSpaceGUI/dist/WipeFreeSpaceGUI.jar
		or	(on MS Windows)
	java -jar -Duser.language=en -Duser.country=US WipeFreeSpaceGUI\dist\WipeFreeSpaceGUI.jar

Read the "INSTALL" file.

========================= Usage (GUI)

Use the checkboxes to select the options to pass to wipefreespace.
Use the "Add filesystem(s)..." and "Remove filesystem(s)" buttons to manage
 the list of filesystems to wipe.
Press the "Start" button to start wiping. The "Stop" button can be used to
 stop wiping, but it stops the wipefreespace program in a way that prevents it
 from closing the filesystem properly, so damage can occur. Use only when
 really necessary.

========================= Usage (command line)

The following command-line (case-insensitive) options are supported:

	--all-zeros		- wipe only using zeros
	-b|--superblock <off>	- superblock offset on the given filesystems
	-B|--blocksize <size>	- block size on the given filesystems
	--conf <file>		- read configuration from the given file
	-f|--force		- continue even if the filesystem has errors
	--help			- display help
	--lang LL_CC_VV		- select the language to use by
					WipeFreeSpaceGUI: "LL" is the language,
					"CC" is the country code, "VV" is the
					variant. Separate them using
					underscores. Only LL is required.
	--last-zero		- additional wiping with zeros
	--licence, --license	- display license information
	--method <name>		- use the given method for wiping (read below)
	-n|--iterations <n>	- number of iterations (wiping passes)
	--nopart		- do NOT wipe partially used blocks
	--nounrm		- do NOT wipe undelete data
	--nowfs			- do NOT wipe unused space
	--use-ioctl		- disable cache during work (can be DANGEROUS)
	--version, -V		- display program version

WipeFreeSpaceGUI passes the wiping method's name directly to wipefreespace.
 You can choose one of the predefined methods (requires wipefreespace >= 1.5)
 or enter your own, if your version of wipefreespace supports other methods.
The following method names (case-insensitive) are available in
 wipefreespace version 1.5:
- Gutmann (method similar to Gutmann's, the default, 36 passes)
- random (shred-like, 25 passes)
- schneier (Shneier's method, 7 passes, contains ITSG-06)
- dod (DoD, 3 passes, contains NAVSO P-5239-26 and German Federal
   Office for Information Security)