Persistent Memory Development Kit

This is src/test/tools/sparsefile/README.

This directory contains a simple command-line utility for fast sparse file
creation on Windows.  It's used as a helper program by unit tests.
(See 'create_holey_file' in unittest.ps1)

Usage:
	$ sparsefile [options] <path> <length>

where 'options' can be:
	-v - verbose output
	-s - fail if volume/filesystem does not support sparse files
	-f - overwrite file if already exists

Note that using 'sparsefile' is over 50x faster than 'fsutil':
	$ FSUtil File CreateNew <path> <length>
	$ FSUtil Sparse SetFlag <path>
	$ FSUtil Sparse SetRange <path> 0 <length>

Use 'TEST_SPARSE.ps1' script to compare performance of various implementations
of 'create_holey_file' routine.